Android多Library项目Maven发布多Build Type：依赖解析错误及变体差异化配置求助

我完全懂你现在的困境——在多模块Android项目里，要给每个Library打包debug和release两种Maven包，还要支持模块间互相依赖，结果碰到了发布时的依赖解析报错，而且还想给debug变体单独加上Javadoc和源码Jar，用multipleVariants又没法分开配置。我来一步步帮你解决这些问题。

先分析核心问题 #

你遇到的错误Publishing is not able to resolve a dependency on a project with multiple publications，本质是Gradle不知道该从:preferences项目的两个Maven Publication（release和debug）里选哪一个来满足依赖。另外你之前的配置里有重复的publishing块，这也会导致配置冲突，得先清理。

第一步：规范Library的Build.gradle配置 #

先把每个Library的build.gradle整理成干净的结构，分开Android变体配置和Maven发布配置，同时给debug单独加Javadoc Jar：

plugins {
    id 'com.android.library'
    id 'kotlin-android'
    id 'maven-publish'
}

android {
    namespace "com.example.preferences"
    compileSdk Integer.parseInt(ANDROID_BUILD_SDK_VERSION)

    defaultConfig {
        minSdkVersion 26
        targetSdkVersion 36
        versionName project.version // 用根项目统一版本
        consumerProguardFiles 'consumer-rules.pro'
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
        debug {
            // debug专属配置，比如开启调试日志等
        }
    }

    // 仅配置变体的附加Jar（这里实现debug单独带Javadoc）
    publishing {
        singleVariant("release") {
            withSourcesJar() // release只带源码Jar
            // 如果release不需要Javadoc就删除下面这行
            // withJavadocJar()
        }
        singleVariant("debug") {
            withSourcesJar() // debug带源码+Javadoc
            withJavadocJar()
        }
    }
}

// 根级Maven发布配置（合并你之前重复的两个publishing块）
publishing {
    publications {
        // Release版本的Maven发布
        release(MavenPublication) {
            artifactId = 'preferences'
            groupId = project.group // 用根项目统一GroupId
            version = project.version
            afterEvaluate {
                from components.release
            }
            pom {
                name = 'Preferences library'
                description = 'A library for managing application preferences in Android.'
                url = 'https://github.com/example/libraries'
            }
        }

        // Debug版本的Maven发布
        debug(MavenPublication) {
            artifactId = 'preferences-debug' // 用不同的artifactId区分
            groupId = project.group
            version = project.version
            afterEvaluate {
                from components.debug
            }
            pom {
                name = 'Preferences library (Debug)'
                description = 'Debug variant with sources and Javadoc for easier debugging.'
                url = 'https://github.com/example/libraries'
            }
        }
    }

    // GitHub Packages仓库配置
    repositories {
        maven {
            name = 'GitHubPackages'
            url = uri('https://maven.pkg.github.com/example/libraries')
            credentials {
                username = (project.findProperty('gpr.user') ?: System.getenv('GITHUB_ACTOR'))
                password = (project.findProperty('gpr.key') ?: System.getenv('GITHUB_TOKEN'))
            }
        }
    }
}

// 关键：解决项目内依赖的变体匹配问题
configurations.all { config ->
    // 只处理Implementation/CompileOnly类的依赖
    if (config.name.toLowerCase().contains('implementation') || config.name.toLowerCase().contains('compileonly')) {
        resolutionStrategy.eachDependency { details ->
            // 仅匹配当前项目组内的模块依赖
            if (details.requested.group == project.group && details.requested.module == 'preferences') {
                // 根据当前配置的BuildType自动选择对应变体
                def targetBuildType = config.name.toLowerCase()
                    .replace('implementation', '')
                    .replace('compileonly', '')
                    .trim()

                if (targetBuildType == 'debug') {
                    details.useTarget("${project.group}:preferences-debug:${project.version}")
                } else {
                    details.useTarget("${project.group}:preferences:${project.version}")
                }
            }
        }
    }
}

第二步：统一根项目的版本和GroupId #

在根项目的build.gradle里统一配置所有模块的groupId和version，避免每个模块重复写：

allprojects {
    group = 'com.example' // 替换成你的实际GroupId
    version = '0.0.1' // 统一版本号
    repositories {
        google()
        mavenCentral()
    }
}

第三步：其他模块引用的正确方式 #

现在其他模块可以正常用implementation(project(":preferences"))来引用，不需要改任何东西——上面的resolutionStrategy会自动根据当前的BuildType（debug/release）选择对应的变体：

• 当你构建debug包时，自动依赖:preferences的debug变体（即preferences-debug）
• 当你构建release包时，自动依赖:preferences的release变体（即preferences）

为什么这能解决问题？ #

1. 合并重复的publishing块：之前你有两个根级publishing块，会导致配置覆盖/冲突，现在合并成一个，清晰区分变体Jar配置（android块内）和Maven发布配置（根级）。
2. 自动变体匹配：通过resolutionStrategy，Gradle会根据当前模块的BuildType自动选择依赖模块的同类型变体，再也不会出现“不知道选哪个publication”的错误。
3. 差异化Jar配置：在android块内的publishing.singleVariant里，我们只给debug变体加withJavadocJar()，release变体可以按需选择，完美实现你的差异化需求。

测试验证 #

1. 先执行./gradlew publishToMavenLocal，打开本地Maven仓库（一般在~/.m2/repository/com/example/），你会看到preferences和preferences-debug两个目录，分别对应release和debug包。
2. 构建其他模块的debug/release版本，查看依赖树（./gradlew :other-module:dependencies），可以看到依赖已经自动替换成对应变体。

内容来源于stack exchange