Android 马甲包工程实践：从矩阵战略到可复制的 App Shell

核心 SDK / 业务模块（共享）
        ↓
   配置与风味层（Flavor / BuildConfig）
        ↓
   品牌壳层（资源、文案、商店素材）
        ↓
   独立安装包（applicationId + 签名 + 商店 listing）

:app                    // 风味入口，依赖下方模块
:feature-home           // 可复用首页
:feature-profile
:lib-user-api
:lib-network
:lib-analytics
:lib-ad-api             // 广告接口，具体 SDK 按风味打入

// app/build.gradle.kts
android {
    namespace = "com.example.core"
 
    flavorDimensions += "brand"
 
    productFlavors {
        create("main") {
            dimension = "brand"
            applicationId = "com.example.app.main"
            manifestPlaceholders["appName"] = "主品牌"
            buildConfigField("String", "CHANNEL", "\"main\"")
            buildConfigField("String", "PRIVACY_URL", "\"https://example.com/privacy/main\"")
        }
        create("lite") {
            dimension = "brand"
            applicationId = "com.example.app.lite"
            manifestPlaceholders["appName"] = "轻量版"
            buildConfigField("String", "CHANNEL", "\"lite\"")
            buildConfigField("String", "PRIVACY_URL", "\"https://example.com/privacy/lite\"")
        }
    }
}

<!-- AndroidManifest.xml -->
<application
    android:label="${appName}"
    ... />

productFlavors {
    create("domestic") {
        // ...
    }
    create("overseas") {
        // ...
    }
}
 
dependencies {
    implementation(project(":lib-ad-api"))
    "domesticRuntimeOnly"(project(":lib-ad-pangle"))
    "overseasRuntimeOnly"(project(":lib-ad-admob"))
}

signingConfigs {
    create("mainRelease") { /* keystore */ }
    create("liteRelease") { /* 另一套 keystore */ }
}
 
productFlavors {
    create("main") {
        signingConfig = signingConfigs.getByName("mainRelease")
    }
    create("lite") {
        signingConfig = signingConfigs.getByName("liteRelease")
    }
}

{
  "brandId": "lite",
  "tabs": ["home", "discover", "mine"],
  "features": {
    "vip": false,
    "community": true
  },
  "urls": {
    "privacy": "https://example.com/privacy/lite",
    "terms": "https://example.com/terms/lite"
  }
}

interface FeatureRegistry {
    fun isEnabled(feature: Feature): Boolean
}
 
enum class Feature { VIP, COMMUNITY, AD_SPLASH }
 
// 壳层实现，数据来自 config.json + Remote Config
class BrandFeatureRegistry(
    private val local: LocalBrandConfig,
    private val remote: RemoteConfigRepository,
) : FeatureRegistry {
    override fun isEnabled(feature: Feature): Boolean =
        remote.featureOverride(feature) ?: local.features[feature] ?: false
}

fun buildBottomNav(config: LocalBrandConfig): List<NavItem> =
    config.tabs.mapNotNull { tabId ->
        when (tabId) {
            "home" -> NavItem.Home
            "discover" -> if (features.isEnabled(Feature.COMMUNITY)) NavItem.Discover else null
            "mine" -> NavItem.Mine
            else -> null
        }
    }

app/
  src/main/google-services.json          # 勿放默认错误文件
  src/main/google-services.json.bak        # 可选：文档说明
  src/main/...
  src/lite/google-services.json
  src/main/...

./gradlew :app:assembleLiteRelease :app:assembleMainRelease
./gradlew :app:bundleLiteRelease   # AAB 上架 Google Play

data class BrandTheme(
    val primary: Color,
    val logoUrl: String,
    val appName: String,
)
 
@HiltViewModel
class HomeViewModel @Inject constructor(
    private val repo: HomeRepository,
    val brandTheme: BrandTheme,  // 壳层绑定实例
) : ViewModel() {
    // 业务逻辑与 main / lite 无关
}