原生移动开发 / 系统课时
构建类型与产品变体
构建类型与产品变体
同一套 Android 代码常常要同时产出可调试包、正式包,以及测试环境、生产环境等不同版本。本课用一个最小 Gradle 配置把 buildTypes、productFlavors、Variant 与 BuildConfig 串起来,并实际构建两个变体验证结果。
学习目标
- 区分 Build Type、Product Flavor 与最终 Build Variant 的职责
- 配置
debug、release和两个 Flavor,理解它们如何组合 - 使用
BuildConfig为不同变体注入编译期常量并完成构建验证
先分清三层关系
buildTypes 描述“怎么构建”,典型值是 debug 与 release;productFlavors 描述“构建哪个产品版本”,例如测试环境和生产环境。Gradle 会从每个 Flavor Dimension 中选一个 Flavor,再与一个 Build Type 组合成 Variant。
只有一个 Flavor Dimension 时,两个 Flavor 与两个 Build Type 会形成四个常见变体:demoDebug、demoRelease、prodDebug、prodRelease。如果没有配置 Flavor,则只有 debug、release 两个变体。

配置一个最小变体矩阵
下面是 app/build.gradle.kts 中 android {} 的片段示例。为了使用自定义 BuildConfig 字段,显式开启 buildConfig 生成。
android {
namespace = "com.example.variants"
compileSdk = 36
defaultConfig {
applicationId = "com.example.variants"
minSdk = 24
targetSdk = 36
versionCode = 1
versionName = "1.0"
}
buildFeatures {
buildConfig = true
}
flavorDimensions += "env"
productFlavors {
create("demo") {
dimension = "env"
applicationIdSuffix = ".demo"
buildConfigField(
"String",
"API_BASE_URL",
"\"https://demo.example.com/\""
)
}
create("prod") {
dimension = "env"
buildConfigField(
"String",
"API_BASE_URL",
"\"https://api.example.com/\""
)
}
}
buildTypes {
debug {
applicationIdSuffix = ".debug"
versionNameSuffix = "-debug"
buildConfigField("boolean", "LOG_VERBOSE", "true")
}
release {
isMinifyEnabled = false
buildConfigField("boolean", "LOG_VERBOSE", "false")
}
}
}这段配置会把环境差异放进 Flavor,把调试策略放进 Build Type。以 demoDebug 为例,最终应用标识会在基础 applicationId 后叠加 .demo 与 .debug;prodRelease 则保持生产应用标识不加后缀。
在代码中读取 BuildConfig
BuildConfig 是按 Variant 生成的类。下面是应用代码中的片段示例,它依赖上面的 Gradle 配置。
val apiBaseUrl = BuildConfig.API_BASE_URL
val verboseLogging = BuildConfig.LOG_VERBOSE编译 demoDebug 时,API_BASE_URL 对应测试地址且 LOG_VERBOSE 为 true;编译 prodRelease 时,则切换到生产地址并关闭详细日志。因为这些值在编译期确定,不能把需要运行时动态切换的用户配置放进 BuildConfig。
构建并验证两个变体
在项目根目录执行两个明确的 Variant 任务:
./gradlew :app:assembleDemoDebug :app:assembleProdRelease预期输出
> Task :app:assembleDemoDebug
> Task :app:assembleProdRelease
BUILD SUCCESSFULGradle 可能额外输出缓存、增量构建或耗时信息,但关键是两个任务完成且最终出现 BUILD SUCCESSFUL。对应 APK 通常位于 app/build/outputs/apk/demo/debug/ 与 app/build/outputs/apk/prod/release/。
如果任务名不存在,先检查 Flavor 是否设置了正确的 dimension,以及 flavorDimensions 是否包含该维度。若新增 buildConfigField 后报 BuildConfig 相关错误,则确认 buildFeatures { buildConfig = true } 已生效。生产项目还应把签名、代码压缩等 release 专属配置放在 release 中,而不是复制到每个 Flavor。