Android多维度Flavor依赖配置报错：未找到指定配置

问题场景 #

将Flavor划分为APP_TYPE和OPERATING_SYSTEM两个维度，配置4个Flavor组合生成变体。单个Flavor的implementation配置可正常生效，但为组合维度变体（如totoAndroid）配置依赖时，报错提示Configuration with name 'totoAndroidImplementation' not found，且已确认常量为驼峰命名、目标变体确实存在。

相关配置代码：

// 维度定义
flavorDimensions += listOf(
    ProjectAndroidConstants.APP_TYPE_DIMENSION,
    ProjectAndroidConstants.OPERATING_SYSTEM_DIMENSION
)

productFlavors {
    // 操作系统维度
    create(ProjectAndroidConstants.ANDROID_FLAVOR) {
        isDefault = true
        dimension = ProjectAndroidConstants.OPERATING_SYSTEM_DIMENSION
    }
    create(ProjectAndroidConstants.HUAWEI_FLAVOR) {
        dimension = ProjectAndroidConstants.OPERATING_SYSTEM_DIMENSION
    }

    // App类型维度
    create(ProjectAndroidConstants.TOTO_FLAVOR) {
        isDefault = true
        dimension = ProjectAndroidConstants.APP_TYPE_DIMENSION
    }
    create(ProjectAndroidConstants.TATA_FLAVOR) {
        dimension = ProjectAndroidConstants.APP_TYPE_DIMENSION
    }
}

// 单个Flavor配置有效
"${ProjectAndroidConstants.TOTO_FLAVOR}Implementation"("com.myproject.android:authentication-session:0.1.0")

// 组合变体配置报错
"${ProjectAndroidConstants.TOTO_FLAVOR}${ProjectAndroidConstants.ANDROID_FLAVOR}Implementation"("com.myproject.android:authentication-session:0.1.0")

原因分析 #

在Kotlin DSL中，多维度组合变体的配置并非在构建脚本初始化阶段生成，直接在dependencies块中引用会因配置未创建而触发报错。而单个Flavor的配置随维度定义同步生成，因此可直接使用。

解决方法 #

方法1：使用afterEvaluate延迟配置 #

通过afterEvaluate块延迟执行依赖配置，确保Gradle已完成变体创建：

afterEvaluate {
    dependencies {
        // 硬编码配置名示例
        "totoAndroidImplementation"("com.myproject.android:authentication-session:0.1.0")
        // 常量拼接示例
        "${ProjectAndroidConstants.TOTO_FLAVOR}${ProjectAndroidConstants.ANDROID_FLAVOR}Implementation"(
            "com.myproject.android:authentication-session:0.1.0"
        )
    }
}

方法2：使用AGP的androidComponents API（推荐） #

AGP 7.0及以上版本支持通过androidComponents直接针对变体配置依赖，无需依赖执行时机，是更规范的实现方式：

androidComponents {
    onVariants { variant ->
        if (variant.name == "${ProjectAndroidConstants.TOTO_FLAVOR}${ProjectAndroidConstants.ANDROID_FLAVOR}") {
            variant.dependencies.add("implementation", "com.myproject.android:authentication-session:0.1.0")
        }
    }
}

方法3：通过configurations手动获取配置 #

直接通过configurations.named定位目标配置并添加依赖：

configurations.named("${ProjectAndroidConstants.TOTO_FLAVOR}${ProjectAndroidConstants.ANDROID_FLAVOR}Implementation") {
    dependencies.add("implementation", "com.myproject.android:authentication-session:0.1.0")
}

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