我把自己的java库发布到了maven中央仓库，从此可以像Jackson、Spring的jar一样使用它了

欢迎访问我的GitHub

https://github.com/zq2599/blog_demos

内容：所有原创文章分类汇总及配套源码，涉及Java、Docker、Kubernetes、DevOPS等；

关于maven中央仓库

作为一个java程序员，对maven中央仓库https://mvnrepository.com/自然是非常熟悉的，毕竟咱们的应用依赖的jar大部分都来自此处，如果您想把自己开发的java库也托管在上面，让大家像使用Jackson、Spring那样轻松简单的使用您的jar，就请随本文一起操作吧；
先看看效果，下图是我发布的java库在中央仓库的搜索结果：

前提条件

由于sonatype官方会要求您在github创建一个仓库（仓库名由sonatype官方指定，以此验证您是否有github操作权限），因此请确保您自己有github账号，并且可以创建仓库

本篇概览

梳理一下，按照以下步骤将自己的java库发布到maven中央仓库：

文末还会对曾经踩过的小坑做了总结，希望能帮助读者们提前避开
看起来略有些繁琐，但其实很简单，接下来开始吧

准备工作

首先请把您的java工程准备好，我用的是一个非常普通的maven工程，名为opencv-linux，github仓库地址https://github.com/zq2599/ope...
本次涉及的软件信息如下：
操作系统：macOS Monterey(12.0.1)
JDK：1.8.0_312
Maven：3.8.3

1. 注册帐号

打开网站https://issues.sonatype.org，注册一个帐号，登录后效果如下图：

2. 创建问题(issue)

点击上图红框中的新建开始创建issue，如下图，项目选择Community Support，问题类型是New Project：

接下来填写项目相关的信息，请注意Project URL里面是您自己的工程对应的github仓库地址：

提交后等待几分钟，注册账号时填写的邮箱会收到一封邮件，要求你创建一个仓库，以此来证明之前提交的github帐号属于你自己：

上述内容在刚才新建的issue页面也能看到，如下图，即sonatype的评论：

3. 创建sonatype指定的仓库

登录您的github，按照要求创建仓库，我这里要创建的是https://github.com/zq2599/OSS...
老老实实的创建出来就行了：

4. 在issue上进行回复

打开issuse，增加一个评论，如下图：

不久后（我这边是十多分钟），就会收到一条新的评论，通知你可以去做发布了，并给你了snapshot和release的发布地址：

5. 安装GPG

后面的操作中，在将jar发布到中央仓库时，要用GPG工具对上传的数据进行签名，因此接下来要准备好GPG秘钥
先安装GPG软件，打开网站：https://www.gnupg.org/download/
下载安装文件，请选择适合您的操作系统的，我的选择如下图红框：

安装GPG

6. 生成秘钥并上传

安装完成后，在控制台执行gpg2 --gen-key开始创建秘钥
根据提示输入账号、邮箱、密码等：

GnuPG needs to construct a user ID to identify your key.

Real name: zq2599
Email address: [email protected]
You selected this USER-ID:
    "zq2599 "

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

操作完成后得到如下信息：

gpg: key 11027EJIHGFEDCBA marked as ultimately trusted
gpg: directory '/Users/will/.gnupg/openpgp-revocs.d' created
gpg: revocation certificate stored as '/Users/will/.gnupg/openpgp-revocs.d/561AEE4EA92EE3E4C389941811027E9876543210.rev'
public and secret key created and signed.

pub   rsa3072 2021-11-10 [SC] [expires: 2023-11-10]
      561AEE4EA92EE3E4C389941811027E9876543210
uid                      zq2599 
sub   rsa3072 2021-11-10 [E] [expires: 2023-11-10]

如上所示，得到了pub key等于561AEE4EA92EE3E4C389941811027E9876543210
执行以下命令，将秘钥同步到云端，注意keyserver，网上可以搜到很多个，个人实际操作中，下面这个是可以成功的：

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

7. maven全局配置

