overseas-android-google-play

海外 Android（Google Play）发布 Skill

适用于 Flutter 应用同时上架国内与海外市场时，海外这条独立分支。所有 <PLACEHOLDER> 替换为项目实际值。

1. 硬约束（不可违反）

• ❌ 海外 flavor 禁止包含 JPush — 海外用户接收不到 JPush，且部分海外市场（特别是 Google Play）合规审核会拦截不必要的中国推送 SDK
• ❌ 海外 flavor 禁止包含 WeChat / Alipay SDK — Google Play 不接受未经合规审查的中国支付 SDK
• ❌ 海外 flavor 禁止指向中国本地 CDN（loli.net 等） — 中国镜像在海外速度慢、可能被海外审计标为"可疑"
• ✅ 海外 flavor 必须包含 Firebase / FCM — Google Play 上架对推送链路的合规默认方案
• ✅ applicationId 必须有 .intl 后缀（或类似），与国内包名隔离，避免商店冲突

2. build.gradle.kts flavor 模板

前提：flutter create 默认生成 Groovy DSL（build.gradle），本节模板是 Kotlin DSL。如果项目还没迁，先 mv build.gradle build.gradle.kts 并按 KTS 语法改写。详见 flutter-multi-region-dev skill 第三节 Step 3 的 DSL 提示。

android {
    flavorDimensions += "market"
    productFlavors {
        create("cn") {
            // 国内 flavor 详见 cn-android-flavor skill
        }
        create("overseas") {
            dimension = "market"
            applicationId = "<APP_PACKAGE>.intl"   // 例：com.acme.myapp.intl
            manifestPlaceholders["MARKET"] = "overseas"
            // Flutter 插件清单仍可能解析这些 placeholder；海外包运行时不初始化 JPush
            manifestPlaceholders["JPUSH_PKGNAME"] = applicationId as Any
            manifestPlaceholders["JPUSH_APPKEY"] = "DISABLED_FOR_OVERSEAS"
            manifestPlaceholders["JPUSH_CHANNEL"] = "overseas"
        }
    }
}

3. 目录隔离

android/app/src/
├── main/                      # 双 flavor 共用源码与 manifest
├── cn/
│   ├── AndroidManifest.xml    # JPush meta-data 等中国相关
│   └── ... (cn 专属 Java/Kotlin)
└── overseas/
    ├── AndroidManifest.xml     # FCM meta-data
    ├── google-services.json    # ★ Firebase 配置文件，仅 overseas 编译时打包
    └── ... (overseas 专属 Java/Kotlin)

4. Firebase / FCM 集成

pubspec.yaml：

dependencies:
  firebase_core: ^3.x.x
  firebase_messaging: ^15.x.x

android/app/build.gradle.kts：

dependencies {
    // 仅 overseas flavor 编译时引入 Firebase；cn flavor 自动排除
    add("overseasImplementation", "com.google.firebase:firebase-bom:33.x.x")
    add("overseasImplementation", "com.google.firebase:firebase-messaging")
}