Android Gradle：Maven远程仓库依赖传递问题咨询

阿华AIGC实验室

2026-5-20

解决Android库依赖远程Maven仓库的传递问题

首先得明确一个关键事实：Gradle 默认会忽略依赖 POM 文件中声明的 <repositories> 标签。这是Gradle的设计决策，目的是让消费端（也就是你的应用）完全控制仓库来源，避免意外引入不可信的仓库，所以你之前尝试在POM中添加仓库配置没有效果是正常的。

下面针对你的需求，给出几种可行的解决方案，你可以根据自己的场景选择：

方案一：将远程依赖迁移到公共/统一仓库

如果条件允许，把你依赖的remote.groudid:remote.artifactid:remote.version包发布到一个公共仓库（比如Maven Central、Google Maven），或者你们团队内部的统一Maven仓库。这样应用只需要配置这些默认/统一的仓库，就能同时拉取你的库和它的依赖，不需要额外添加仓库。

这个方案是最推荐的，因为它符合Gradle的设计理念，也能避免后续的维护问题。

方案二：在库的POM中传递仓库信息，让应用自动加载

虽然Gradle不读取POM的<repositories>，但你可以把仓库URL放到POM的<properties>中，然后在应用端通过脚本自动读取并添加仓库。

步骤1：修改库的maven-publish配置

在你的库的build.gradle中，修改pom.withXml部分，添加仓库URL到properties：

apply plugin: 'maven-publish'

publishing {
    publications {
        library(MavenPublication) {
            setGroupId(groupId)
            setArtifactId(artifactId)
            setVersion(version)
            artifact(bundleRelease)

            pom.withXml {
                // 处理依赖节点（保持你原来的代码）
                def dependenciesNode = asNode().appendNode('dependencies')
                configurations.compile.allDependencies.each {
                    if (it.group != null && (it.name != null || "unspecified".equals(it.name)) && it.version != null) {
                        def dependencyNode = dependenciesNode.appendNode('dependency')
                        dependencyNode.appendNode('groupId', it.group)
                        dependencyNode.appendNode('artifactId', it.name)
                        dependencyNode.appendNode('version', it.version)
                    }
                }
                // 添加仓库URL到properties
                def propertiesNode = asNode().appendNode('properties')
                propertiesNode.appendNode('custom.remote.maven.url', 'https://remote.maven.url/')
            }
        }
    }
}

步骤2：在应用中添加自动加载仓库的脚本

在应用的build.gradle中添加以下代码，它会读取你库的POM中的properties，自动添加对应的仓库：

gradle.projectsEvaluated {
    configurations.all {
        resolutionStrategy.eachDependency { details ->
            // 尝试获取依赖的POM信息
            def module = details.requested.module
            try {
                def pom = module.pom
                def remoteRepoUrl = pom.properties.getProperty('custom.remote.maven.url')
                if (remoteRepoUrl != null && !repositories.any { it.url.toString() == remoteRepoUrl }) {
                    repositories.maven {
                        url remoteRepoUrl
                        name "Some maven remote dependency"
                    }
                }
            } catch (Exception e) {
                // 如果获取POM失败，忽略即可
                println "Failed to read POM for ${module}: ${e.message}"
            }
        }
    }
}

这个方案的好处是应用只需要添加一次这段脚本，后续引入你的其他库也能自动加载对应的仓库，不需要手动修改repositories。