通过使用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/
相关推荐
RainbowSea9 分钟前
12 MySQL 数据库其它调优策略
java·sql·mysql
大只鹅28 分钟前
WebSocket类明明注入了Bean,为什么报错为null
java·websocket
ChinaRainbowSea36 分钟前
9-2 MySQL 分析查询语句:EXPLAIN(详细说明)
java·数据库·后端·sql·mysql
时序数据说38 分钟前
Java类加载机制及关于时序数据库IoTDB排查
java·大数据·数据库·物联网·时序数据库·iotdb
wowocpp38 分钟前
rabbitmq 与 Erlang 的版本对照表 win10 安装方法
java·rabbitmq·erlang
风象南42 分钟前
SpringBoot基于Java Agent的无侵入式监控实现
java·spring boot·后端
崎岖Qiu1 小时前
【Spring篇08】:理解自动装配,从spring.factories到.imports剖析
java·spring boot·后端·spring·面试·java-ee
belldeep1 小时前
java:如何用 JDBC 连接 TDSQL 数据库
java·数据库·jdbc·tdsql
2301_1472583692 小时前
7月2日作业
java·linux·服务器
香饽饽~、2 小时前
【第十一篇】SpringBoot缓存技术
java·开发语言·spring boot·后端·缓存·intellij-idea