Jetpack Compose中用Flavor与Source Set搭建多环境

一、解决Source Set依赖文件缺失问题 #

• 无需复制所有依赖文件到flavor目录：Android构建系统会自动合并main目录与flavor目录的内容，仅需将需要差异化的文件复制到对应flavor目录，通用依赖文件留在main即可。比如你只需要修改Composable的文本，就只复制该Composable所在的.kt文件到DEV/PROD的Source Set目录，其他依赖类、资源都留在main里。
• 确保目录结构一致：flavor目录的包名、路径必须和main完全匹配。比如main里的Composable路径是src/main/java/com/yourapp/ui/WelcomeScreen.kt，那么DEV目录里的路径必须是src/dev/java/com/yourapp/ui/WelcomeScreen.kt，包名相同才能让构建系统识别为同一类的覆盖，否则会出现找不到依赖的问题。
• 同步Gradle配置：修改Source Set后，点击Android Studio工具栏的「Sync Project with Gradle Files」按钮，让构建系统更新对Source Set的识别。
• 按需复制差异化依赖：如果某个依赖文件确实需要根据flavor修改（比如不同环境的配置类），再复制该文件到对应flavor目录并修改，否则不要随意复制。

二、Flavor搭建最佳实践（新手向） #

• 控制维度数量：优先只用一个维度（比如你用的「environment」维度），避免多维度组合导致变体数量爆炸（比如再加「paid/free」维度会产生8种变体，大幅增加维护成本）。
• 用BuildConfig和资源文件实现差异化：不要通过复制类文件修改内容，直接在build.gradle的flavor块中配置专属参数，更简洁易维护：

  android {
      flavorDimensions "environment"
      productFlavors {
          dev {
              dimension "environment"
              // 配置BuildConfig字段，代码中可通过BuildConfig.API_URL引用
              buildConfigField "String", "API_URL", "\"https://dev.yourapi.com\""
              // 配置资源值，代码中用stringResource(R.string.welcome_text)引用
              resValue "string", "welcome_text", "欢迎使用开发版"
          }
          prod {
              dimension "environment"
              buildConfigField "String", "API_URL", "\"https://prod.yourapi.com\""
              resValue "string", "welcome_text", "欢迎使用正式版"
          }
      }
  }
  

  对应的Composable直接引用资源即可，无需复制文件：

  @Composable
  fun WelcomeScreen() {
      Text(text = stringResource(R.string.welcome_text))
  }
  

• 仅保留差异化内容：flavor目录只放需要修改的资源、代码或配置，比如特定字符串、AndroidManifest的部分配置、专属类，通用代码和资源全放在main目录，减少冗余和维护工作量。
• 杜绝硬编码：所有环境相关的配置（API地址、功能开关、应用名称）都通过BuildConfig或资源文件管理，不要在代码里硬写，切换环境时只需修改flavor配置即可。
• 测试所有变体：切换Android Studio右下角的「Build Variants」，分别运行每个变体（DEV Debug、DEV Release、PROD Debug、PROD Release），确保每个版本的差异化内容正常显示，功能无异常。
• 遵循目录规范：flavor的Source Set结构必须和main对应，比如src/dev/res/values/对应src/main/res/values/，src/dev/java/对应src/main/java/，确保构建系统能正确合并内容。

内容的提问来源于stack exchange，提问作者SarahAlexa