使用Kotlin DSL+BuildSrc配置BuildTypes后无法运行的问题

问题场景 #

原项目需配置多个签名文件，通过BuildType区分不同签名，方便调试时快速切换设备调试。新项目采用多模块架构，用buildSrc实现配置共享。目前Android Studio已能显示自定义BuildTypes，但执行构建任务时失败，提示无法找到:xc_apex_base模块的匹配变体。

错误日志（翻译后） #

执行任务: [:midtest:assembleMidtestH0871] 于项目 C:\yongchuan\apex\intelligent_inspection_factory

> Task :xc_build:xcbuild:checkKotlinGradlePluginConfigurationErrors
> Task :xc_build:xcbuild:compileKotlin UP-TO-DATE
> Task :xc_build:xcbuild:compileJava NO-SOURCE
> Task :xc_build:xcbuild:pluginDescriptors UP-TO-DATE
> Task :xc_build:xcbuild:processResources UP-TO-DATE
> Task :xc_build:xcbuild:classes UP-TO-DATE
> Task :xc_build:xcbuild:jar UP-TO-DATE

FAILURE: Build failed with an exception.

* 出错原因:
无法确定任务 ':midtest:lintVitalReportMidtestH0871' 的依赖项。
> 无法解析配置 ':midtest:midtestH0871CompileClasspath' 的所有任务依赖项。
   > 无法解析项目 :xc_apex_base。
     被以下项目依赖:
         project :midtest
      > 未找到项目 :xc_apex_base 的匹配变体。消费者配置为查找编译时使用的库（优先针对Android优化），同时要求属性 'com.android.build.api.attributes.AgpVersionAttr' 值为 '8.4.0'，属性 'com.android.build.api.attributes.BuildTypeAttr' 值为 'h0871'，属性 'com.android.build.api.attributes.ProductFlavor:xcApexIIF' 值为 'midtest'，属性 'org.jetbrains.kotlin.platform.type' 值为 'androidJvm'，但:
          - 变体 'debugApiElements' 声明了编译时使用的库（优先针对Android优化），同时属性 'com.android.build.api.attributes.AgpVersionAttr' 值为 '8.4.0'，属性 'org.jetbrains.kotlin.platform.type' 值为 'androidJvm':
              - 不兼容：该组件声明属性 'com.android.build.api.attributes.BuildTypeAttr' 值为 'debug'，而消费者需要值为 'h0871'
              - 其他兼容属性:
                  - 未声明 'com.android.build.api.attributes.ProductFlavor:xcApexIIF' 属性（消费者要求值为 'midtest'）
          - 变体 'debugRuntimeElements' 声明了运行时使用的库（优先针对Android优化），同时属性 'com.android.build.api.attributes.AgpVersionAttr' 值为 '8.4.0'，属性 'org.jetbrains.kotlin.platform.type' 值为 'androidJvm':
              - 不兼容：该组件声明属性 'com.android.build.api.attributes.BuildTypeAttr' 值为 'debug'，而消费者需要值为 'h0871'
              - 其他兼容属性:
                  - 未声明 'com.android.build.api.attributes.ProductFlavor:xcApexIIF' 属性（消费者要求值为 'midtest'）
          - 变体 'debugSourcesElements' 声明了运行时使用的组件（优先针对Android优化），同时属性 'com.android.build.api.attributes.AgpVersionAttr' 值为 '8.4.0'，属性 'org.jetbrains.kotlin.platform.type' 值为 'androidJvm':
              - 不兼容：该组件是文档类型，且属性 'com.android.build.api.attributes.BuildTypeAttr' 值为 'debug'，而消费者需要库类型且值为 'h0871'
              - 其他兼容属性:
                  - 未声明 'com.android.build.api.attributes.ProductFlavor:xcApexIIF' 属性（消费者要求值为 'midtest'）
          - 变体 'releaseApiElements' 声明了编译时使用的库（优先针对Android优化），同时属性 'com.android.build.api.attributes.AgpVersionAttr' 值为 '8.4.0'，属性 'org.jetbrains.kotlin.platform.type' 值为 'androidJvm':
              - 不兼容：该组件声明属性 'com.android.build.api.attributes.BuildTypeAttr' 值为 'release'，而消费者需要值为 'h0871'
              - 其他兼容属性:
                  - 未声明 'com.android.build.api.attributes.ProductFlavor:xcApexIIF' 属性（消费者要求值为 'midtest'）
          - 变体 'releaseRuntimeElements' 声明了运行时使用的库（优先针对Android优化），同时属性 'com.android.build.api.attributes.AgpVersionAttr' 值为 '8.4.0'，属性 'org.jetbrains.kotlin.platform.type' 值为 'androidJvm':
              - 不兼容：该组件声明属性 'com.android.build.api.attributes.BuildTypeAttr' 值为 'release'，而消费者需要值为 'h0871'
              - 其他兼容属性:
                  - 未声明 'com.android.build.api.attributes.ProductFlavor:xcApexIIF' 属性（消费者要求值为 'midtest'）
          - 变体 'releaseSourcesElements' 声明了运行时使用的组件（优先针对Android优化），同时属性 'com.android.build.api.attributes.AgpVersionAttr' 值为 '8.4.0'，属性 'org.jetbrains.kotlin.platform.type' 值为 'androidJvm':
              - 不兼容：该组件是文档类型，且属性 'com.android.build.api.attributes.BuildTypeAttr' 值为 'release'，而消费者需要库类型且值为 'h0871'
              - 其他兼容属性:
                  - 未声明 'com.android.build.api.attributes.ProductFlavor:xcApexIIF' 属性（消费者要求值为 'midtest'）

