这篇文章教会你把我的开发的jar包发布到maven中央仓库

做者：小傅哥
博客：https://bugstack.cn - 原创系列专题案例

沉淀、分享、成长，让本身和他人都能有所收获！😄

前言介绍

(19年12月)最近想基于Spring Boot作个开源共享项目，开发一个分布式任务DcsSchedule中间件能够把Schedule加强。那么遇到一个问题但愿把Jar包发包到Maven中央仓库，这样须要使用的用户就能够直接引入。

发布准备

	内容	备注
1	申请Github账号: https://github.com	用于上传开源代码：https://github.com/fuzhengwei...
2	GPG生成密钥工具: https://gpg4win.org/download....	在后续流程中下载安装生成密钥并上传置服务器，本文使用的服务器是：hkp://keyserver.ubuntu.com:80
3	工单系统: https://issues.sonatype.org	负责申请上传资格及完成第一次上传，后续更新不须要使用，至关于一个启动装置
4	构件仓库: https://oss.sonatype.org	上传的jar包会先存放到这里，在这里进行 Release 后便可发布到maven中央仓库，也能够本地设置自动发布
5	镜像仓库: http://search.maven.org	最终成功发布的jar能够在这里搜到
6	Maven仓库：https://mvnrepository.com	通过几个小时耐心的等待会在Maven仓库中搜到
7	阿里云仓库：https://maven.aliyun.com	阿里云的仓库会同步的快一些
8	我的域名：https://bugstack.cn	这里主要用于工单资格验证(Add a TXT record to your DNS referencing this JIRA ticket: OSSRH-53637 (Fastest))

跟着节奏

1. 下载安装Gpg生成密钥

咱们须要一个GPG环境，用来对上传的文件进行加密和签名，保证你的jar包不被篡改

1991年，程序员Phil Zimmermann为了避开政府监视，开发了加密软件PGP。这个软件很是好用，迅速流传开来，成了许多程序员的必备工具。可是，它是商业软件，不能自由使用。因此，自由软件基金会决定，开发一个PGP的替代品，取名为GnuPG。这就是GPG的由来。

1. 下载地址：https://gpg4win.org/download.html
2. 下载完成后直接安装便可，比较傻瓜式安装很简单，记得选中文(若是你英文硬也能够不选)

3. 生成密钥(可使用命令行生成，也能够直接在操做界面生成)

   1. 文件>新建密钥对(Ctrl+N) -- 建立我的 OpenPGP 密钥对

1. 填写我的信息姓名和邮箱 并点击到 新建

1. 填写密钥密码

