cn-android-flavor

中国大陆 Android（cn flavor）发布 Skill

适用于华为 / 小米 / OPPO / vivo / 应用宝等国内市场。所有 <PLACEHOLDER> 替换为项目实际值。

1. 硬约束（不可违反）

• ❌ cn flavor 禁止包含 Firebase / Google Services / Google Play Services SDK — 华为 HMS 审核直接拒；国内用户无 Google 服务无法使用
• ❌ cn flavor 禁止指向 googleapis.com / gstatic.com 等 Google CDN — 国内被墙，加载失败
• ❌ 禁止采集 IMEI / MEID / IMSI / Settings.Secure.ANDROID_ID / MAC — 工信部专项整治禁项
• ✅ 必须用 JPush（或同类国内推送） — 不用境外 FCM
• ✅ applicationId 与海外包隔离 — 例如 cn = com.acme.myapp、overseas = com.acme.myapp.intl
• ✅ ICP 备案 App 名称必须与 <application android:label> 完全一致

2. build.gradle.kts flavor 模板

前提：flutter create 默认生成 Groovy DSL（build.gradle），本节模板是 Kotlin DSL。如果项目还没迁，先 mv build.gradle build.gradle.kts 并按 KTS 语法改写（apply plugin: "x" → id("x")、def → val）。

android {
    flavorDimensions += "market"
    productFlavors {
        create("cn") {
            dimension = "market"
            applicationId = "<APP_PACKAGE>"   // 例：com.acme.myapp
            manifestPlaceholders["MARKET"] = "cn"
            manifestPlaceholders["JPUSH_PKGNAME"] = applicationId as Any
            manifestPlaceholders["JPUSH_APPKEY"] = jpushAppKey   // 从 key.properties 读
            manifestPlaceholders["JPUSH_CHANNEL"] = jpushChannel  // 例：huawei / xiaomi / oppo / default
        }
        // overseas flavor 见 overseas-android-google-play skill
    }
}

// ⚠️ 不要在这里手动 add("cnImplementation", "cn.jiguang.sdk:jpush:x.y.z")。
// `jpush_flutter` Flutter 插件已经声明了 JPush native 依赖，再手动加会触发
// duplicate class / 版本冲突。版本统一由 pubspec.yaml 锁。
//
// 仅在不使用 jpush_flutter（直接调原生）时，才需要在这里手动 add cnImplementation。

android/key.properties（不进 git，CI 通过环境变量注入）：

storeFile=keystore/release.jks
storePassword=...
keyAlias=...
keyPassword=...
jpushAppKey=<JPUSH_APP_KEY>
jpushChannel=default

build.gradle.kts 顶部读取：

val keystoreProperties = Properties()
val keystoreFile = rootProject.file("key.properties")
if (keystoreFile.exists()) {
    keystoreFile.inputStream().use { keystoreProperties.load(it) }
}
val jpushAppKey = keystoreProperties.getProperty("jpushAppKey")?.takeIf { it.isNotBlank() }
    ?: System.getenv("JPUSH_APP_KEY")
    ?: throw GradleException("cn release build requires jpushAppKey in key.properties or JPUSH_APP_KEY env")
val jpushChannel = keystoreProperties.getProperty("jpushChannel")?.takeIf { it.isNotBlank() }
    ?: System.getenv("JPUSH_CHANNEL")
    ?: "default"