Maven 发布自己的项目到 Maven 中央仓库

可能很多人都在用 Maven 仓库,但是如果要问怎么发布项目到中央仓库,估计很多人都不知道了,下面本篇文章带大家往中央仓库发布一个自己的 Maven 项目。

大致步骤

  1. 在 Sonatype 提出 Issue 申请
  • 项目类型是 Community Support - Open Source Project Repository Hosting
  • groupId 对应的域名你需要有所有权
  • 等待 Issue 审批通过。
  1. 使用 GPG 生成密钥对。下载地址:https://www.gnupg.org/download/。用得到的指令有如下几条:
  • gpg --version 检查安装成功没
  • gpg --gen-key 生成密钥对
  • gpg --list-keys 查看公钥
  • gpg --keyserver hkp://pool.sks-keyservers.net --send-keys 公钥ID 将公钥发布到 PGP 密钥服务器
  • gpg --keyserver hkp://pool.sks-keyservers.net --recv-keys 公钥ID 查询公钥是否发布成功
  1. 配置 Maven。需要修改的 Maven 配置文件包括:setting.xml(全局级别)与 pom.xml(项目级别)
  • setting.xml:在其中加入 server 信息,包含 Sonatype 账号的用户名与密码
  • pom.xml:在其中配置 profile,包括插件和 distributionManagement。snapshotRepository 与 repository 中的 id 一定要与 setting.xml 中 server 的 id 保持一致。
  1. 上传构件到 OSS 中并发布。
  • 上传构件。mvn clean deploy -P release
  • 在 OSS 中发布构件。进入 https://oss.sonatype.org/,点击"Staging Repositories" -> 在搜索栏输入你的 groupId -> 勾选你的构件并点击 close -> 点击 tab 栏的 release。
  • 通知 Sonatype 构件已成功发布,关闭 Issue。
  1. 后续更新

1. 在 Sonatype 提出 Issue 申请

1.1 注册 Sonatype 用户

注册地址:https://issues.sonatype.org/secure/Signup!default.jspa

使用了 Jira 来管理流程,记住用户名和密码,后面会用到。

1.2 创建一个发布项目的 Issue

地址:https://issues.sonatype.org/secure/CreateIssue.jspa?issuetype=21&pid=10134

maven 配置国内中央仓库 maven发布到中央仓库_maven

这里需要特别说明的是 Group Id,如果你是托管在 Github 或者 Git@OSC 可以使用 com.github.binarylei 或者 net.oschina.XXX,剩下的可以依照实际情况填写,例如托管的地址等等(托管地址等信息会在用去 maven 仓库搜索的时候显示,用来帮助用户找到你的项目地址寻求帮助)。另外此处填写的 groupId 必须和你要发布的组件的 pom 中的 groupIdd 一样,必须一样!!!

1.3 等待 Issue 审批

这个审核还是很及时的,我的几分钟后就收到审核结果。如果不通过审核人员会告诉你不通过的原因,例如当你用的是自己的域名时(不是github)s审核人员会询问你域名是否是你的,回复一下就行。审核通过后会收到邮件通知,同时在 Issue 下面会看到 Sonatype 工作人员的回复,一般是添加一个 scomment,内容大致如下:

com.github.binarylei has been prepared, now user(s) binarylei can:
* Deploy snapshot artifacts into repository https://oss.sonatype.org/content/repositories/snapshots
* Deploy release artifacts into the staging repository https://oss.sonatype.org/service/local/staging/deploy/maven2
* Promote staged artifacts into repository 'Releases'
* Download snapshot and release artifacts from group https://oss.sonatype.org/content/groups/public
* Download snapshot, release and staged artifacts from staging group https://oss.sonatype.org/content/groups/staging

这个是工作人员告诉我已经通过了,可以去下面那个地址发布(前两个地址),发布后去下面后两个地址搜索。

2. 使用 GPG 生成密钥对

Windows 系统,可以下载 Gpg4win 软件来生成密钥对。下载地址:https://www.gpg4win.org/download.html

推荐使用 Gpg4win-Vanilla 版本,因为它仅包括 GnuPG,这个工具才是我们所需要的。

