如何基于libs.versions.toml配置Android Gradle构建变体

完全可以通过Version Catalog配合Android构建变体实现你的需求，具体步骤如下：

1. 更新libs.versions.toml，统一管理多版本依赖 #

将不同变体所需的依赖版本和库条目都定义在Catalog中，方便集中维护：

[versions]
# Android 5(api-21)兼容版本
activityAndroid5 = "1.11.0"
commonsIoAndroid5 = "2.7"
# Android 6+(api-23)兼容版本
activityAndroid6 = "1.13.0"
commonsIoAndroid6 = "2.22.0"

[libraries]
# Android 5专属依赖条目
android-activity-android5 = { group = "androidx.activity", name = "activity", version.ref = "activityAndroid5" }
java-commons-io-android5 = { module = "commons-io:commons-io", version.ref = "commonsIoAndroid5" }
# Android 6+专属依赖条目
android-activity-android6 = { group = "androidx.activity", name = "activity", version.ref = "activityAndroid6" }
java-commons-io-android6 = { module = "commons-io:commons-io", version.ref = "commonsIoAndroid6" }

2. 在模块构建脚本中配置构建变体并绑定依赖 #

通过Android的**产品风味（Product Flavor）**区分两个变体，分别设置最低兼容版本，并为每个风味绑定对应的依赖：

Kotlin DSL（build.gradle.kts）示例： #

android {
    // 定义风味维度
    flavorDimensions += "androidVersion"
    productFlavors {
        create("android5") {
            dimension = "androidVersion"
            minSdk = 21
        }
        create("android6") {
            dimension = "androidVersion"
            minSdk = 23
        }
    }
}

dependencies {
    // 为Android5风味绑定对应依赖
    android5Implementation(libs.android.activity.android5)
    android5Implementation(libs.java.commons.io.android5)
    
    // 为Android6风味绑定对应依赖
    android6Implementation(libs.android.activity.android6)
    android6Implementation(libs.java.commons.io.android6)
}

Groovy DSL（build.gradle）示例： #

android {
    flavorDimensions 'androidVersion'
    productFlavors {
        android5 {
            dimension 'androidVersion'
            minSdk 21
        }
        android6 {
            dimension 'androidVersion'
            minSdk 23
        }
    }
}

dependencies {
    android5Implementation libs.android.activity.android5
    android5Implementation libs.java.commons.io.android5
    
    android6Implementation libs.android.activity.android6
    android6Implementation libs.java.commons.io.android6
}

核心思路说明 #

• Version Catalog负责集中管理所有依赖版本和库定义，避免版本号散落在多个构建脚本中；
• 利用Android的产品风味机制，将不同兼容版本的逻辑隔离为独立变体；
• 通过风味专属的依赖配置（如android5Implementation），为每个变体绑定对应的依赖版本，实现需求中的差异。

内容的提问来源于stack exchange，提问作者k3b