* 尝试解决:
> 查看变体匹配算法文档
> 查看无匹配变体错误的详细说明
> 使用 --info 或 --debug 选项获取更多日志输出
> 使用 --scan 获取完整分析信息
> 前往 https://help.gradle.org 获取更多帮助。

BUILD FAILED in 1s
5个可执行任务: 1个执行, 4个已是最新状态
XC XcSigning size 7XC XcSigning storeFile C:\yongchuan\apex\intelligent_inspection_factory\signKeys\android13platform.keystoreXC XcSigning storeFile C:\yongchuan\apex\intelligent_inspection_factory\signKeys\t1621_movfast.keystoreXC XcSigning storeFile C:\yongchuan\apex\intelligent_inspection_factory\signKeys\t1622platform.keystoreXC XcSigning storeFile C:\yongchuan\apex\intelligent_inspection_factory\signKeys\t1625_pdd.keystoreXC XcSigning storeFile C:\yongchuan\apex\intelligent_inspection_factory\signKeys\p0823_key.jksXC XcSigning storeFile C:\yongchuan\apex\intelligent_inspection_factory\signKeys\h0831_platform.keystoreXC XcSigning storeFile C:\yongchuan\apex\intelligent_inspection_factory\signKeys\h1071_platform.keystore

原因分析 #

1. BuildType不统一：应用模块（midtest）注册了自定义BuildType（如h0871），但依赖的库模块:xc_apex_base仅保留默认的debug/release BuildType，没有同步生成自定义BuildType，导致变体的BuildType属性不匹配。
2. Flavor配置缺失：应用模块配置了Flavor（midtest）和对应的维度，但库模块没有配置相同的Flavor维度和Flavor，导致Flavor属性不匹配。

解决方案 #

1. 所有模块统一BuildType配置 #

在buildSrc中定义的configureBuildTypes方法对所有模块（包括应用和库）生效，确保库模块也生成对应的自定义BuildType。在每个库模块的build.gradle.kts中调用该配置方法：

// 库模块的build.gradle.kts
plugins {
    id("com.android.library")
    kotlin("android")
}

android {
    // ...其他配置
}

// 应用buildSrc中的BuildType配置
configureBuildTypes(commonExtension = this)

2. 所有模块统一Flavor配置 #

同样，库模块也需要同步Flavor配置，确保变体的Flavor属性一致。在库模块的build.gradle.kts中调用configureFlavors方法：

// 库模块的build.gradle.kts
// ...其他配置

configureFlavors(commonExtension = this)

3. （可选）忽略Flavor维度（不推荐） #

如果库模块不需要区分Flavor，可以在应用模块中添加missingDimensionStrategy来忽略Flavor匹配，但这种方式会破坏配置一致性，仅作为临时方案：

// 应用模块的build.gradle.kts
android {
    defaultConfig {
        missingDimensionStrategy("xcApexIIF", "midtest")
    }
}

验证修改 #

重新执行构建任务，此时库模块会生成与应用模块对应的BuildType和Flavor变体，依赖解析时就能找到匹配的变体，构建即可正常完成。

内容的提问来源于stack exchange，提问作者乐于助人的王老师