通过使用gitee发布项目到Maven中央仓库最新教程

序言

传统的OSSRH出版服务将于2025年6月30日结束,要迁移到Central Portal Publisher Service,以前很多教程都即将失效,所以写个新的记录一下。

先决条件

  1. central.sonatype.com有一个账号,如果还没创建,请先去创建。
  2. Gitee有一个账号,如果还没创建,请先去创建。

创建命令空间(namespace)

central.sonatype.com登录后,点击头像,选择View Namespaces,进入命名空间

点击右上角Register New Namespace按钮,输入io.gitee.xxxx,这里的xxxx需要去替换为Gitee个人资料下的个人空间地址。

输入完命名空间后,点击submit,此时会来到待验证的状态

复制其中的verification key,去Gitee创建一个以这个key为名称的、公开的仓库后,回到此处,点击Verify Namespace即可。这个仓库在验证完成后可以删除。

验证完成后如下图所示

创建并配置token给Maven

central.sonatype.com登录后,点击头像,选择View Account

来到如下图所示页面,点击Generate User Token,创建一个User Token

进入Maven安装目录下的conf文件夹,打开settings.xml文件,添加如下所示的server标签,请将token-usernametoken-password替换为token生成的对应内容。

注意:如果你要自定义一个其他的id,在后续的pom.xml的配置中,publishingServerId这个标签的内容要与server标签中的id一致。

maven中的settings.xml

xml 复制代码
<settings>
  <servers>
    <server>
      <id>ossrh</id>
      <username>token-username</username>
      <password>token-password</password>
    </server>
  </servers>
</settings>

使用GPG生成密钥

前往GPG4win官方下载页面下载gpg

下载完成后,双击运行gpg4win-4.4.1.exe,然后一直点击下一步,在安装目录这里需要注意一下,如果不想装到C盘,就自己修改一个

安装完成后,会有一个Kleopatra的应用,运行它

点击右上角,文件->新建OpenGPG密钥对,记得勾选使用密码保护

点击OK后,会弹出输入密码的提示,输入完成后,继续点击OK

接下来右键新创建的证书,点击"在服务器上发布"

点击导出证书

导出完成后,在右键点击这个证书,选择细节,复制其中的指纹

这个指纹在下节配置Pom.xml时还会用到

然后前往https://keyserver.ubuntu.com/,通过这个证书指纹查询证书是否发布成功。如果搜索得到内容,就发布成功了。

配置项目pom.xml

xml 复制代码
<build>
        <plugins>
            <!-- 添加 source 和 javadoc 插件 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-source-plugin</artifactId>
                <version>3.3.1</version>
                <executions>
                    <execution>
                        <id>attach-sources</id>
                        <goals>
                            <goal>jar-no-fork</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-javadoc-plugin</artifactId>
                <version>3.11.2</version>
                <executions>
                    <execution>
                        <id>attach-javadocs</id>
                        <goals>
                            <goal>jar</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-gpg-plugin</artifactId>
                <version>3.2.7</version>
                <executions>
                    <execution>
                        <id>sign-artifacts</id>
                        <phase>verify</phase>
                        <goals>
                            <goal>sign</goal>
                        </goals>
                        <configuration>
                            <keyname><!-- 这里就是你的证书指纹 --></keyname>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.sonatype.central</groupId>
                <artifactId>central-publishing-maven-plugin</artifactId>
                <version>0.8.0</version>
                <extensions>true</extensions>
                <configuration>
                	<!--与maven配置中的id保持一致-->
                    <publishingServerId>ossrh</publishingServerId>
                    <checksums>required</checksums>
                </configuration>
            </plugin>
        </plugins>
    </build>

测试

powershell 复制代码
# 输入maven命令部署
mvn clean deploy
# 出现一下BUILD SUCCESS就代表成功了
.....
[INFO] Deployment 0fadc095-8f3d-4555-8413-adbe9cf1e28b has been validated. To finish publishing visit https://central.sonatype.com/publishing/deployments
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  15.590 s
[INFO] Finished at: 2025-06-23T15:16:13+08:00
[INFO] ------------------------------------------------------------------------

参考

  1. https://central.sonatype.org/publish/publish-portal-maven/
  2. https://central.sonatype.org/publish/generate-portal-token/
相关推荐
艺杯羹1 小时前
MyBatis 之缓存机制核心解析
java·后端·spring·mybatis
青云交1 小时前
Java 大视界 -- Java 大数据机器学习模型在金融衍生品市场波动特征挖掘与交易策略创新中的应用(363)
java·大数据·机器学习·量化交易·金融衍生品·交易策略·波动率预测
Brookty1 小时前
【Java学习】匿名内部类的向外访问机制
java·开发语言·后端·学习
程序员JerrySUN4 小时前
Linux 内核基础统简全解:Kbuild、内存分配和地址映射
java·linux·运维·服务器·嵌入式硬件·缓存·文件系统
lixzest4 小时前
快速梳理遗留项目
java·c++·python
某个默默无闻奋斗的人5 小时前
【矩阵专题】Leetcode54.螺旋矩阵(Hot100)
java·算法·leetcode
zhysunny5 小时前
04.建造者模式的终极手册:从快餐定制到航天飞船的组装哲学
java·开发语言·建造者模式
Layux6 小时前
使用钉钉开源api发送钉钉工作消息
java·spring boot·钉钉
Reggie_L7 小时前
Stream流-Java
java·开发语言·windows
黑哒哒的盟友7 小时前
JMeter groovy 编译成.jar 文件
java·jmeter·jar