Android Gradle模块配置BuildTypeAttr实现Debug/Release分用AAR

要在Kotlin脚本中为Debug/Release构建类型分别绑定不同的本地AAR，核心是给自定义配置正确设置BuildTypeAttr属性，同时关联到对应的构建类型。以下是完整的可运行配置：

1. 定义带BuildType属性的自定义配置 #

在模块的build.gradle.kts中，先创建专属配置并绑定BuildType属性：

configurations {
    // Debug环境专属AAR配置
    create("debugLocalAar") {
        attributes {
            // 标记为外部依赖（本地AAR）
            attribute(Bundling.BUNDLING_ATTRIBUTE, objects.named(Bundling.EXTERNAL))
            // 绑定debug BuildType属性
            attribute(BuildTypeAttr.ATTRIBUTE, objects.named("debug"))
        }
        // 配置仅用于解析，不对外暴露
        isCanBeConsumed = false
        isCanBeResolved = true
    }

    // Release环境专属AAR配置
    create("releaseLocalAar") {
        attributes {
            attribute(Bundling.BUNDLING_ATTRIBUTE, objects.named(Bundling.EXTERNAL))
            attribute(BuildTypeAttr.ATTRIBUTE, objects.named("release"))
        }
        isCanBeConsumed = false
        isCanBeResolved = true
    }
}

2. 将配置关联到对应BuildType #

在android块的buildTypes中，把自定义配置绑定到Debug/Release构建类型：

android {
    buildTypes {
        debug {
            // 当依赖没有明确匹配的BuildType时，回退到debug
            matchingFallbacks += listOf("debug")
            dependencies {
                // 让debug构建使用debugLocalAar配置的依赖
                add("debugImplementation", configurations["debugLocalAar"])
            }
        }

        release {
            matchingFallbacks += listOf("release")
            dependencies {
                add("releaseImplementation", configurations["releaseLocalAar"])
            }
        }
    }
}

3. 添加本地AAR依赖 #

最后把不同环境的AAR文件关联到对应的配置：

dependencies {
    "debugLocalAar"(files("libs/your-debug-sdk.aar"))
    "releaseLocalAar"(files("libs/your-release-sdk.aar"))
}

关键注意点 #

• 必须设置BuildTypeAttr.ATTRIBUTE：这是解决依赖解析错误的核心，告诉Gradle该配置属于哪个构建类型
• 配置的isCanBeResolved设为true：确保Gradle可以解析该配置下的依赖
• matchingFallbacks不可少：本地AAR通常没有内置BuildType属性，需要指定回退规则避免匹配失败
• 确认AAR路径正确：确保libs目录下的文件名和配置中的路径一致

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