1. 将公钥上传到目录服务{若是上传失败，则经过：设置(S)->配置Kleopatra(C)，修改 OpenPGP密钥服务器为：hkp://keyserver.ubuntu.com:80}

2. 工单系统账号注册issues.sonatype

1. 注册地址：https://issues.sonatype.org/s...

2. 建立工单

• 项目：Community Support - Open Source Project Repository Hosting
• 概要：发布Jar的名称
• 描述：非必填，最好描述清晰
• Group Id：org.itatack.middleware & 和你的域名有关系，由于后续须要使用域名验证
• Project URL：Github项目站点(https://github.com/fuzhengwei...
• SCM url：源码仓库(https://github.com/fuzhengwei...

3. 配合人工审核

1. 当建立完工单后，会收到信息反馈(国外与咱们有时间差，半夜的时候他们审核的更快)；

   ```java
   Do you own the domain itstack.org? If so, please verify ownership via one of the following methods:
   
   Add a TXT record to your DNS referencing this JIRA ticket: OSSRH-53637 (Fastest)
   Setup a redirect to your Github page (if it does not already exist)
   If you do not own this domain, please read:
   http://central.sonatype.org/pages/choosing-your-coordinates.html
   You may also choose a groupId that reflects your project hosting, in this case, something like io.github.fuzhengwei or com.github.fuzhengwei
   
   Would you like to use a free managed security reporting service (recommended)?
   Put https://hackerone.com/central-security-project/reports/new as your project's security issue reporting URL. We'll take care of the rest.
   For more details on the Central Security Project, visit https://www.sonatype.com/central-security-project
   ```
   ![](https://imgconvert.csdnimg.cn/aHR0cHM6Ly91c2VyLWdvbGQtY2RuLnhpdHUuaW8vMjAxOS8xMi83LzE2ZWRmMGI3ZmZjYTAzZWM?x-oss-process=image/format,png)

2. 配置域名验证签名；TXT 指向问题域：https://issues.sonatype.org/b...

   ![](https://imgconvert.csdnimg.cn/aHR0cHM6Ly91c2VyLWdvbGQtY2RuLnhpdHUuaW8vMjAxOS8xMi83LzE2ZWRmMGI3ODc5YjIzNGQ?x-oss-process=image/format,png)

3. 在域名验证截图，回复到问题下，人工审核会进行验证处理

   ![](https://imgconvert.csdnimg.cn/aHR0cHM6Ly91c2VyLWdvbGQtY2RuLnhpdHUuaW8vMjAxOS8xMi83LzE2ZWRmMGI4MGI0NTFjOWU?x-oss-process=image/format,png)

4. 验证成功后，会收到邮件回复，也能够在issues看到｛意思就说去发布你的Jar吧宝贝，发布完告诉我一下(来这里回复下，我就让你用了)｝

   org.itstack.middleware has been prepared, now user(s) fuzhengwei 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
    * Release staged artifacts into repository 'Releases'

please comment on this ticket when you promoted your first release, thanks
   ```

1. 接下来等待发布Jar包成功后，到这里回复并收到反馈，以下(证实你成功了！)；

   Central sync is activated for org.itstack.middleware. After you successfully release, your component will be published to Central, typically within 10 minutes, though updates to search.maven.org can take up to two hours.

   

3. 配置Maven Settings.xml

1. Maven Settings.xml 配置，在servers中添加；

<server>
    <id>sonatype-nexus-snapshots</id>
    <username>https://issues.sonatype.org的帐号</username>
    <password>https://issues.sonatype.org的密码</password>
</server>
<server>
    <id>sonatype-nexus-staging</id>
    <username>https://issues.sonatype.org的帐号</username>
    <password>https://issues.sonatype.org的密码</password>
</server>
<server>
    <id>ossrh</id>
    <username>https://issues.sonatype.org的帐号</username>
    <password>https://issues.sonatype.org的密码</password>
</server>

2. 为了更快的加载Jar，在mirrors中配置了阿里云仓库；

<mirror>
  <id>alimavenrepository</id>
  <name>aliyun maven repository</name>
  <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
  <mirrorOf>central</mirrorOf>        
</mirror>

3. 密钥配置，在profile中添加ossrh

<profile>
    <id>ossrh</id>
    <activation>
        <activeByDefault>true</activeByDefault>
    </activation>
    <properties>
        <gpg.executable>D:/Program Files (x86)/GnuPG/bin/gpg.exe</gpg.executable>
        <gpg.passphrase>上面生成的密钥密码：bugstack.cn</gpg.passphrase>
        <gpg.homedir>{找到dir：cmd->gpg --list-key}C:/Users/fuzhengwei/AppData/Roaming/gnupg</gpg.homedir>
    </properties>
</profile>

4. 配置POM文件

1. 在pom文件里添加scm、licenses、developers、distributionManagement

<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://github.com/fuzhengwei/schedule-spring-boot-starter</url>
    <connection>https://github.com/fuzhengwei/schedule-spring-boot-starter.git</connection>
    <developerConnection>https://github.com/fuzhengwei/schedule-spring-boot-starter</developerConnection>
</scm>

<developers>
    <developer>
        <name>fuzhengwei</name>
        <email>184172133@qq.com</email>
        <url>https://github.com/fuzhengwei/schedule-spring-boot-starter</url>
    </developer>
</developers>

<distributionManagement>
    <snapshotRepository>
        <id>ossrh</id>
        <url>https://oss.sonatype.org/content/repositories/snapshots</url>
    </snapshotRepository>
</distributionManagement>

2. 配置编译发布信息build，gpg相关插件

• maven-source-plugin 用来生成Source Jar文件
• maven-javadoc-plugin 用来生成 javadoc 文档
• maven-gpg-plugin 用来对工程文件进行自动签名
• nexus-staging-maven-plugin 用来将工程发布到中央仓库，另外注意生成javadoc文档时须要指定关闭doclint，否则可能由于使用了不规范的javadoc注解而致使失败，完整配置以下

<!-- 发布Jar到Maven仓库 Begin -->
<!--生成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>
<!--生成Javadoc，关闭doclint,避免注解检查不经过-->
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.9.1</version>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <goals>
                <goal>jar</goal>
            </goals>
            <configuration>
                <additionalparam>-Xdoclint:none</additionalparam>
            </configuration>
        </execution>
    </executions>
</plugin>
<!--Maven GPG插件用于使用如下配置对组件进行签名-->
<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>
<!--Nexus Staging Maven插件是将组件部署到OSSRH并将其发布到Central Repository的推荐方法-->
<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://oss.sonatype.org/</nexusUrl>
        <autoReleaseAfterClose>true</autoReleaseAfterClose>
    </configuration>
</plugin>
<!-- release plugin,用于发布到release仓库部署插件 -->
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-release-plugin</artifactId>
    <version>2.4.2</version>
</plugin>
<!-- 发布Jar到Maven仓库 End -->

4. 执行发布；Idea Maven -> Lifecycle -> Deploy

1. 接下来开发发布Jar包，中间会提示输入密钥生成时候的密码
2. https://oss.sonatype.org 查看发布内容
   

3. 到上面"配合人工审核",按照说明提交发布成功信息，验证成功后会收到回复，以下；

   Central sync is activated for org.itstack.middleware. After you successfully release, your component will be published to Central, typically within 10 minutes, though updates to search.maven.org can take up to two hours.

4. https://search.maven.org 搜索版本信息
   
5. https://maven.aliyun.com 阿里云仓库同步较快，能够查看
   

综上总结

• 总体流程仍是很长的，若是第一次尝试去弄，嗯，你可能有一个不眠夜
• 中间可能会遇到各类异常错误，包括密钥、打包、发版等等，注意仔细阅读本文细节以及本身屡次尝试，总归是会成功的
• 比较常识性的问题；同一个RELEASE版本只能上传一次不然会失败、老外真的是半夜回复比较快由于我们半夜他们正好天亮了

推荐阅读

• 1. 重学 Java 设计模式：实战工厂方法模式(多种类型商品发奖场景)
• 2. 重学 Java 设计模式：实战建造者模式(装修物料组合套餐选配场景)
• 3. 重学 Java 设计模式：实战原型模式(多套试每人题目和答案乱序场景)
• 4. 重学 Java 设计模式：实战桥接模式(多支付渠道「微信支付宝」与多支付模式「刷脸、指纹」场景)
• 5. 重学 Java 设计模式：实战组合模式(营销差别化人群发券决策树引擎搭建场景)
• 6. 重学 Java 设计模式：实战外观模式「基于SpringBoot开发门面模式中间件，统一控制接口白名单场景」