如何通过Gradle完成GPG签名并直接发布AAR到Maven Central
Android AAR 发布Maven Central的稳定配置方案
常见配置误区说明
- 参考Java项目指南里写的
archives jar,指代的是Java Gradle插件默认的主JAR构建任务,这套逻辑完全不适用于Android Library项目——Android项目不存在这个原生jar任务,待发布的核心主构件本来就是构建产出的AAR包。 - 手动遍历variant输出路径、硬塞
output.outputFile到project.artifacts的写法,没有把AAR文件纳入Maven Publication的可追踪构件链路,导致GPG签名插件无法识别需要签名的主构件,自然生成不出对应的.asc签名文件,最终触发“文件不存在”的报错。
全流程可落地配置步骤
1. 基础插件引入
确保项目根模块已经引入发布所需的基础插件:
plugins { id 'com.android.library' id 'maven-publish' id 'signing' }
2. 绑定发布变体的构件到Publication(解决核心报错)
不要硬编码文件路径,直接将对应构建任务的产出绑定到发布配置,让Gradle自动维护任务依赖关系:
android { publishing { // 为目标发布变体(示例为fullRelease)生成对应的发布链路 singleVariant("fullRelease") { withSourcesJar() // 自动生成对应变体的sources jar withJavadocJar() // 自动生成对应变体的javadoc jar } } } publishing { publications { mavenFullReleaseAar(MavenPublication) { // 核心配置:直接将AAR构建任务的产物绑定为主发布构件 artifact(tasks.named("bundleFullReleaseAar")) // 绑定自动生成的sources、javadoc jar,无需手动从全局artifacts中捞取 artifact(tasks.named("fullReleaseSourcesJar")) artifact(tasks.named("fullReleaseJavadocJar")) // 配置pom所需的坐标、项目描述、许可证、开发者等信息 pom { name = "项目名称" description = "项目描述" // 其余pom节点按需配置 } } } repositories { // 配置Maven Central的上传仓库地址 } }
3. 自动GPG签名配置
无需手动指定需要签名的文件,signing插件会自动识别当前Publication下所有已绑定的构件,逐一生成对应的签名文件:
signing { // 从本地gradle.properties读取GPG密钥配置,不要硬编码敏感信息 def signingKeyId = gradleLocalProperties.rootProject.getProperty("signing.keyId") def signingPassword = gradleLocalProperties.rootProject.getProperty("signing.password") def signingSecretRing = file(gradleLocalProperties.rootProject.getProperty("signing.secretKeyRingFile")) useGpgCmd() // 对目标Publication的所有构件自动签名 sign publishing.publications.mavenFullReleaseAar }
不稳定报错的根源规避
所有绑定到Publication的构件,必须直接引用Gradle任务对象,不能直接引用任务生成的文件路径。通过这种绑定方式,Gradle会自动按照正确的执行顺序触发所有关联任务:
- 先执行AAR、sources jar、javadoc jar的构建任务,产出所有待发布文件
- 再执行签名任务,为所有待发布文件生成对应的
.asc签名 - 最后执行上传任务,从根源上避免任务时序错乱导致的“文件不存在”问题。
之前手动遍历variant输出硬加文件的写法,没有建立有效的任务依赖关系,Gradle无法感知AAR文件的生成时机,很容易出现签名插件漏签、任务执行顺序错乱的不稳定问题。
内容的提问来源于stack exchange,提问作者d4vidi
相关产品推荐
相关产品推荐

