Gradle 中怎么配置签名插件对发布的 Jar 进行数字签名

老明大大_9291

老明大大_9291

2026-08-12

837人浏览

原创

gradle中对发布的jar进行数字签名需启用signing和maven-publish插件,绑定signing到mavenpublication,通过usegpgcmd()调用gpg为jar、sources jar、javadoc jar生成.asc签名文件,且须提前配置gpg密钥并上传公钥至密钥服务器。

gradle 中怎么配置签名插件对发布的 jar 进行数字签名

Gradle 中对发布的 Jar 进行数字签名,需使用 signing 插件配合 maven-publish 插件,核心是为发布产物(如 JAR、sources JAR、Javadoc JAR)生成并附加 GPG 签名文件(.asc)。这在发布到 Maven Central 等合规仓库时是强制要求。

启用 signing 插件并关联 publication

在 build.gradle.kts 中,先应用插件,再将 signing 逻辑绑定到具体的 MavenPublication 上:

  • 必须同时启用 maven-publish 和 signing 插件
  • signing 配置需明确指定要签名的 publication(例如 "myLibrary")
  • 不推荐在 signing 块中硬编码密钥信息;应通过 GPG agent 或环境变量提供凭据

示例配置:

OpenJDK 24
OpenJDK 24

OpenJDK 24 Windows x64 官方参考实现(24+36),适合 Windows 环境进行 Java 开发、编译、运行和版本兼容性验证。

下载
plugins {
  `maven-publish`
  signing
}

publishing {
  publications {
    create("myLibrary") {
      from(components["java"])
      // 其他 POM 配置略
    }
  }
  repositories { /* 如 Nexus 或 Maven Central */ }
}

signing {
  useGpgCmd()
  sign(publishing.publications["myLibrary"])
}

确保所有发布产物都被签名

Maven Central 要求不仅主 JAR,还包括 -sources.jar 和 -javadoc.jar 都必须有对应 .asc 签名文件。Gradle 默认会自动为这些附属 artifact 签名,前提是它们被包含在 publication 的 from(components["java"]) 中。

  • 检查是否已声明 withJavadocJar() 和 withSourcesJar()
  • 确认 publishing.publications["myLibrary"].artifacts 列表中包含这三个文件
  • 执行 ./gradlew publish 后,目标仓库目录下应出现:xxx.jar、xxx.jar.asc、xxx-sources.jar、xxx-sources.jar.asc 等

配置 GPG 密钥与凭据

Gradle 不直接管理 GPG 密钥,而是调用系统 gpg 或 gpg2 命令。你需要提前完成以下准备:

  • 安装 GPG 工具(macOS 可用 brew install gnupg;Windows 推荐 Gpg4win)
  • 生成密钥对:gpg --full-generate-key,建议选择 RSA 4096 位、有效期设为永不过期或长期
  • 导出公钥并上传至密钥服务器:gpg --keyserver keyserver.ubuntu.com --send-keys YOUR_KEY_ID
  • 确保当前用户能无密码调用 gpg --list-secret-keys(若设了 passphrase,需配置 gpg-agent 缓存)

跳过签名或临时调试的方法

开发阶段可临时禁用 signing,避免每次构建都触发 GPG 提示:

  • 在命令行加参数:./gradlew publish -x signing
  • 或在 signing { } 块中加条件判断:if (findProperty("signing.keyId") != null) { ... }
  • 注意:跳过 signing 将导致无法通过 Maven Central 同步校验

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Java Maven/Gradle 构建与依赖管理合集
Java Maven/Gradle 构建与依赖管理合集

系统讲解 Java 项目构建工具的使用与进阶配置,涵盖 Maven 的 POM 文件结构、生命周期(clean/compile/package/install/deploy)与插件机制、依赖范围(compile/provided/test/runtime)与传递依赖管理、多模块聚合与继承、私有 Nexus 仓库发布,以及 Gradle 的 Groovy / Kotlin DSL 语法、Task 自定义与增量构建、依赖版本目录(Versi

2026.05.09

349

25

剧云AI短剧创作教程合集
剧云AI短剧创作教程合集

本专题聚焦剧云AI短剧创作,讲解从短剧灵感、梗概、全局大纲到分集、分场和正文的完整流程及节奏设计方法。

2026.10.14

0

15

剧云AI剧本创作零基础入门
剧云AI剧本创作零基础入门

本专题系统讲解剧云AI剧本创作流程,涵盖灵感、梗概、大纲、分场与正文生成,帮助新手快速完成首个中文剧本项目。

2026.10.14

0

14

VibeKnow文档转视频操作指南
VibeKnow文档转视频操作指南

本专题讲解VibeKnow上传Word、TXT、Markdown等材料生成视频的方法,覆盖内容解析、脚本组织、画面生成与成片检查。

2026.10.14

0

15

VibeKnow知识视频制作与导出详解
VibeKnow知识视频制作与导出详解

本专题整理VibeKnow从注册、素材上传、AI生成到预览导出的完整操作,帮助新手快速制作第一条知识讲解视频。

2026.10.14

0

13

二狗PPT大纲编辑实操指南
二狗PPT大纲编辑实操指南

本专题聚焦二狗PPT结构化大纲的生成和修改,讲解标题、正文、目录、页数与页面顺序的调整方法,提升汇报逻辑和内容完整性。

2026.10.14

0

15

二狗PPT文档转PPT全教程
二狗PPT文档转PPT全教程

本专题讲解二狗PPT解析Word、PDF、Excel和PPT资料的方法,涵盖文件上传、内容提取、大纲整理、异常处理与转换后校对。

2026.10.14

0

13

讯飞绘文全功能使用教程
讯飞绘文全功能使用教程

本专题系统整理讯飞绘文官网入口、注册登录、工作台及内容创作流程,帮助用户熟悉常用功能,快速完成首篇图文内容。

2026.10.14

0

14

讯飞绘文AI写作与文案生成合集
讯飞绘文AI写作与文案生成合集

本专题聚焦讯飞绘文AI写作、提纲生成、文章改写和文案润色,覆盖从主题输入到成稿优化的关键操作与实用技巧。

2026.10.14

0

14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习