在 HarmonyOS Next 的开发中，有时候你需要动态修改编译配置，例如根据不同构建模式（如 debug 或 release）来控制编译选项、打包内容、模块依赖等。这一篇「DevEco Studio 使用指南（四十二）」将带你了解如何在 DevEco Studio 中动态修改编译配置。

📌 一、适用场景

  • 同一个模块需要支持多个产品形态（如国内版/海外版）
  • 控制打包内容（是否包含日志、测试接口、调试工具等）
  • 自动设置不同的应用 ID、版本号、资源等

📦 二、构建模式概览

HarmonyOS 使用 HAP 模块进行构建，支持通过 build-profile.json5 或 build.gradle 等方式进行配置。

HarmonyOS Next 使用的是 DevEco Studio 3.x+，推荐使用 build.gradle 的 DSL 方式进行动态配置。

⚙️ 三、动态编译配置的方式

方式一：在 build.gradle 中使用条件语句

可以根据 buildType 或 productFlavor 动态设置配置项：

ohos {
    compileSdkVersion 10
    defaultConfig {
        compatibleSdkVersion 10
    }

    buildTypes {
        debug {
            signingConfig signingConfigs.debug
            buildConfigField "boolean", "ENABLE_LOG", "true"
        }
        release {
            signingConfig signingConfigs.release
            buildConfigField "boolean", "ENABLE_LOG", "false"
        }
    }
}

这样你就可以在代码中使用：

if (BuildConfig.ENABLE_LOG) {
    Log.info("调试日志开启");
}

方式二：多产品渠道支持（productFlavors）

flavorDimensions "channel"
productFlavors {
    domestic {
        dimension "channel"
        buildConfigField "String", "SERVER_URL", "\"https://api.domestic.example.com\""
    }
    overseas {
        dimension "channel"
        buildConfigField "String", "SERVER_URL", "\"https://api.overseas.example.com\""
    }
}

代码中使用：

String url = BuildConfig.SERVER_URL;

方式三：Gradle Task 中动态注入参数

task injectTime {
    doLast {
        def buildTime = new Date().format("yyyy-MM-dd HH:mm:ss")
        android.defaultConfig.buildConfigField "String", "BUILD_TIME", "\"${buildTime}\""
    }
}
preBuild.dependsOn injectTime

🧰 四、实用建议

  • 变量命名规范：buildConfigField 的名称建议全大写，用下划线分隔。
  • 避免泄漏密钥：不要在 build.gradle 中写死私密信息，可以读取环境变量或 local.properties。
  • 混淆规则注意：Release 构建记得开启代码混淆。

🧪 五、验证方法

  1. 编译时在 BuildConfig.java 里查看是否成功注入字段；
  2. 在 DevEco Studio 的 Build Variants 选择不同构建模式；
  3. 打包后验证应用行为差异（如日志是否输出）。

✅ 总结

方式优势场景
buildType简单、快速debug/release 差异
productFlavor多产品或渠道构建国内/海外版、白名单/公测版等
自定义 Task灵活、可动态注入构建时间、git 版本号等信息

如果你正在开发面向多个版本或渠道的应用，学会动态修改编译配置将极大提升你的构建效率与代码维护能力。

如需下一篇，请继续关注：【HarmonyOS Next之旅】DevEco Studio使用指南(四十三) -＞ 自定义 Gradle 插件实践

是否需要我提供一个完整的示例项目或自动化脚本？