我把自己的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/opencv-client
-
本次涉及的软件信息如下：
- 操作系统：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/OSSRH-74965
-
老老实实的创建出来就行了：
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: zq2599@gmail.com
You selected this USER-ID:
"zq2599 <zq2599@gmail.com>"
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 <zq2599@gmail.com>
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的账号密码：
<server>
<id>ossrh</id>
<username>zq2599</username>
<password>12345678</password>
</server>
- 在profiles下增加一个profile节点，gpg.passphrase的内容是刚才创建gpg秘钥时输入的密码：
<profile>
<id>gpg</id>
<properties>
<!-- 由于我的电脑装的gpg2，所以需要指定执行gpg2，否则会报错 -->
<gpg.executable>gpg2</gpg.executable>
<gpg.passphrase>abcdefgh</gpg.passphrase>
</properties>
</profile>
- 涉及到账号密码的全局配置就完成了，接下来打开您的java工程，咱们去修改pom.xml的配置
8. maven项目配置
- 首先要搞清楚发布仓库的地址在哪，官方指导如下，给出了snapshot和release的仓库地址：
- 以下是java工程的pom.xml文件，需重点关注的地方都有中文注释，请不要漏掉带序号的注释，这些都是最关键的配置，这种注释共11个：
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>io.github.zq2599</groupId>
<artifactId>opencv-linux</artifactId>
<version>0.0.3</version>
<name>opencv-linux</name>
<description>opencv-linux</description>
<!-- 1. url必须要有，不然远程提交时会返回错误 -->
<url>https://github.com/zq2599/opencv-client</url>
<properties>
<java.version>1.8</java.version>
</properties>
<packaging>jar</packaging>
<!-- 2. 开源证书 -->
<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>
<!-- 3. 源码仓库信息 -->
<scm>
<connection>scm:git:git@github.com:zq2599/opencv-client.git</connection>
<developerConnection>scm:git:git@github.com:zq2599/opencv-client.git</developerConnection>
<url>https://github.com/zq2599/opencv-client/tree/main</url>
</scm>
<!-- 4. 开发人员信息 -->
<developers>
<developer>
<name>zq2599</name>
<email>zq2599@gmail.com</email>
<organization>https://github.com/zq2599</organization>
<timezone>+8</timezone>
</developer>
</developers>
<!-- 5. 上传的仓库地址，以及使用哪个账号密码配置 -->
<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>
<dependencies>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.16.18</version>
</dependency>
</dependencies>
<build>
<!-- 配置好每个插件的属性 -->
<pluginManagement>
<plugins>
<!-- 6. 上传到sonatype的插件 -->
<plugin>
<groupId>org.sonatype.plugins</groupId>
<artifactId>nexus-staging-maven-plugin</artifactId>
<version>1.6.7</version>
<extensions>true</extensions>
<configuration>
<!-- 这里的id必须要和全局配置中的server一致 -->
<serverId>ossrh</serverId>
<!-- 这个地址，一定要和issue的评论中给出的地址一致！ -->
<nexusUrl>https://s01.oss.sonatype.org/</nexusUrl>
<!-- 如果希望发布后自动执行close和release操作，此处可以调整为true -->
<autoReleaseAfterClose>false</autoReleaseAfterClose>
</configuration>
</plugin>
<!-- 7. 上传源码的插件 -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-source-plugin</artifactId>
<version>3.1.0</version>
<inherited>true</inherited>
<executions>
<execution>
<id>attach-sources</id>
<goals>
<goal>jar</goal>
</