发布了一个jar包到中央仓库，我的心好累…

哈喽大家好啊，我是Hydra。

成都创新互联公司坚持“要么做到，要么别承诺”的工作理念，服务领域包括：成都网站制作、做网站、外贸营销网站建设、企业官网、英文网站、手机端网站、网站推广等服务，满足客户于互联网时代的芒市网站设计、移动媒体设计的需求，帮助企业找到有效的互联网解决方案。努力成为您成熟可靠的网络建设合作伙伴！

前几天我在网上冲浪的时候，看见有一个老铁在git上给我提了一个issue：

万万没想到，有一天我写的烂代码居然也会被要求提到中央仓库…

话再说回来，发布jar包到中央仓库这个事，也不是我不想，而是真的不会啊！

不过既然铁子们都开口了，我这硬着头皮也得上不是？那么从网上翻翻文档，正式开搞。

Sonatype

首先第一步，我们需要在sonatype上注册账号并提交一个issue。

sonatype这个名字，突然一说大家可能有点反应不过来，但是看完下面这张图大家应该就明白了：

没错，如果各位所在的公司有搭建自己的maven私服的话，那么一般用的就是sonatype公司开发的Nexus了。

这时候有小伙伴们估计就要问了，那么我要上传中央仓库和你sonatype又有什么关系？

这是因为sonatype提供了一个服务，英文全称是Open Source Software Repository Hosting，翻译过来可以理解为开源软件资源库托管服务，简称为OSSRH。

开发者在把自己的开源项目打成jar包后，可以免费地将jar包托管在这里，这里先记住OSSRH这个简称，后面很多地方还会用到。

并且，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称为工单。

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

项目：选择Community Support - Open Source Project Repository Hosting (OSSRH)
问题类型：选择New Project
概要：项目概要，这里填写项目名称就行，如果更严谨的话，可以说明是要新发布一个包到maven
描述：非必填项，这里简单描述了一下项目的功能

填完这些后，接着填下面的内容：

Group Id：项目的groupId。如果以com等开头的话，之后会验证你对该域名的所有权。所比较简单的做法是直接以io.github.开头，再加上你的github的用户名，所以这里我填写的是io.github.trunks2008
Project URL：项目地址，不带.git结尾
SCM url：也是项目地址，不过最后要带上.git
Username(s)：非必填项，这里是能辅助你提交项目的合作人的帐号，前提是他也在这个JIRA注册过账号
Already Synced to Central：这里选择No，如果选Yes会关闭自动同步到中央仓库

填写完成后，点新建按钮就完成了issue的提交。

3、创建临时库

创建完issue后等个几分钟，在它的活动日志区就会收到一条回复：

大意就是，如果想要继续流程的话，就按照下面两步走。

首先，先到你的github账户下面，按照它指定的名称，建这么一个临时仓库，证明你对这个github账号的所有权。于是我麻利的在github建好了这个仓库：

然后问题就来了，我们仔细看看回复中的第二步指南：

Edit this ticket and set Status to Open.

翻译过来就是，编辑这个票据并把状态设置为打开状态。

可就是这么朴实无华且枯燥的一句话，把我给难住了。在这条消息回复里，我把所有能点的地方点了一遍，也没找到这个所谓的ticket是什么东西。

当我的鼠标都要点烂了时，终于在别的老哥的提示下找到了答案，是要点击这个issue中的这个毫不起眼的Respond按钮啊！

说实话，在没有人告诉我这是个按钮之前，我一直以为这玩意就是一个破标签…

在我们把这个issue的状态切换回Open后，过个几分钟，如果没有其他问题，那么你就会收到下一条回复：

收到这条消息，就说明我们的groupId已经准备好可以使用了，并且之后可以用当前这个sonatype的账号发布snapshot和release版本的jar包到它的oss仓库中了。

接着看下面一段，根据构建配置，第一个组件可能会在成功部署(deploy)后自动发布(release)。如果发生这种情况，那么我们会收到一条消息，来确认我们的jar包被同步到了maven中央仓库。

既然人家都 congratulation 了，那咱们也开心点，到这里在sonatype上的操作就暂时告一段落了…

gpg秘钥

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

1、安装gpg

官网下载地址：

https://www.gnupg.org/download/

window版下载地址：

https://files.gpg4win.org/gpg4win-4.0.4.exe

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

2、创建秘钥

在安装完成gpg后，在命令行下通过指令来生成一个秘钥：

gpg --gen-key

在生成的过程中，首先会要求输入姓名和邮箱地址，在命令行窗口下填完这两个信息后，还会弹窗要求输入一个密码：

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

3、上传秘钥

在秘钥生成完后，我们需要把公钥上传到公共服务器供sonatype验证，可以通过下面的命令将公钥上传：

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

在公钥上传成功后，还可以通过--recv-keys来验证公钥：

虽然我这里一次就上传成功了，但是在看其他教程的过程中，也可能会出现失败的情况，这种情况可以尝试上传到其他的存放公钥的服务器：

pool.sks-keyservers.ne
keys.openpgp.org
pgp.mit.edu

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

maven 设置

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

1、server

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


    
        ossrh
        ${sonatype username}
        ${sonatype password}

