Android Build Variants（构建变体）是 Android 开发中用于生成不同版本应用程序的一种机制。它允许开发者根据不同的需求，如不同的应用市场、不同的功能模块、不同的环境配置等，从同一个代码库中生成多个不同的 APK。
组成部分
- Build Types： 构建类型主要用于区分不同的构建环境，如开发环境、测试环境和生产环境等。常见的构建类型有 debug 和 release。
- debug： 主要用于开发过程中，它通常包含更多的调试信息，并且不进行代码混淆和压缩等优化操作，方便开发者进行调试。
- release： 用于发布到应用商店供用户下载安装的版本，会进行代码混淆、压缩等优化操作，以减小 APK 体积和提高应用的安全性和性能。
- Product Flavors： 产品风味可以用来区分不同的应用变体，比如针对不同的应用市场、不同的客户群体或不同的功能特性等。例如，一个应用可能有免费版和付费版两种产品风味，它们在功能上有所不同；或者针对不同的应用商店（如 Google Play 和华为应用市场）有不同的产品风味，可能会在一些配置或资源上有所差异。
作用
-
定制化应用版本： 通过不同的 Build Variants 组合，可以轻松地为不同的场景和需求生成定制化的应用版本。例如，为某个特定客户定制具有特殊功能的应用版本，或者为不同的应用市场生成包含不同渠道信息的版本。
-
优化应用性能和大小： 对于不同的构建变体，可以根据其特点进行针对性的优化。比如，在 release 版本中进行代码混淆和资源压缩，去除不必要的代码和资源，以减小 APK 的大小，提高应用的加载速度和运行性能。
-
方便开发和测试： 在开发过程中，使用 debug 构建类型可以方便地进行调试，快速定位和解决问题。同时，通过不同的 Product Flavors 可以模拟不同的应用场景和用户需求，便于进行全面的测试。
使用示例
在 Android Studio 中配置 Build Variants 主要涉及在 build.gradle 文件里定义构建类型（Build Types）和产品风味（Product Flavors），以下为你详细介绍配置步骤：
1. 定义构建类型
构建类型通常用于区分不同的构建环境，像开发环境和发布环境等。默认情况下，Android 项目有 debug 和 release 两种构建类型。你也能自定义新的构建类型。
在项目的 app/build.gradle 文件里添加或修改 buildTypes 部分，示例如下：
android {
buildTypes {
// 调试版本配置
debug {
// 可调试
debuggable true
// 开启 JNI 调试
jniDebugBuild true
}
// 发布版本配置
release {
// 开启代码混淆
minifyEnabled true
// 指定混淆规则文件
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
}
// 自定义构建类型
staging {
initWith debug
// 应用 ID 后缀
applicationIdSuffix ".staging"
// 版本名后缀
versionNameSuffix "-staging"
}
}
}
2. 定义产品风味
产品风味可用来区分不同的应用变体，例如免费版和付费版，或者针对不同应用商店的版本。
在 app/build.gradle 文件中添加 productFlavors 部分，示例如下：
android {
productFlavors {
// 免费版风味
free {
// 应用 ID
applicationId "com.example.app.free"
// 资源字符串值
resValue "string", "app_name", "Free App"
}
// 付费版风味
paid {
applicationId "com.example.app.paid"
resValue "string", "app_name", "Paid App"
}
}
}
3. 组合构建变体
构建类型和产品风味会组合形成不同的构建变体。例如，在上述配置中，会产生 freeDebug、freeRelease、freeStaging、paidDebug、paidRelease 和 paidStaging 这些构建变体。
4. 选择构建变体
在 Android Studio 里，你可以通过以下方式选择要使用的构建变体：
- 打开 Android Studio 底部的 Build Variants 面板。
- 在 Build Variants 面板中，为每个模块选择所需的构建变体。
完整配置示例
下面是一个完整的 app/build.gradle 文件示例，其中包含了构建类型和产品风味的配置：
apply plugin: 'com.android.application'
android {
compileSdkVersion 33
buildToolsVersion "33.0.0"
defaultConfig {
applicationId "com.example.app"
minSdkVersion 21
targetSdkVersion 33
versionCode 1
versionName "1.0"
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
}
buildTypes {
debug {
debuggable true
jniDebugBuild true
}
release {
minifyEnabled true
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
}
staging {
initWith debug
applicationIdSuffix ".staging"
versionNameSuffix "-staging"
}
}
productFlavors {
free {
applicationId "com.example.app.free"
resValue "string", "app_name", "Free App"
}
paid {
applicationId "com.example.app.paid"
resValue "string", "app_name", "Paid App"
}
}
}
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation 'androidx.appcompat:appcompat:1.4.1'
implementation 'androidx.constraintlayout:constraintlayout:2.1.3'
testImplementation 'junit:junit:4.13.2'
androidTestImplementation 'androidx.test.ext:junit:1.1.3'
androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
}
按照上述步骤操作，你就能在 Android Studio 中完成 Build Variants 的配置，进而生成不同的应用版本。
不同的构建变体资源加载
在 Android 应用中，可根据不同的构建变体加载不同资源，以下是具体实现方式：
1. 为不同构建变体创建资源目录
在 src 目录下，为每种构建变体（产品风味和构建类型的组合）创建对应的资源目录。目录命名遵循 src/<flavorName><buildTypeName> 的格式。
例如，若你有 free 和 paid 两种产品风味，以及 debug 和 release 两种构建类型，可创建如下目录结构：
app/
├── src/
│ ├── freeDebug/
│ │ └── res/
│ │ ├── drawable/
│ │ ├── layout/
│ │ └── values/
│ ├── freeRelease/
│ │ └── res/
│ ├── paidDebug/
│ │ └── res/
│ └── paidRelease/
│ └── res/
│ ├── main/
│ │ └── res/
- main 目录中的资源是所有构建变体共享的。
- 特定构建变体目录中的资源会覆盖 main 目录中同名的资源。
2. 在不同资源目录中放置不同资源
在上述创建的目录中，为不同构建变体放置不同的资源。例如，在 freeDebug/res/values/strings.xml 中可以定义免费调试版的字符串资源：
<resources>
<string name="app_name">Free App (Debug)</string>
</resources>
而在 paidRelease/res/values/strings.xml 中定义付费发布版的字符串资源：
<resources>
<string name="app_name">Paid App (Release)</string>
</resources>
3. 在代码中加载资源
在代码里加载资源时，Android 系统会自动根据当前的构建变体选择合适的资源。例如，在 Activity 中获取应用名称：
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
// 获取应用名称
val appName = getString(R.string.app_name)
// 打印应用名称
println("App Name: $appName")
}
}
4. 注意事项
- 资源优先级：资源加载时，特定构建变体的资源优先级最高，然后是产品风味的资源，最后是 main 目录中的资源。例如，freeDebug 目录中的资源优先级高于 free 目录中的资源，而 free 目录中的资源优先级高于 main 目录中的资源。
- 资源命名：确保不同构建变体的资源命名一致，这样才能正确覆盖。
通过以上步骤，你就能在 Android 应用中依据不同的构建变体加载不同的资源。
不同的构建变体代码逻辑区分
Android 应用里，你可以依据不同的构建变体加载不同的代码逻辑。以下是几种常见的实现方式：
1. 使用条件编译
借助 Gradle 的构建配置，在代码里通过条件判断来依据不同的构建变体执行不同逻辑。
步骤
在 build.gradle 文件中定义构建类型或产品风味的标志：
android {
buildTypes {
debug {
buildConfigField "boolean", "IS_DEBUG", "true"
}
release {
buildConfigField "boolean", "IS_DEBUG", "false"
}
}
productFlavors {
free {
buildConfigField "boolean", "IS_FREE_VERSION", "true"
}
paid {
buildConfigField "boolean", "IS_FREE_VERSION", "false"
}
}
}
上述代码中，在 debug 和 release 构建类型里定义了 IS_DEBUG 标志，在 free 和 paid 产品风味中定义了 IS_FREE_VERSION 标志。
在代码中使用这些标志进行条件判断
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
if (BuildConfig.IS_DEBUG) {
// 调试版本的代码逻辑
println("Debug version logic")
} else {
// 发布版本的代码逻辑
println("Release version logic")
}
if (BuildConfig.IS_FREE_VERSION) {
// 免费版的代码逻辑
println("Free version logic")
} else {
// 付费版的代码逻辑
println("Paid version logic")
}
}
}
2. 为不同构建变体创建不同的类文件
可以为不同的构建变体创建对应的类文件，让 Android 系统在运行时根据当前构建变体自动加载合适的类。
步骤
- 创建不同构建变体的目录结构：
app/
├── src/
│ ├── free/
│ │ └── java/
│ │ └── com/
│ │ └── example/
│ │ └── app/
│ │ └── Feature.java
│ ├── paid/
│ │ └── java/
│ │ └── com/
│ │ └── example/
│ │ └── app/
│ │ └── Feature.java
│ └── main/
│ └── java/
│ └── com/
│ └── example/
│ └── app/
│ └── MainActivity.java
- 在不同的 Feature.java 文件中实现不同的逻辑：
free/java/com/example/app/Feature.kt：
package com.example.app
class Feature {
fun doSomething() {
println("Free version feature")
}
}
paid/java/com/example/app/Feature.kt：
package com.example.app
class Feature {
fun doSomething() {
println("Paid version feature")
}
}
在 MainActivity 中使用 Feature 类：
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
val feature = Feature()
feature.doSomething()
}
}
通过以上两种方法，你就能在 Android 应用中依据不同的构建变体加载不同的代码逻辑。
总结
Android 构建变体（Build Variants）是强大且灵活的机制，由构建类型（如 debug、release）和产品风味（如免费版、付费版）组合而成。借助它，开发者能从同一代码库生成多个定制化的 APK 版本。在配置方面，可在 build.gradle 文件中定义构建类型和产品风味，同时能设置不同的属性和资源。通过构建变体，不仅能针对不同应用市场、客户群体、功能特性等定制应用，还能优化应用性能和大小，方便开发和测试。在实际应用里，能依据不同的构建变体加载不同资源和代码逻辑，甚至结合设备类型等其他条件，进一步实现复杂的定制化需求。
