鸿蒙开发中 区分不同环境的配置

在开发中，区分不同环境（如开发、测试、生产）的配置，核心难点在于构建产物与配置的分离。针对debug和release以及可能的更多环境，梳理了4种主流方案，从轻量级到企业级，利弊根据团队规模选择。

方案一：基于 Build Profile 的字段注入（最推荐，原生支持）

这是鸿蒙官方推荐的方案，利用build-profile.json5中的buildOption和arkOptions，配合process.env在编译时注入变量。

• 做法：在build-profile.json5的targets中定义debug和release，并在buildOption中配置buildProfileFields注入全局常量。

• 优点：原生支持，无需第三方库；编译时确定，运行时无性能损耗；可以精确控制每个target的配置。

• 缺点：配置写法略繁琐；如果环境超过3个（如dev/sit/uat/prod），targets会变得臃肿。

• 适用场景：绝大多数项目，尤其是只有 dev 和 prod 两套环境时。

方案二：多 Bundle Name / 多 Module 方案（物理隔离）

为不同环境创建独立的Module或使用不同的bundleName（包名），每个模块持有自己的constants文件。

• 做法：创建common-debug和common-release两个 hap 模块，或者利用HAP的target能力，替换ets目录下的配置文件。

• 优点：绝对的物理隔离，即使写错代码也不会混淆；适合大型多人协作项目。

• 缺点：维护成本高，公共代码修改时需要同步多个模块；切换环境需要重新安装应用（因为包名不同）。

• 适用场景：系统级应用或有严格安全审计要求的项目。

方案三：运行时动态读取本地配置文件（JSON/Properties）

将不同环境的 Host 写在rawfile目录下的多个 JSON 文件中（如config.dev.json），通过代码逻辑判断当前是 Debug 还是 Release 模式来读取对应文件。

• 做法：通过@ohos.bundle.bundleManager获取应用的bundleInfo，判断debug字段；或者通过AppStorage在启动时设置一个全局环境变量。

• 优点：配置修改灵活，甚至可以热更新配置（如果从远端拉取）；代码逻辑直观。

• 缺点：配置文件会打包进应用，如果反编译，所有环境的 Host 都会暴露（安全风险）；需要额外的文件读取 I/O 操作。

• 适用场景：内部测试包或对 IP 泄露不敏感的 Demo 项目。

方案四：基于 AGP/Hvigor 构建脚本生成配置文件（最自动化）

利用鸿蒙的构建工具 Hvigor，在hvigorfile.ts中编写自定义 Task。在编译打包前，根据当前的product或target，动态生成一个Config.ets文件写入到entry/src/main/ets/目录下。

• 做法：构建时读取环境变量（如npm run build:dev），脚本往源码目录写入export const BASE_URL = "https://dev.api.com"。

• 优点：零运行时开销，配置被直接编译进字节码；且构建产物中只有当前环境的 Host。

• 缺点：对团队成员要求较高（需理解 Hvigor 脚本）；如果误操作，容易把开发环境的配置覆盖到正式版。

• 适用场景：成熟的 CI/CD 流水线项目。

建议

1. 小团队/快速迭代：选方案一（Build Profile），官方、稳定、够用。

2. 需要 CI/CD 自动打包不同环境：选方案四（Hvigor 脚本生成），最干净。

3. 安全第一（防逆向）：方案四或方案二，千万别用方案三（存明文）。