上传Jar包到Maven中央仓库

在项目开发过程中，我们常常会使用 Maven / Gradle 从仓库拉取开源的第三方 jar 包，可能是私有仓库，可能是 Maven 中央仓库，也可能是第三方的镜像。本文将一些简单实用的操作步骤和示例，带领大家将自己写好的代码或开源项目发布到 Maven中央仓库(https://mvnrepository.com/)中，让其他人可以直接依赖你的 jar 包，而不需要先下载你的代码 / jar 后 install 到本地。

Maven中央仓库并不支持直接发布 jar 包，需要将 jar 包发布到一些指定的第三方Maven仓库，然后该仓库再将 jar 包同步到 Maven中央仓库，Sonatype便是 Maven中央仓库指定的暂存库。

准备工作

本教程以 Maven 项目为例，本人使用的开发环境为：win10 + jdk1.8 + maven 3.6.3 。请提前准备好能成功打包的项目。
Sonatype 的相关地址在国外，如遇网络问题可以换时间段尝试或者自行准备 vpn 、代理等其他方式。
网站存在部分英文，如阅读 / 沟通困难，可以使用 Chrome 浏览器的页面翻译插件，或者使用其他翻译工具进行辅助。
Sonatype 使用 JIRA 的工单系统来管理 OSSRH 仓库，对 JIRA 不了解的童鞋可以度娘查询相关的操作及页面释义。
此过程由于需要国外管理员审核，使用 JIRA 工单评论进行交流，可能每次审核答复时间从几分钟到几小时不等，大家在此过程中可以时不时刷新页面或者留意邮件通知。

Sonatype 帐号

Sonatype 地址: https://issues.sonatype.org/secure/Dashboard.jspa

如果未使用过 Sonatype 系统，需要先注册一个帐号。

Email: 填写自己的邮箱帐号即可，在 Sonatype 上的相关操作，会通知到这个邮箱帐号来提醒你相关进度。
Full name: 填写联系人名称。
Username: 这个就是你在 Sonatype 的登录帐号了。
Password: 为登录密码，要求至少8位，并带有大小写字母和字符。

注册完帐号首次登录时，会让你选择界面语言，按个人喜好选择即可(PS: 选择中文时部分操作按钮和说明会是中文，但界面和沟通语言仍为英语)。

项目申请

创建工单

可以理解为在 Sonatype 系统中申请一个自己的项目，以 Group Id 为单位，Group Id 支持域名地址和 Github 地址两种方式验证，大家可根据实际情况自行选择。申请后需要经过管理员对我们填写的 Group Id 所有权进行验证，审核通过后方可上传 jar 包。我们在页面顶部点击 Create 按钮来创建工单。

Project: 项目类型。选择 Community Support – Open Source Project Repository Hosting (OSSRH)
Issue Type: 工单类型。选择 New Project
Summary: 填写 jar 包名称即可
Description: 选填项，写一些描述
Group Id: 填写项目的Group Id，域名和 Github Group Id两种方式下面分别介绍申请过程
Project URL: 填写项目主页，可以是托管地址，也可以是官网地址
SCM URL: 填写项目的 Git 地址

域名 Group Id

如果有自己的域名(拥有域名所有权)，则可以使用域名作为 Group Id。命名规则是域名的反向名称，比如我的域名是 xanderye.cn，那么我的 Group Id 可以使用 cn.xanderye 或者 cn.xanderye.** 。如果你的项目是多模块项目，则建议你在 Group Id 后面附加一个新的标识符，比如 cn.xanderye.plugins ，表示该 Group Id 下的项目为插件模块。下图为使用域名作为 Group Id 创建工单示例。

https://wp.xanderye.cn/wp-content/uploads/2021/05/image.png

Github Group Id

如果你还没有一个属于自己的域名，那我们可以直接使用 Github 的地址作为 Group Id 。Github Group Id 采用com.github.username 的命名方式，比如我在 Github 的帐号地址为 https://github.com/xanderye，那我的 Group Id 即为 com.github.xanderye。这里使用csdn博主的图片为例。

资质审核

创建完工单后，会显示一个未解决的工单（Resolution: Unresolved，Status: OPEN），同时在页面可以看到 JIRA 分配了一个管理员来跟进此工单作业。运气好过两分钟就会有人回复你相关的审核信息了，最长不超过1天应该，毕竟国内外存在时间差，工作人员也是需要下班休息的。

https://wp.xanderye.cn/wp-content/uploads/2021/05/image-1.png

请耐心等候即可，若未及时回复，可以挂起页面去干些别的事情。下面分别是域名 Group Id 和 Github Group Id 的审核过程示例。

域名 Group Id

使用域名申请的，一般会得到类似下图的回复（此图是我申请之后截图的，图中标红部分由于我验证通过变成了我的工单号，原本应该是一个 TXT 验证的字符串地址）。他的意思是询问我们填的 Group Id 那个域名是不是自己的，支持两种验证方式：

域名 TXT 记录验证。需要在域名的 DNS 解析中添加一条 TXT 解析记录，目标值为上图红圈部分（新工单收到的回复应该是一个长字符串），官方说此方式最快。
Github 重定向验证。需要设置你的域名重定向到申请所填的 Github URL 地址。

https://wp.xanderye.cn/wp-content/uploads/2021/05/image-2.png

本人使用域名 TXT 记录验证的方式，我的域名是在阿里云买的，所以我在阿里云域名解析控制台添加 TXT 解析记录。其他服务商的域名解析请自行查询操作方式。

https://wp.xanderye.cn/wp-content/uploads/2021/05/image-3.png

如果想要验证记录是否生效，可使用 nslookup -q=txt ossrh-69180.xanderye.cn 命令进行验证。

https://wp.xanderye.cn/wp-content/uploads/2021/05/image-7.png

解析生效后，需要我们在页面对工单进行评论，告诉管理员我们已经将域名解析到对应地址。之后就等待管理员审核。

https://wp.xanderye.cn/wp-content/uploads/2021/05/image-5.png

Github Group Id

使用 Github Group Id 申请的，则会收到类似下图的回复，他告诉我们需要在自己的 Github 仓库中新建一个名为工单号的项目。下面用csdn博主的截图示例。

这里项目名是 OSSRH-65608 ，并且该项目需要是 public 的权限，即所有人可访问，接下来在 Github 创建一个空项目。

创建完 Github 项目后，我们需要在页面上评论工单，告诉管理员我们已经创建好了他指定的项目。之后等待管理员审核。

审核通过

若收到类似下图的回复，则证明我们的项目审核通过了，而且工单的状态变更为[Resolution: RESOLVED，Status: Fixed]，说明我们已经可以发布我们的 jar 包到中央仓库了。之前需要发布后再次回复，才有工作人员给你同步仓库，目前应该已经改成不需要回复就可以自动同步了。

https://wp.xanderye.cn/wp-content/uploads/2021/05/image-6.png

以前回复的地址域名为 oss.sonatype.org ，官方已声明建议使用新域名地址 s01.oss.sonatype.org。

而且之前的回复中会带上 snapshot 快照版和release 正式版的仓库地址，但新版回复中仅告诉我们在 https://s01.oss.sonatype.org/ 上进行配置。我们打开他回复中提供的开发文档 https://central.sonatype.org/pages/ossrh-guide.html#deployment 可以找到新的 snapshot 快照版和release 正式版的仓库地址。这个地址在下面进行的配置中会用到。

https://img-blog.csdnimg.cn/img_convert/202629126565cba344515a9a13b97390.png

GPG签名

GPG 的主要作用是生成密钥对，发布到 Maven 仓库中的所有文件都要使用 GPG 签名，以保障完整性。使用 Windows 的可以下载gpg4win 地址：https://www.gpg4win.org/download.html ，安装后执行 gpg –gen-key 命令新建密钥对。

执行命令后，需要输入姓名和邮箱还有 Passphase（证书密码），Passphase 需要记住，在我们使用证书的时候会要求我们输入密码。

https://wp.xanderye.cn/wp-content/uploads/2021/05/image-8.png

执行完之后我们会得到上图中的 pub 串，接着我们执行以下命令将 pub 上传到 key 验证库（后面的串替换为自己的）。

gpg --keyserver hkp://keyserver.ubuntu.com:11371 --send-keys D3E558810805BAB8396032AA6C6F22ECE1F40CE2

Maven 配置

setting.xml

首先是 Maven 全局配置文件 setting.xml，路径为 $MAVEN_HOME/conf/settings.xml ，若不知道该配置文件在哪，可以执行 mvn -v 命令查看 Maven Home 的 bin 目录，setting.xml 文件在与 bin 目录同级的 conf 目录下。

配置 sonatype 系统的账户密码，复制以下配置，修改为自己用户名密码后，添加到 setting.xml 文件中的 … 节点。注意查看节点是否已被注释掉。

<server>
      <id>sonatype-releases</id>
      <username>sonatype_username</username>
      <password>sonatype_password</password>
    </server>
	<server>
      <id>sonatype-snapshots</id>
      <username>sonatype_username</username>
      <password>sonatype_password</password>
    </server>

配置 gpg 的账户密码，复制以下配置，修改为自己的密码后，添加到 setting.xml 文件中的 … 节点。注意查看节点是否已被注释掉。

<profile>
    <!-- id 与 pom.xml 的 maven-gpg-plugin 插件中的 id 对应-->
  <id>ossrh</id>
  <activation>
	<activeByDefault>true</activeByDefault>
  </activation>
  <properties>
	<gpg.executable>gpg</gpg.executable>
	<gpg.passphrase>your_gpg_password</gpg.passphrase>
  </properties>
</profile>

pom.xml

若以下配置节点，有些童鞋不清楚该配置到什么位置的，可以参考下面我的配置示例。

项目 URL 、SCM信息、开发者信息。修改对应值为自己的

<licenses>
    <license>
      <name>The Apache Software License, Version 2.0</name>
      <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
      <distribution>repo</distribution>
    </license>
  </licenses>

  <scm>
    <url>https://www.xanderye.cn</url>
    <connection>scm:git:https://github.com/XanderYe/xander-tool.git</connection>
    <developerConnection>scm:https://github.com/XanderYe/xander-tool.git</developerConnection>
  </scm>

  <developers>
    <developer>
      <name>XanderYe</name>
      <email>XanderYe@outlook.com</email>
      <organization>XanderYe</organization>
      <organizationUrl>https://www.xanderye.cn</organizationUrl>
    </developer>
  </developers>

Javadoc 和 Source 插件

<plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>3.1.0</version>
        <configuration>
          <doclint>none</doclint>
        </configuration>
        <executions>
          <execution>
            <id>attach-javadocs</id>
            <goals>
              <goal>jar</goal>
            </goals>
          </execution>
        </executions>
      </plugin>

      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-source-plugin</artifactId>
        <version>3.1.0</version>
        <executions>
          <execution>
            <id>attach-sources</id>
            <goals>
              <goal>jar-no-fork</goal>
            </goals>
          </execution>
        </executions>
      </plugin>

GPG 签名插件

<plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-gpg-plugin</artifactId>
        <version>1.6</version>
        <executions>
          <execution>
            <id>ossrh</id>
            <phase>verify</phase>
            <goals>
              <goal>sign</goal>
            </goals>
          </execution>
        </executions>
      </plugin>

snapshot 快照版和 release 正式版的仓库地址

<distributionManagement>
    <snapshotRepository>
      <id>sonatype-snapshots</id>
      <url>https://s01.oss.sonatype.org/content/repositories/snapshots/</url>
    </snapshotRepository>
    <repository>
      <id>sonatype-releases</id>
      <url>https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/</url>
    </repository>
  </distributionManagement>

打包发布

完成以上配置，我们就可以往 Maven 中央仓库上传 jar 包了，我们使用 Maven 命令上传。

mvn clean deploy

命令执行期间可能会要求输入证书密码，以下是执行成功后的截图：

https://wp.xanderye.cn/wp-content/uploads/2021/05/image-9-1024x577.png

snapshots 和 releases 版本区别在于版本号以 -SNAPSHOT 结尾，在 deploy 命令时，发布快照版本。而发布 release 版本的时候，项目版本号不能以 -SNAPSHOT 结尾，插件和依赖项也不能以 -SNAPSHOT结尾。

maven构建成功后，别急，只是把jar发布到暂存仓库(Staging Repositories)，需要检查通过后才能正式发布。

打开 https://s01.oss.sonatype.org/，登录sonatype账户，点击左侧的 Staging Repositories ，进入暂存库，刚刚上传的jar包就在这里，此时的构件状态为open 。

https://wp.xanderye.cn/wp-content/uploads/2021/05/image-10.png

选中刚刚发布的构件，点击上面的 Close 。开始检查文件是否齐全，在下边的Activity选项卡中查看状态。在这里我由于 POM 中没有填写 url 标签被打回过。检查完毕后，刷新页面， Release 按钮亮起。点击 Release 按钮，再点击 Confirm ，正式发布到中央仓库，成功后构件自动删除，一小段时间（约1-2个小时）后即可同步到maven的中央仓库。

发布成功之后，则可以在 https://s01.oss.sonatype.org/ 中根据Group Id查找到你发布的 jar 包信息。

https://wp.xanderye.cn/wp-content/uploads/2021/05/image-11.png

验证是否同步到中央仓库，可以在 https://search.maven.org/ 搜到即可。然后等1-2天就会同步到 https://mvnrepository.com/ 和阿里maven了。

准备工作

Sonatype 帐号

项目申请

创建工单

域名 Group Id

Github Group Id

资质审核

域名 Group Id

Github Group Id

审核通过

GPG签名

Maven 配置

setting.xml

pom.xml

打包发布

参考资料

推荐文章

发表回复取消回复

上传Jar包到Maven中央仓库

准备工作

Sonatype 帐号

项目申请

创建工单

域名 Group Id

Github Group Id

资质审核

域名 Group Id

Github Group Id

审核通过

GPG签名

Maven 配置

setting.xml

pom.xml

打包发布

参考资料

推荐文章

发表回复 取消回复

发表回复取消回复