如何在同一代码库中管理移动应用的内部版与外部版？

核心方案：用*构建变体（Build Variant）*能力替代多分支管理 #

所有主流移动端开发框架都原生支持构建变体能力，你无需维护多套代码分支，只需要在同一套代码库中定义不同的构建目标，不同目标读取对应配置文件，构建出差异化的安装包即可，具体落地步骤如下：

• 首先在开发框架中定义两类构建目标：internal（内部测试版）、public（对外发布版）
  • Android 端在 build.gradle 中配置 productFlavors 即可实现
  • iOS 端直接在 Xcode 中新增独立 Scheme 即可
  • 跨端框架如 Flutter 可以通过 --dart-define 传入构建标识，React Native 可以在构建脚本中指定加载的 .env 配置文件路径
• 所有差异化逻辑通过全局环境变量判断实现，不用硬编码修改业务代码，比如内部版显示LAN跳转按钮的逻辑示例：

  // 不同构建目标会自动注入对应BUILD_TYPE变量值
  if (BUILD_TYPE === 'internal') {
    // 仅内部版渲染该按钮
    renderLANJumpButton()
  }
  

配置文件管理规范 #

• 不同构建目标对应独立配置文件，比如 .env.internal、.env.public，所有差异化配置（功能开关、接口地址、应用包名、应用名等）全部存在对应配置文件中，不要硬编码在业务逻辑里
• 内部版专属的敏感配置（比如测试环境密钥、内网接口地址等）不要提交到公共代码仓库，可以存放在本地或者CI/CD系统的环境变量管理中，构建时自动注入
• 配置文件统一用通用key-value结构，不要和特定业务逻辑耦合，后续如果要新增第三种版本（比如灰度版），只需要新增对应配置文件即可，不需要修改核心代码

差异化资源处理规则 #

• 小的功能差异、UI差异直接用环境变量做条件判断即可，不需要拆分代码文件
• 如果有较大的资源差异（比如内部版用专属图标、启动页），可以放在变体专属的资源目录下，构建时会自动替换对应资源，无需修改业务代码

CI/CD 流程适配 #

• 流水线分别配置内部版、公开版的独立构建任务，构建时自动选择对应变体的配置文件，无需人工切换分支或修改代码
• 内部版构建默认开启调试日志、测试环境接口、埋点调试能力，公开版构建默认关闭这些能力，避免人工配置出错

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