2、profile

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


    
        ossrh
        
            gpg
            ${弹窗输入的那个密码}
        
    


    ossrh

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

mvn help:effective-settings

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

项目pom修改

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

1、基础信息

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

io.github.trunks2008
ulquiorra-cache
0.0.1-RELEASE

2、distributionManagement

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


    
        ossrh
        https://s01.oss.sonatype.org/content/repositories/snapshots
    
    
        ossrh
        https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/

3、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：对文件进行自动签名

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


    
        org.apache.maven.plugins
        maven-compiler-plugin
        3.8.1
        
            ${java.version}
            ${java.version}
            UTF-8
        
    

    
    
        org.sonatype.plugins
        nexus-staging-maven-plugin
        1.6.7
        true
        
            ossrh
            https://s01.oss.sonatype.org/
            true
        
    

    
    
        org.apache.maven.plugins
        maven-source-plugin
        2.2.1
        
            
                attach-sources
                
                    jar-no-fork
                
            
        
    

    
    
        org.apache.maven.plugins
        maven-javadoc-plugin
        2.9.1
        
            private
            true
            UTF-8
            UTF-8
            UTF-8
            -Xdoclint:none
        
        
            
                package
                
                    jar
                
            
        
    

    
    
        org.apache.maven.plugins
        maven-gpg-plugin
        1.5
        
            
                sign-artifacts
                verify
                
                    sign
                
            
        
    

    
        org.apache.maven.plugins
        maven-deploy-plugin
        2.8.2

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

4、开源签名证书

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


    
        The Apache Software License, Version 2.0
        http://www.apache.org/licenses/LICENSE-2.0.txt
        repo

5、仓库信息

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


    
        https://github.com/trunks2008/ulquiorra-cache
    
    
        scm:git@github.com/trunks2008/ulquiorra-cache.git
    
    
        scm:git@github.com/trunks2008/ulquiorra-cache.git

6、开发人员信息

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


    
        hydra
        765666922@qq.com
        https://github.com/trunks2008
        +8

在添加完这么多茫茫的信息后，我的pom文件成功的从70行变成了200多行……

发布

到这里所有的基本工作就都做完了，下面执行激动人心的deploy命令！

mvn clean deploy -DskipTests

命令执行结果：

果然是都到最后一步了，还是不能掉以轻心啊…

查了一下这个报错，大概就是SSL的问题，修改一下deploy命令的参数就行~

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

再次执行命令：

奇怪的错误又出现了…

这次的问题比较简单，就是项目中的pom中缺失了一些项目信息，修改pom文件，添加下面的信息：

ulquiorra-cache
a tool about bilayer cache
https://github.com/trunks2008/ulquiorra-cache

再次尝试deploy，终于成功了！

登录https://s01.oss.sonatype.org/，看一眼oss仓库，我们的jar包已经上传成功了。

你以为到这里就结束了？恰恰相反，更加漫长的等待才刚刚开始…

漫长的等待

在项目deploy成功后，回到sonatype，活动日志区很快就会收到一条新消息：

大意就是sonatype到中央仓库的同步是激活的，当我们成功发布组件后，通常30分钟左右就可以在 https://repo1.maven.org/maven2/上访问到了，但是更新到https://search.maven.org/可能需要4个小时。

按照这个提示，等半个小时再访问repo1.maven.org，经过一路搜索最后可以找到：

过四个小时再访问search.maven.org，果然在上面也可以查找到我的jar包了，sonatype诚不我欺…

讲道理的话，既然发布成功了，那我们就可以在项目中按照这个maven坐标拉取到jar包了，但是在项目中就是死活拉不下来…

于是我灵机一动，改为使用gradle：

dependencies {
    implementation("io.github.trunks2008:ulquiorra-cache:0.0.1-RELEASE")
}

你别说，居然真的成功了…

不过话说回来，在日常工作中，我还是更习惯用https://mvnrepository.com来查找maven依赖，至于什么时候能在上面搜到，我实测了一下，这个周期真是长的可怕。

在14号就上传jar包成功后，直到17号才能在mvnrepository上查找到…

最后

那么，这次不那么顺利的踩坑之旅到这里就基本上结束了，总的来说，发布jar包到中央仓库真是个体力活。

在实际操作的过程中，有着数不完的坑，动不动一个点就可能卡住好几个小时，即便成功发布了，后续还有漫长的等待时间，总之就是非常心累…

对于那位在git上给我提issue的兄弟，我只有一句话想说…

本文在sonatype上提交的issue，以及提交的项目git地址我都放在下面了，大家如果有需求的话，可以参考一下~

sonatype的issue地址：https://issues.sonatype.org/browse/OSSRH-86180

项目的github地址：https://github.com/trunks2008/ulquiorra-cache

官方文档指南：https://central.sonatype.org/publish/publish-maven/

标题名称：发布了一个jar包到中央仓库，我的心好累…
标题路径：http://www.hantingmc.com/qtweb/news35/132885.html

网站建设、网络推广公司-创新互联，是专注品牌与效果的网站制作，网络营销seo公司；服务项目有等

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源：创新互联

猜你还喜欢下面的内容