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 {// 應用 IDapplicationId "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 33buildToolsVersion "33.0.0"defaultConfig {applicationId "com.example.app"minSdkVersion 21targetSdkVersion 33versionCode 1versionName "1.0"testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"}buildTypes {debug {debuggable truejniDebugBuild true}release {minifyEnabled trueproguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'}staging {initWith debugapplicationIdSuffix ".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.AppCompatActivityclass 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.AppCompatActivityclass 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.appclass Feature {fun doSomething() {println("Free version feature")}
}

paid/java/com/example/app/Feature.kt：

package com.example.appclass Feature {fun doSomething() {println("Paid version feature")}
}

在 MainActivity 中使用 Feature 類：

import android.os.Bundle
import androidx.appcompat.app.AppCompatActivityclass 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 文件中定義構建類型和產品風味，同時能設置不同的屬性和資源。通過構建變體，不僅能針對不同應用市場、客戶群體、功能特性等定制應用，還能優化應用性能和大小，方便開發和測試。在實際應用里，能依據不同的構建變體加載不同資源和代碼邏輯，甚至結合設備類型等其他條件，進一步實現復雜的定制化需求。