构建变体实战：在 Android Studio 中切换构建变体、为不同变体配置不同的应用名和图标、使用 BuildConfig 区分变体

构建变体（Build Variant）这个概念，说白了就是「同一份代码，打出不同版本的包」。我在刚接触 Android 开发时，总觉得这玩意儿是给大公司用的，小项目没必要。直到有一次，我同时维护着免费版、付费版、国内版、海外版……嗯，代码里全是 if-else 和不同分支，那叫一个痛苦。

后来我才明白，构建变体就是用来解决这个问题的。它让你用一套代码，通过 Gradle 配置，生成多个不同配置的 APK。今天我们就来实战一把，看看怎么在 Android Studio 里玩转它。

1. 构建变体的核心：Build Type + Product Flavor

构建变体 = Build Type（构建类型）× Product Flavor（产品风味）。

• Build Type：debug 和 release，这个大家很熟了。debug 用于开发调试，release 用于发布。
• Product Flavor：这是区分不同版本的关键。比如 free（免费版）和 paid（付费版），或者 china（国内版）和 global（海外版）。

举个例子，如果你定义了 free 和 paid 两个 flavor，再加上 debug 和 release 两个 build type，那么你就会有 4 个构建变体：

Product Flavor	Build Type	构建变体名称
free	debug	freeDebug
free	release	freeRelease
paid	debug	paidDebug
paid	release	paidRelease

我个人习惯把 flavor 理解为「产品的不同变种」，而 build type 是「同一个变种的不同构建阶段」。这样想，思路就清晰多了。

2. 配置 Product Flavor：为不同变体设置不同的应用名和图标

这是构建变体最常用的场景之一。比如你的免费版叫「我的应用 Lite」，付费版叫「我的应用 Pro」，图标也要不一样。怎么做？

2.1 在 build.gradle 中定义 flavor

android {
    ...
    flavorDimensions "version"
    productFlavors {
        free {
            dimension "version"
            applicationIdSuffix ".free"
            versionNameSuffix "-free"
        }
        paid {
            dimension "version"
            applicationIdSuffix ".paid"
            versionNameSuffix "-paid"
        }
    }
}

这里我用了 flavorDimensions，这是 Android Gradle 插件 3.0 之后引入的。如果你只有一个维度，可以简单理解成「分类」。每个 flavor 都可以有自己的 applicationIdSuffix，这样免费版和付费版就能同时安装在同一台手机上——因为它们包名不同。

2.2 创建 flavor 专属的资源目录

接下来，你需要为每个 flavor 创建对应的资源文件夹。结构是这样的：

app/
├── src/
│   ├── main/                    # 公共代码和资源
│   │   ├── res/
│   │   └── java/
│   ├── free/                    # free flavor 专属
│   │   ├── res/
│   │   │   ├── values/
│   │   │   │   └── strings.xml  # 这里定义 app_name
│   │   │   └── mipmap-hdpi/     # 这里放免费版图标
│   │   └── java/
│   └── paid/                    # paid flavor 专属
│       ├── res/
│       │   ├── values/
│       │   │   └── strings.xml
│       │   └── mipmap-hdpi/
│       └── java/

在 free/res/values/strings.xml 里：

<resources>
    <string name="app_name">我的应用 Lite</string>
</resources>

在 paid/res/values/strings.xml 里：

<resources>
    <string name="app_name">我的应用 Pro</string>
</resources>

图标也一样，把对应的 ic_launcher.png 放到各自的 mipmap 目录下。Gradle 在构建时，会优先使用 flavor 目录下的资源，覆盖 main 目录下的同名资源。

3. 使用 BuildConfig 区分变体

有时候，你需要在代码里判断当前是哪个 flavor。比如免费版里显示广告，付费版里隐藏广告。用 BuildConfig 是最优雅的方式。

3.1 在 build.gradle 中定义 BuildConfig 字段

productFlavors {
    free {
        ...
        buildConfigField "boolean", "IS_FREE_VERSION", "true"
        buildConfigField "String", "API_BASE_URL", "\"https://api.free.example.com\""
    }
    paid {
        ...
        buildConfigField "boolean", "IS_FREE_VERSION", "false"
        buildConfigField "String", "API_BASE_URL", "\"https://api.paid.example.com\""
    }
}

这里我定义了两个字段：IS_FREE_VERSION 和 API_BASE_URL。注意字符串值要用转义的双引号包起来。

3.2 在代码中使用 BuildConfig

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        if (BuildConfig.IS_FREE_VERSION) {
            // 显示广告
            showAd();
        } else {
            // 付费版，不显示广告
            hideAd();
        }

        // 使用不同的 API 地址
        String baseUrl = BuildConfig.API_BASE_URL;
        // 初始化 Retrofit 等...
    }
}

你看，代码里没有任何硬编码的判断，所有差异都集中在 build.gradle 里管理。这样维护起来特别方便。我个人的习惯是，把所有 flavor 相关的配置都写在 build.gradle 的 productFlavors 块里，包括 API 地址、功能开关、日志级别等。

4. 在 Android Studio 中切换构建变体

配置好了，怎么切换呢？很简单。

1. 在 Android Studio 底部，找到 Build Variants 面板（一般在左下角，或者通过 View → Tool Windows → Build Variants 打开）。
2. 你会看到所有构建变体的列表，比如 freeDebug、freeRelease、paidDebug、paidRelease。
3. 点击下拉菜单，选择你想要的变体。比如选 freeDebug，然后点击 Run，Android Studio 就会用免费版的配置来编译和运行。

切换后，你会发现代码里的 BuildConfig 值自动变了，资源文件也变成了对应 flavor 的版本。这就是构建变体的魔力——你不需要手动改任何代码，一切由 Gradle 自动处理。

5. 本章知识体系图

下面这张图帮你梳理了构建变体的核心逻辑：

从这张图可以看得很清楚：构建变体不是凭空产生的，它是 Build Type 和 Product Flavor 的笛卡尔积。每个变体都可以独立配置资源、代码和依赖，最终生成不同的 APK。

6. 总结

构建变体是 Android 多版本管理的基石。通过这节课的实战，你应该掌握了：

• 如何在 build.gradle 中定义 Product Flavor
• 如何为不同 flavor 创建专属的资源目录（应用名、图标）
• 如何使用 BuildConfig 在代码中区分变体
• 如何在 Android Studio 中切换构建变体

这些技能在实际项目中几乎天天用到。我记得有一次接手一个老项目，里面用了一大堆 if (BuildConfig.FLAVOR.equals("free")) 这样的硬编码判断，维护起来简直噩梦。后来我全部改成了 buildConfigField，代码瞬间清爽多了。所以，从一开始就养成好习惯，用构建变体来管理差异，而不是在代码里写死逻辑。

---