发布java工具包到 maven 中央仓库，不踩坑

说明

要想将自己的java工具提交到maven中央仓库并公开，但是maven中央仓库是不允许我们直接上传jar包到它上面的，因此我们只能将jar包发布到它指定的第三方maven仓库，然后这个仓库再将jar包同步到中央仓库。而sonatype的OSSRH仓库就是被认可的第三方仓库之一，所以我们选择把jar包先发布到这上面来。

1、注册

注册sonatype的账号，注册地址：https://issues.sonatype.org/secure/Signup!default.jspa

注册比较简单，填一下邮箱、姓名、用户名和密码后，点击sign up就完成了。

2、提交issue

登录完成后，语言可以选择中文，在system dashboard页面中，点击上方导航栏上的新建按钮，就可以创建一个issue，我看也有地方把这个issue称为工单。

要填的东西有点多，我们分两页看，先看第一页：

填写完后，点击新建即可（我这里由于是已经提交了的，所以是更新按钮）

3、 等待几分钟后，就会收到OSSRH的回复，如下图

如果是自己的域名，则需要在域名解析中增加 TXT的解析，如下图：

如果是io.github.mose-x 这种git域名的，则需要新建创建完整的公开的git仓库，如下两个图（网上找的）


之后就是等待回复了，回复结果如下，则表示可以推送你的java工具了

4、 GPG密匙处理
接下来，我们需要使用gpg生成秘钥，在后续包发布jar时会根据生成的秘钥进行校验，因为sonatype也需要对上传这一行为进行权健的校验，避免无意义或恶意上传文件的行为。

a、安装gpg

官网下载地址：https://www.gnupg.org/download/

window版下载地址：https://files.gpg4win.org/gpg4win-4.0.4.exe

我在下载了window版的安装文件后，一路无脑点击下一步就可以完成安装了。

b、创建秘钥

在安装完成gpg后，在命令行下通过指令来生成一个秘钥：
gpg --gen-key
在生成的过程中，首先会要求输入姓名和邮箱地址，在命令行窗口下填完这两个信息后，还会弹窗要求输入一个密码：

这个密码非常重要，一定要记住，后面在项目deploy的时候还会用到。填完后继续，秘钥就会成功生成并保存在本地目录下了：

c、上传秘钥

在秘钥生成完后，我们需要把公钥上传到公共服务器供sonatype验证，可以通过下面的命令将公钥上传：
gpg --keyserver hkp://keyserver.ubuntu.com:11371 --send-keys XXXXX

虽然我这里一次就上传成功了，但是在看其他教程的过程中，也可能会出现失败的情况，这种情况可以尝试上传到其他的存放公钥的服务器：
● pool.sks-keyservers.ne
● keys.openpgp.org
● pgp.mit.edu

端口的话都是11371，这些公钥服务器间会同步它们的数据给其他服务器，所以只要上传成功到其中一台就行。

5、 maven设置
maven 设置

接下来需要修改本地maven的配置，为了保险起见，我建议大家最好同时修改.m2和conf目录下的配置文件，否则有可能出现一些奇怪的问题。

a、server

首先在配置文件中添加一个server节点，配置sonatype的用户名及密码：

<servers>
    <server>
        <id>ossrh</id>
        <username>${sonatype username}</username>
        <password>${sonatype password}</password>
    </server>
</servers>

b、profile

接着添加一个profie节点，配置gpg信息，这里就需要填入在生成gpg秘钥过程中，我们在弹窗中输入的密码了：

<profiles>
    <profile>
        <id>ossrh</id>
        <properties>
            <gpg.executable>gpg</gpg.executable>
            <gpg.passphrase>${弹窗输入的那个密码}</gpg.passphrase>
        </properties>
    </profile>
</profiles>
<activeProfiles>
    <activeProfile>ossrh</activeProfile>
</activeProfiles>

在修改完成后，可以在命令行窗口下，通过命令查看我们修改过的配置是否已经生效了：

mvn help:effective-settings

如果显示的内容和配置文件中的一样，那么恭喜，后面就只还剩下亿点点工作了。

6、 项目pom修改

在maven环境修改完成后，我们还需要对项目的pom文件进行一些修改。

a、基础信息

