原生移动开发 / 系统课时

构建类型与产品变体

构建类型与产品变体

同一套 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 两个变体。

Build Type 与 Product Flavor 组合成 Variant

配置一个最小变体矩阵

下面是 app/build.gradle.kts 中 android {} 的片段示例。为了使用自定义 BuildConfig 字段,显式开启 buildConfig 生成。

kotlin
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 配置。

kotlin
val apiBaseUrl = BuildConfig.API_BASE_URL
val verboseLogging = BuildConfig.LOG_VERBOSE

编译 demoDebug 时,API_BASE_URL 对应测试地址且 LOG_VERBOSE 为 true;编译 prodRelease 时,则切换到生产地址并关闭详细日志。因为这些值在编译期确定,不能把需要运行时动态切换的用户配置放进 BuildConfig。

构建并验证两个变体

在项目根目录执行两个明确的 Variant 任务:

bash
./gradlew :app:assembleDemoDebug :app:assembleProdRelease

预期输出

text
> Task :app:assembleDemoDebug
> Task :app:assembleProdRelease
BUILD SUCCESSFUL

Gradle 可能额外输出缓存、增量构建或耗时信息,但关键是两个任务完成且最终出现 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。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

构建类型与产品变体

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通