Compose Multiplatform多风味资源覆盖失效及最优配置咨询

一、问题根源分析 #

Compose Multiplatform的composeResources资源加载逻辑遵循Kotlin Multiplatform（KMP）的源集优先级规则：默认情况下，commonMain的资源优先级高于其他自定义源集，即便手动添加了额外的资源目录，也会因为源集依赖顺序问题导致白标资源无法覆盖通用资源。

二、可行解决方案 #

方案1：基于KMP源集的变体配置（推荐） #

完全适配AGP 9的无flavor模式，用KMP源集实现白标隔离，明确资源加载优先级：

1. 调整目录结构
   为每个白标创建独立源集，确保资源目录与commonMain结构对齐：

   src/
     commonMain/
       kotlin/
       composeResources/
         values/strings.xml  # 通用基础资源
     flavorAMain/
       kotlin/
       composeResources/
         values/strings.xml  # FlavorA专属资源（将覆盖通用资源）
     flavorBMain/
       kotlin/
       composeResources/
         values/strings.xml  # FlavorB专属资源（将覆盖通用资源）
     # 其余6个白标源集以此类推
     androidMain/
     iosMain/
   

2. Gradle模块配置
   通过Gradle参数动态激活目标白标，调整源集依赖顺序：

   // 获取激活的白标参数，默认用flavorA
   val activeFlavor = providers.gradleProperty("activeFlavor").getOrElse("flavorA")
   
   kotlin {
       sourceSets {
           val commonMain by getting {
               // 让白标源集依赖commonMain，确保白标资源优先级更高
               dependencies {
                   implementation(sourceSets.named("${activeFlavor}Main").get())
               }
           }
   
           // 声明所有白标源集
           listOf("flavorA", "flavorB", "flavorC", "flavorD", "flavorE", "flavorF", "flavorG", "flavorH").forEach { flavor ->
               create("${flavor}Main") {
                   dependsOn(commonMain)
                   resources.srcDir("src/${flavor}Main/composeResources")
                   kotlin.srcDir("src/${flavor}Main/kotlin")
               }
           }
       }
   }
   
   // Android端同步白标源集配置
   android {
       sourceSets.named("main") {
           java.srcDir("src/${activeFlavor}Main/kotlin")
           res.srcDir("src/${activeFlavor}Main/composeResources")
       }
   }
   

3. 编译命令示例
   指定目标白标构建：

   ./gradlew assembleDebug -PactiveFlavor=flavorC
   

方案2：Compose资源变体策略 #

利用Compose Multiplatform的resourceVariants配置，直接指定资源优先级：

kotlin {
    sourceSets {
        commonMain {
            composeResources {
                resourceVariants {
                    create(activeFlavor) {
                        srcDir("src/${activeFlavor}Main/composeResources")
                        priority = 100 // 数值高于commonMain默认的0，确保白标资源优先加载
                    }
                }
            }
        }
    }
}

三、多平台白标配置最优方案 #

1. 模块化拆分（长期最优） #

将代码按职责拆分，彻底隔离白标逻辑：

• core模块：存放通用业务逻辑、基础UI组件、通用资源
• 白标专属模块：每个白标对应一个模块，仅包含品牌化资源（字符串、颜色）、专属业务代码
• app壳模块：根据激活的白标，依赖对应的白标模块和core模块

优势：

• 完全避免资源冲突，白标间代码隔离清晰
• 编译速度更快，仅构建当前激活的白标模块
• 便于单独迭代某个白标的需求

2. 源集变体方案（快速迁移） #

如果暂时不想拆分模块，方案1的源集配置是最优过渡方案，能最大程度复用现有目录结构，同时解决资源覆盖问题。

3. 避坑指南 #

• 禁止混合AGP风味与KMP源集：AGP 9移除flavors后，两者资源加载逻辑完全不兼容，会导致优先级混乱
• 确保composeResources目录结构与Android标准一致（如values/strings.xml），否则Compose无法识别资源类型
• 编译后务必验证每个白标的资源加载情况，避免通用资源未被覆盖

内容的提问来源于stack exchange，提问作者Kevin van Mierlo