You need to enable JavaScript to run this app. 如何通过Gradle完成GPG签名并直接发布AAR到Maven Central
优惠活动
大模型
产品
解决方案
定价
更多

如何通过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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.31 16:54:03