Linux 系统,直接从源中安装gpg软件包就行。更多GnuPG使用详情

安装 GPG 软件后,打开命令行窗口,依次做以下操作:

(1)查看是否安装成功

gpg --version

出现版本等信息说明安装成功了。

(2)生成密钥对

```
gpg --gen-key

Real name: binarylei
Email address: binarylei@qq.com
You selected this USER-ID:
    "binarylei <binarylei@qq.com>"

Change (N)ame, (E)mail, or (O)kay/(Q)uit? o
```

之后往下,会让你输入用户名和邮箱,还有一个Passphase(输入两次),相当于密钥库密码,不要忘记。

(3)查看公钥

```
gpg --list-keys

C:/Users/len/AppData/Roaming/gnupg/pubring.kbx
----------------------------------------------
pub   rsa2048 2017-12-16 [SC] [expires: 2019-12-16]
      9DF36BF5DFB87B6F04DBCE3D63EC6544BEE6682D
uid           [ultimate] binarylei <binarylei@qq.com>
sub   rsa2048 2017-12-16 [E] [expires: 2019-12-16]
```

我这里的公钥ID是9DF36BF5DFB87B6F04DBCE3D63EC6544BEE6682D,马上就会用到了。

(3)将公钥发布到 PGP 密钥服务器

gpg --keyserver hkp://pool.sks-keyservers.net --send-keys 9DF36BF5DFB87B6F04DBCE3D63EC6544BEE6682D

gpg: sending key 63EC6544BEE6682D to hkp server pool.sks-keyservers.net

此后,可使用本地的私钥来对上传构件进行数字签名,而下载该构件的用户可通过上传的公钥来验证签名,也就是说,大家可以验证这个构件是否由本人上传的,因为有可能该构件被坏人给篡改了。

(4)查询公钥是否发布成功

gpg --keyserver hkp://pool.sks-keyservers.net --recv-keys  9DF36BF5DFB87B6F04DBCE3D63EC6544BEE6682D
gpg --keyserver hkp://keyserver.ubuntu.com:11371 --send-keys 9DF36BF5DFB87B6F04DBCE3D63EC6544BEE6682D

gpg: key 63EC6544BEE6682D: "binarylei <binarylei@qq.com>" not changed
gpg: Total number processed: 1
gpg:              unchanged: 1

hkp://pool.sks-keyservers.net 不知道为什么没有发送公钥成功,但好像也不影响 jar 包最终发布到 maven 中央仓库。

3. 修改Maven配置文件

3.1 setting.xml

找到maven的全局配置文件settings.xml,在里面找到 节点,这个节点默认是注释掉的,增加如下配置:

<servers>
    <server>
        <id>oss</id>
        <username>用户名</username>
        <password>密码</password>
    </server>
</servers>

这里的 id 是要在 pom.xml 里面使用的,用户名和密码就是在 Sonatype 上面注册的用户名和密码。

3.2 pom.xml

<project>
    ...
    <name>dexcoder-assistant</name>
    <description>dexcoder-assistant is a rapid development kit.</description>
    <url>http://www.dexcoder.com/</url>
    <licenses>
        <license>
            <name>The Apache Software License, Version 2.0</name>
            <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
        </license>
    </licenses>
    <developers>
        <developer>
            <name>selfly</name>
            <email>selfly@foxmail.com</email>
        </developer>
    </developers>
    <scm>
        <connection>scm:git:git@github.com:selfly/dexcoder-assistant.git</connection>
        <developerConnection>scm:git:git@github.com:selfly/dexcoder-assistant.git</developerConnection>
        <url>git@github.com:selfly/dexcoder-assistant.git</url>
    </scm>
    
    <profiles>
        <profile>
            <id>release</id>
            <build>
                <plugins>
                    <!-- Source -->
                    <plugin>
                        <groupId>org.apache.maven.plugins</groupId>
                        <artifactId>maven-source-plugin</artifactId>
                        <version>2.2.1</version>
                        <executions>
                            <execution>
                                <phase>package</phase>
                                <goals>
                                    <goal>jar-no-fork</goal>
                                </goals>
                            </execution>
                        </executions>
                    </plugin>
                    <!-- Javadoc -->
                    <plugin>
                        <groupId>org.apache.maven.plugins</groupId>
                        <artifactId>maven-javadoc-plugin</artifactId>
                        <version>2.9.1</version>
                        <executions>
                            <execution>
                                <phase>package</phase>
                                <goals>
                                    <goal>jar</goal>
                                </goals>
                            </execution>
                        </executions>
                    </plugin>
                    <!-- GPG -->
                    <plugin>
                        <groupId>org.apache.maven.plugins</groupId>
                        <artifactId>maven-gpg-plugin</artifactId>
                        <version>1.5</version>
                        <executions>
                            <execution>
                                <phase>verify</phase>
                                <goals>
                                    <goal>sign</goal>
                                </goals>
                            </execution>
                        </executions>
                    </plugin>
                </plugins>
            </build>
            <distributionManagement>
                <snapshotRepository>
                    <id>oss</id>
                    <url>https://oss.sonatype.org/content/repositories/snapshots/</url>
                </snapshotRepository>
                <repository>
                    <id>oss</id>
                    <url>https://oss.sonatype.org/service/local/staging/deploy/maven2/</url>
                </repository>
            </distributionManagement>
        </profile>
    </profiles>
    ...