试想把sonatype的账号密码写在项目的pom.xml中，再上传到github让所有人都看到？相信您一定不愿意这样，所以还是放在maven的全局配置中比较安全，毕竟是保存在自己的电脑上
打开maven的配置文件settings.xml，在servers下面增加一个server节点，这是个账号密码的配置，对应的是https://issues.sonatype.org的账号密码：


    ossrh
    zq2599
    12345678

在profiles下增加一个profile节点，gpg.passphrase的内容是刚才创建gpg秘钥时输入的密码：


    gpg
    
    
    gpg2
        abcdefgh

涉及到账号密码的全局配置就完成了，接下来打开您的java工程，咱们去修改pom.xml的配置

8. maven项目配置

首先要搞清楚发布仓库的地址在哪，官方指导如下，给出了snapshot和release的仓库地址：

以下是java工程的pom.xml文件，需重点关注的地方都有中文注释，请不要漏掉带序号的注释，这些都是最关键的配置，这种注释共11个：



    4.0.0
    io.github.zq2599
    opencv-linux
    0.0.3
    opencv-linux
    opencv-linux
    
    https://github.com/zq2599/opencv-client
    
        1.8
    
    jar

    
    
        
            The Apache Software License, Version 2.0
            http://www.apache.org/licenses/LICENSE-2.0.txt
            repo
        
    
    
    
        scm:git:[email protected]:zq2599/opencv-client.git
        scm:git:[email protected]:zq2599/opencv-client.git
        https://github.com/zq2599/opencv-client/tree/main
    
    
    
        
            zq2599
            [email protected]
            https://github.com/zq2599
            +8
        
    
    
    
        
            ossrh
            https://s01.oss.sonatype.org/content/repositories/snapshots
        
        
            ossrh
            https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/
        
    

    
        
            org.projectlombok
            lombok
            1.16.18
        
    

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

                
                
                    org.apache.maven.plugins
                    maven-source-plugin
                    3.1.0
                    true
                    
                        
                            attach-sources
                            
                                jar
                            
                        
                    
                    
                        true
                        true
                    
                

                
                
                    org.apache.maven.plugins
                    maven-javadoc-plugin
                    3.0.0
                    true
                    
                        
                            bundle-sources
                            package
                            
                                jar
                            
                        
                    
                    
                        1024
                        UTF-8
                        protected
                        true

                        
                        false
                        none
                    
                

                
                
                    org.apache.maven.plugins
                    maven-compiler-plugin
                    
                        1.8
                        1.8
                        UTF-8
                    
                
            
        

        
        
            
                org.sonatype.plugins
                nexus-staging-maven-plugin
            
            
            
                org.apache.maven.plugins
                maven-source-plugin
            

            
                org.apache.maven.plugins
                maven-compiler-plugin
            
        
    

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

9. 编译、构建、上传

编译构建上传其实很简单，下面一行命令搞定(进入pom.xml所在目录下执行以下命令)：

mvn clean javadoc:jar deploy -P release

构建期间会弹出窗口让你输入密码，请输入创建GPG秘钥时设置的密码：

构建和上传成功后，控制台输出如下（截选）：

...
[INFO] Installing /Users/zhaoqin/github/blog_demos/opencv-linux/target/opencv-linux-0.0.3-sources.jar.asc to /Users/zhaoqin/github/blog_demos/opencv-linux/target/nexus-staging/staging/543da2cd9af848/io/github/zq2599/opencv-linux/0.0.3/opencv-linux-0.0.3-sources.jar.asc
[INFO] Performing remote staging...
[INFO] 
[INFO]  * Remote staging into staging profile ID "543da2cd9abc12"
[INFO]  * Created staging repository with ID "iogithubzq2599-1008".
[INFO]  * Staging repository at https://s01.oss.sonatype.org:443/service/local/staging/deployByRepositoryId/iogithubzq2599-1008
[INFO]  * Uploading locally staged artifacts to profile io.github.zq2599
Uploading to ossrh: 
...
https://s01.oss.sonatype.org:443/service/local/staging/deployByRepositoryId/iogithubzq2599-1008/io/github/zq2599/opencv-linux/0.0.3/opencv-linux-0.0.3-sources.jar.asc (659 B at 1.2 kB/s)
[INFO]  * Upload of locally staged artifacts finished.
[INFO]  * Closing staging repository with ID "iogithubzq2599-1008".

