发布依赖到maven仓库

刺骨的言语ヽ痛彻心扉 2024-03-26 16:08 78阅读 0赞

> maven中央仓库是一个开放的仓库，所以我们也可以把自己开发的jar推送到远程仓库，这样可以直接引入pom依赖使用我们的库。

### 准备工作 ###

● 需要一个github账号（程序员必备）  
● 网络代理（涉及到的网站通常没版本在国内直接访问，所以最好使用代理）

其他不需要准备什么了，按照以下的步骤依次执行就行。  
主要流程：在github上创建项目 - 注册sonatype账号 - 项目申请 - 安装PGP - 修改仓库信息 - 推送到maven仓库。

### 在github上创建自己的项目 ###

创建一个项目，设置成public即可。

### 注册sonatype账号 ###

https://issues.sonatype.org/secure/Signup!default.jspa  
![在这里插入图片描述][450f9cf2fcb444ba901e5c83158ac0d3.png]

注册的信息没有特殊要求，一般和github账号保持一致，也容易记。  
这个网站和我们平常用的jira一样，方便协同合作。

### 项目申请 ###

新建一个【Community Support - Open Source Project Repository Hosting (OSSRH)】类型的问题，主要用于验证github项目是否有效。  
![在这里插入图片描述][3648e98f78c6478883f881d48cec1a5e.png]

这个页面中需要填group.id等信息，如下：  
![在这里插入图片描述][937360561c384f37a07b7f0ede4d6225.png]

Group Id是自己域名的反写，如果没有域名可以使用github地址，例如：io.github.casuallc。  
提示：https://casuallc.github.io/ 这个地址是基于github创建的自己博客的地址，如果没有可以创建下。

Project URL 是github上的项目地址：https://github.com/casuallc/admq-spring-boot-starter  
SCM url是git地址：https://github.com/casuallc/admq-spring-boot-starter.git

填写完成后，会有人在这个问题的评论里联系你。

### 验证Github项目有效性 ###

进入创建的问题，大概等几分钟后就有机器人联系你的，会留下以下的评论。  
![在这里插入图片描述][cba83c0863db4a4e8f65598c1b26a36a.png]

这个是让你在github上创建一个空的项目，创建完评论下就行（不评论估计也行，，）。

之后在创建的问题下会有如下评论，表示你已经可以准备发布项目到maven仓库了。  
![在这里插入图片描述][0ebdc6b0642144fc8dafec618c366212.png]

### 安装GPG ###

**这个工具是用来加密构建的jar、pom、source和doc的，理论上是必须的，但是我没验证。可以先跳过，如果后边有报错再安装也行。**  
https://gpg4win.org/ 在这里可以下载对应操作系统安装包，我是在window下安装的，直接点点点就好了。。。  
这里有一点需要注意的是，这个网站会让你选择是不是捐赠，有钱的话就捐点，没钱的话不捐也行。  
![在这里插入图片描述][8adfb6baf64b496b8ed977e8e353f3f8.png]

安装完成后打开，在【文件】中选择【New OpenPGP Key Pair…】  
![在这里插入图片描述][a68458f714754b8fae248ca8ce6ee6c8.png]

名字、邮件地址和github上的保持一致吧。  
创建完成后：  
![在这里插入图片描述][8c9d1dbe637c4253a570a2db6585e97a.png]

然后右键创建好的证书，选择【在服务器上发布】。

### 修改项目License信息 ###

这个不是必须的，但通常会在pom中添加Apache License信息和一些用户信息。

<licenses>
        <license>
          <name>Apache License, Version 2.0</name>
          <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
          <distribution>repo</distribution>
        </license>
      </licenses>
      <scm>
        <connection>https://github.com/casuallc/admq-spring-boot-starter.git</connection>
        <url>https://github.com/casuallc/admq-spring-boot-starter</url>
      </scm>
      <developers>
        <developer>
          <name>clooker</name>
          <email>clooker@163.com</email>
          <roles>
            <role>Developer</role>
          </roles>
          <timezone>+8</timezone>
        </developer>
      </developers>

添加仓库和认证信息信息  
在项目的pom.xml中添加以下内容