</project>

pom.xml 中必须包括:name、description、url、licenses、developers、scm 等基本信息,使用了 Maven 的 profile 功能,只有在 release 的时候,创建源码包、文档包、使用 GPG 进行数字签名。

此外,snapshotRepository 与 repository 中的 id 一定要与 setting.xml 中 server 的 id 保持一致。

如果是多模块项目的话,只需要在父 pom.xml 中声明这些,子 pom.xml 中只需要修改相应的一些信息,如 name 标签。

4. 发布到 OSS nexus 仓库中

4.1 上传到 OSS

mvn clean deploy -P release

当执行以上 Maven 命令时,会自动弹出一个对话框,需要输入上面提到的 Passphase,它就是刚才设置的 GPG 密钥库的密码。

随后会看到大量的 upload 信息,因为在国内网络的缘故,时间有点久,耐心等待吧。

注意:此时上传的构件并未正式发布到中央仓库中,只是部署到 OSS 中了,下面才是真正的发布。

4.2 在 OSS 中发布构件

使用 Sonatype 账号登录 https://oss.sonatype.org/#stagingRepositories,可在 Staging Repositories 中查看刚才已上传的构件。
一般发布的构件不多,可以直接拉到底就能看到自己的构件,也可进行模糊查询定位到自己的构件(见后边附图)。

maven 配置国内中央仓库 maven发布到中央仓库_xml_02

最后,点击 Release 按钮来发布该构件。手动刷新后看到已经发布。

maven 配置国内中央仓库 maven发布到中央仓库_上传_03

4.3. 通知 Sonatype 构件已成功发布

4.3.1 在之前的在Issue下面回复

在 Issue 下面回复一条“构件已成功发布”的评论,这是为了通知 Sonatype 的工作人员为需要发布的构件做审批,发布后会关闭该 Issue。

这个前面的 Sonatype 工作人员其实在审核你的 Issue 时,在 comment 中已经提示你了,

在 Issue 下面回复一条“构件已成功发布”的评论,这是为了通知 Sonatype 的工作人员为需要发布的构件做审批,发布后会关闭该 Issue。

4.3.2 等待构件审批通过

这个,又只能等待了,当然他们晚上上班,还是第二天看。当审批通过后,将会收到邮件通知。

4.3.3 从中央仓库中搜索构件

这时,就可以在 maven 的中央仓库中搜索到自己发布的构件了,以后可以直接在 pom.xml 中使用了!

中央仓库搜索网站:http://search.maven.org/

第一次成功发布之后,以后就不用这么麻烦了,可以直接使用 groupId 发布任何的构件,当然前提是 groupId 没有变。

5. 以后的发布流程

a)构件完成后直接使用 maven 在命令行上传构建;

b)在 https://oss.sonatype.org/ close 并 release 构件;

c) 等待同步好(大约2小时多)之后,就可以使用了

参考:

  1. 将项目发布到 Maven 中央仓库踩过的坑
  2. 将 Smart 构件发布到 Maven 中央仓库