Waiting for operation to complete...
...
[INFO] Remote staged 1 repositories, finished with success.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  27.199 s
[INFO] Finished at: 2021-11-12T08:08:37+08:00

记住上述信息中展示的iogithubzq2599-1008，这是本次上传操作在仓库中对应的ID

10. 登录指定的仓库网址

接下来登录Nexus网站，具体的网址一定要看issue的评论，如下图红框，我这里要登录的是：https://s01.oss.sonatype.org

点击下图右上角红框登录，账号密码是在https://issues.sonatype.org注册的那个：

11. 发布

登录成功后，点击下图红框中的Staging Repositories：

如下图，找到合适的记录（我这里是iogithubzq2599-1008），点击红框3中的Release进行发布，如果状态不是closed，就要展开底部的Activity查看发生了什么异常：

操作成功，如下图所示：

12. issue收到评论，提示完成时间

静候十多分钟，issue上收到一条评论，提示同步操作已激活，三十分钟内同步到https://repo1.maven.org/，四小时内同步到https://search.maven.org：

网上有文章提到第一次发布要在issuse上评论，才会触发同步操作，我这里没有遇到（正打算评论呢，发现已经开始同步了）

13. 三十分钟内同步到https://repo1.maven.org

静候三十分钟，可以在网站https://repo1.maven.org上看到上传的工程相关文件了，如下图：

14. 四小时内同步到https://search.maven.org

静候四小时，可以在网站https://search.maven.org上看到上传的工程相关文件了，如下图：

15. 二十四小时内同步到https://mvnrepository.com/

同步到https://mvnrepository.com的时间并不是精确的二十四小时，而是我时隔二十四左右在此网站上可以搜索到自己的库：

至此，自己的java库已成功发布到maven中央仓库，可以像Jackson、Spring库那样使用这个库了，用法就是添加这个依赖：


    io.github.zq2599
    opencv-linux
    0.0.3

踩坑记录

现在已完成了所有的操作，回顾一下，整个过程其实相对比较顺利，只遇到了三个小坑需要您注意：
同步gpg秘钥到云端的时候，网上有文章提到用hkp://subkeys.pgp.net，我在使用该地址的时候一直在报错，改为hkp://keyserver.ubuntu.com:11371之后上传成功
maven工程的pom.xml文件中，一定要有url节点，如下图，否则会在同步到云端的时候报错Project url missing

发布的操作是在网页上进行的，网上有的文章提到网站是https://oss.sonatype.org，最初我也打开了该网页并尝试登录，可惜始终登录失败，最终，在issue的评论上发现如下图红框，要登录的网站是https://s01.oss.sonatype.org

至此，所有操作都已完成，如果您正在将自己的java库发布到maven中央仓库，希望本文能给您一些参考

欢迎关注公众号：程序员欣宸

微信搜索「程序员欣宸」，我是欣宸，期待与您一同畅游Java世界...
https://github.com/zq2599/blog_demos

我把自己的java库发布到了maven中央仓库，从此可以像Jackson、Spring的jar一样使用它了

欢迎访问我的GitHub

关于maven中央仓库

前提条件

本篇概览

准备工作

1. 注册帐号

2. 创建问题(issue)

3. 创建sonatype指定的仓库

4. 在issue上进行回复

5. 安装GPG

6. 生成秘钥并上传

7. maven全局配置

8. maven项目配置

9. 编译、构建、上传

10. 登录指定的仓库网址

11. 发布

12. issue收到评论，提示完成时间

13. 三十分钟内同步到https://repo1.maven.org

14. 四小时内同步到https://search.maven.org

15. 二十四小时内同步到https://mvnrepository.com/

踩坑记录

欢迎关注公众号：程序员欣宸

你可能感兴趣的:(云计算)