一、构建变体入门：什么是构建变体
各位同学，今天我们来聊聊构建变体。说实话，这个概念刚接触时我也觉得有点绕。但搞懂了它，你的开发效率能翻倍。
构建变体（Build Variant），说白了就是「构建类型」和「产品风味」的组合结果。每个变体对应一个你最终能跑起来的APK。我刚开始带团队时，就有人把debug包发给了测试，结果调试日志满天飞——这就是没搞懂构建变体惹的祸。
核心公式：
构建变体 = 构建类型 × 产品风味
比如：debug × demo = demoDebug 变体
你想想看，一个App可能有免费版、付费版，还要区分测试环境和正式环境。如果手动改代码来切换，那不得累死？构建变体就是帮我们自动化处理这些事的。
二、构建类型（Build Type）
构建类型定义了App在构建时的行为。Android Studio默认给了我们两个：debug 和 release。
2.1 debug 构建类型
debug类型，顾名思义，是给开发调试用的。我个人习惯在debug包上开启所有调试开关，方便定位问题。
- 可调试：
debuggable true，能附加调试器 - 签名：使用默认的debug签名证书
- 混淆：默认关闭混淆（minifyEnabled false）
- 资源压缩：默认关闭
// 默认的debug配置（在build.gradle中）
android {
buildTypes {
debug {
// 这些是默认值，其实不写也行
debuggable true
minifyEnabled false
shrinkResources false
versionNameSuffix "-debug"
}
}
}2.2 release 构建类型
release类型用于发布到应用商店。嗯，这里要注意：release包默认是不能调试的，而且会开启混淆和压缩。
- 不可调试：
debuggable false - 需要签名：必须配置正式的签名证书
- 开启混淆：
minifyEnabled true - 资源压缩：
shrinkResources true
// 默认的release配置
android {
buildTypes {
release {
debuggable false
minifyEnabled true
shrinkResources true
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'),
'proguard-rules.pro'
}
}
}我曾经踩过的坑：
有一次我忘了给release包配置签名，结果打包出来的APK安装不了。Android Studio会提示你签名错误，但如果你用命令行打包，可能直接就生成一个未签名的APK。所以记得在release类型里配置 signingConfig。
三、产品风味（Product Flavor）
产品风味用来区分同一个App的不同版本。比如免费版和付费版，或者国内版和国际版。
我记得第一次用产品风味时，觉得这玩意儿太神奇了——同一个代码库，改个flavor就能生成不同的APK。
3.1 定义产品风味
在 build.gradle 的 productFlavors 块里定义：
android {
// 必须先声明flavorDimensions
flavorDimensions "version", "market"
productFlavors {
demo {
dimension "version"
applicationIdSuffix ".demo"
versionNameSuffix "-demo"
}
full {
dimension "version"
applicationIdSuffix ".full"
}
googlePlay {
dimension "market"
}
huawei {
dimension "market"
}
}
}3.2 产品风味的作用
- 不同的applicationId：可以同时安装多个版本
- 不同的资源：每个flavor可以有自己的res目录
- 不同的代码：通过
src/demo/和src/full/目录区分 - 不同的依赖：可以为特定flavor添加依赖
小技巧：
如果你想让demo版和full版有不同的应用图标，只需在 src/demo/res/ 和 src/full/res/ 下各放一个 ic_launcher.png 即可。构建系统会自动选择对应flavor的资源。
四、构建变体的组合
构建变体就是构建类型和产品风味的笛卡尔积。举个例子：
| 产品风味 \ 构建类型 | debug | release |
|---|---|---|
| demo | demoDebug | demoRelease |
| full | fullDebug | fullRelease |
你可以在Android Studio左下角的「Build Variants」面板里切换当前要运行的变体。我个人习惯在开发时选 demoDebug，发布时选 fullRelease。
五、知识体系总览
下面这张图帮你理清构建变体的整体结构：
六、默认配置的深层理解
Android Studio创建新项目时，会自动生成 debug 和 release 两个构建类型。但它们的默认配置其实藏在Android Gradle插件里，你可以在 build.gradle 中覆盖它们。
关键点：
- debug类型的
applicationId可以加后缀，方便同时安装debug和release版 - release类型必须配置
signingConfig，否则打包会报错 - 如果你不定义任何产品风味，构建变体就只有
debug和release两个
为什么会这样设计？说白了，Google希望我们养成「开发用debug，发布用release」的好习惯。我见过一些团队直接用release包调试，结果混淆后的堆栈信息根本看不懂——这不是给自己找麻烦吗？
我的建议：
在debug类型里加上 versionNameSuffix "-debug"，这样安装后从应用名称就能一眼看出是debug版。测试人员再也不会搞混包了。
好了，构建变体的基础概念就讲到这里。记住那个公式：构建变体 = 构建类型 × 产品风味。下一节我们会深入实战，看看怎么在代码里根据不同的变体执行不同的逻辑。