如果我们之前的代码中，groupId和sonatype上注册的不一致，那么需要修改项目的groupId改为一致。既然都要发布了，顺便也把version改为release版本吧。

<groupId>io.github.trunks2008</groupId>
<artifactId>ulquiorra-cache</artifactId>
<version>0.0.1-RELEASE</version>

b、distributionManagement
添加distributionManagement信息，声明要打包到sonatype的maven仓库中去。

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

c、plugins

这里需要添加各种plugin插件，除了常用的maven-compiler和maven-deploy插件外，还需要下面几个关键插件：
● nexus-staging-maven-plugin：sonatype插件，用来将项目发布到中央仓库使用
● maven-source-plugin：生成java source.jar文件
● maven-javadoc-plugin：生成java doc文档
● maven-gpg-plugin：对文件进行自动签名

使用到的全部插件详细配置如下，直接拷到项目中就可以使用：

<plugins>
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.8.1</version>
        <configuration>
            <source>${java.version}</source>
            <target>${java.version}</target>
            <encoding>UTF-8</encoding>
        </configuration>
    </plugin>
    <!-- sonatype插件，发布使用-->
    <plugin>
        <groupId>org.sonatype.plugins</groupId>
        <artifactId>nexus-staging-maven-plugin</artifactId>
        <version>1.6.7</version>
        <extensions>true</extensions>
        <configuration>
            <serverId>ossrh</serverId>
            <nexusUrl>https://s01.oss.sonatype.org/</nexusUrl>
            <autoReleaseAfterClose>true</autoReleaseAfterClose>
        </configuration>
    </plugin>

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

    <!-- 生成java doc文档 -->
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>2.9.1</version>
        <configuration>
            <show>private</show>
            <nohelp>true</nohelp>
            <charset>UTF-8</charset>
            <encoding>UTF-8</encoding>
            <docencoding>UTF-8</docencoding>
            <additionalparam>-Xdoclint:none</additionalparam>
        </configuration>
        <executions>
            <execution>
                <phase>package</phase>
                <goals>
                    <goal>jar</goal>
                </goals>
            </execution>
        </executions>
    </plugin>

    <!-- 工程文件自动签名-->
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-gpg-plugin</artifactId>
        <version>1.5</version>
        <executions>
            <execution>
                <id>sign-artifacts</id>
                <phase>verify</phase>
                <goals>
                    <goal>sign</goal>
                </goals>
            </execution>
        </executions>
    </plugin>

    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-deploy-plugin</artifactId>
        <version>2.8.2</version>
    </plugin>
</plugins>

至于在idea中，插件经常下载失败报红线的问题，个人测试可以先把它们加到dependencies中拉取下来，成功率能高不少…

d、开源签名证书

添加license信息，使用Apache Licene 2.0 协议就行。

<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>

e、仓库信息

在这里填写一下项目的地址，把我们的github仓库地址贴上去就可以了。

<scm>
    <url>
        https://github.com/mose-x/query-dsl-plus
    </url>
    <connection>
        scm:git@github.com/mose-x/query-dsl-plus.git
    </connection>
    <developerConnection>
        scm:git@github.com/mose-x/query-dsl-plus.git
    </developerConnection>
</scm>

f、开发人员信息

补充开发者的个人信息，虽然估计也没什么人会联系我就是了。

<developers>
    <developer>
        <name>mose-x</name>
        <email>mose-x@qq.com</email>
        <organization>https://github.com/mose-x</organization>
        <timezone>+8</timezone>
    </developer>
</developers>

g. 补充额外信息

<name>query-dsl-plus</name>
<description>a tool about bilayer cache</description>
<url>https://github.com/mose-x/query-dsl-plus</url>

h. 打包发布
java程序中执行 clean deploy

mvn clean deploy -DskipTests 
  -Dmaven.wagon.http.ssl.insecure=true 
  -Dmaven.wagon.http.ssl.allowall=true

出现如下，即成功

并且在OSSRH中也能收到反馈

结果：

然后就是等待了！

---

账号密码和上面注册的ossrh一致
https://s01.oss.sonatype.org

一般30分钟后能查看
https://repo1.maven.org/maven2/

一般4小时后能查看
https://search.maven.org/

一般24小时后能查看
https://mvnrepository.com/