<profiles>
      <profile>
        <id>release</id>
        <build>
          <plugins>
            <plugin>
              <artifactId>maven-source-plugin</artifactId>
              <executions>
                <execution>
                  <id>attach-sources</id>
                  <goals>
                    <goal>jar</goal>
                  </goals>
                </execution>
              </executions>
            </plugin>
            <plugin>
              <artifactId>maven-javadoc-plugin</artifactId>
              <version>${maven-javadoc-plugin.version}</version>
              <executions>
                <execution>
                  <id>attach-javadocs</id>
                  <goals>
                    <goal>jar</goal>
                  </goals>
                </execution>
              </executions>
              <configuration>
                <source>8</source>
                <doclint>none</doclint>
              </configuration>
            </plugin>
            <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-gpg-plugin</artifactId>
              <version>1.6</version>
              <executions>
                <execution>
                  <id>sign-artifacts</id>
                  <phase>verify</phase>
                  <goals>
                    <goal>sign</goal>
                  </goals>
                </execution>
              </executions>
            </plugin>
            <plugin>
              <groupId>org.sonatype.plugins</groupId>
              <artifactId>nexus-staging-maven-plugin</artifactId>
              <version>${nexus-staging-maven-plugin.version}</version>
              <extensions>true</extensions>
              <configuration>
                <serverId>ossrh</serverId>
                <nexusUrl>https://s01.oss.sonatype.org/</nexusUrl>
                <autoReleaseAfterClose>true</autoReleaseAfterClose>
              </configuration>
            </plugin>
          </plugins>
        </build>
      </profile>
    </profiles>

在maven的settings.xml中添加sonatype上注册的账户信息。

<server>
      <id>ossrh</id>
      <username>clooker</username>
      <password>xxxx</password>
    </server>

注意：项目pom文件中org.sonatype.plugins插件下的serverId要和maven settings.xml中的id保持一致。

### 推送项目到maven仓库 ###

执行 maven clean deploy -Prelease  
![在这里插入图片描述][f9174df73f2742eba1be82c1a8b694ec.png]

org.sonatype.plugins 这个插件会自动推送到maven仓库，然后执行close、release操作，不需要手动在https://s01.oss.sonatype.org/上执行了。  
之前的流程：  
登录https://s01.oss.sonatype.org/，用户名密码和sonatype一样  
选择：Staging Repositories  
刷新后，选择刚才自己提交的项目，依次点击：Close和Release。  
![在这里插入图片描述][2444ad7c5fd341be8ea526505e224e74.png]

### 查看自己的项目 ###

等待一段时间后就能在maven仓库看到自己的项目了，我这里是推送成功就能看到了。  
https://s01.oss.sonatype.org/content/repositories/releases/io/github/casuallc/admq-spring-boot-starter/  
![在这里插入图片描述][b0bf66c8f2364d4386a78ba5fc6a1358.png]

### 其他 ###

需要注意的是release的版本不能相同，也就是已经release的jar就不能修改了，所以每次release需要修改版本号。  
如果出现401、403等问题，通常是GPG没有安装好，或者maven-gpg-plugin插件的版本不对，或者是在sonartype上注册账号需要等一段时间才会生效。

[450f9cf2fcb444ba901e5c83158ac0d3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/8e28c13d354e43df98381a42954bed02.png
[3648e98f78c6478883f881d48cec1a5e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/2daec1f3ffc84775a8bd08f0224a90e2.png
[937360561c384f37a07b7f0ede4d6225.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/af745b1344e548d18ffba2590a435259.png
[cba83c0863db4a4e8f65598c1b26a36a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/5aac6e3ab79241b38a0618f85f7d5826.png
[0ebdc6b0642144fc8dafec618c366212.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/bcb244ba95144b62b175884297c466a5.png
[8adfb6baf64b496b8ed977e8e353f3f8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/17ee6438c23e4730bf1136c2bb63dc2f.png
[a68458f714754b8fae248ca8ce6ee6c8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/e0f6a88bb7d7491a834cb5f10d4b2d7c.png
[8c9d1dbe637c4253a570a2db6585e97a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/1c83544021f54dd59b19ff2b5d639b1c.png
[f9174df73f2742eba1be82c1a8b694ec.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/74e1369cc94f44efbf56c1b7fbf6a56f.png
[2444ad7c5fd341be8ea526505e224e74.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/e4905f670f214141a26e54729bc22995.png
[b0bf66c8f2364d4386a78ba5fc6a1358.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/05967d46d0ae4928b6b00d5940614de1.png