上传项目到 Maven 中心仓

Central Portal

中央门户融合了之前 OSSRH 和 Maven Search 的功能，可以简单理解它就是 Maven 公共仓。

OSSRH

OSSRH：这是一个旧概念，全称是 Sonatype Open Source Software Repository Hosting，是上传 Maven 公共仓的前哨中转站。

提供暂存和审核机制：开发者将构件发布到 OSSRH 进行暂存，OSSRH 会对构件进行一系列的校验，如验证项目的元数据、检查构件的完整性、确保遵守 Maven 中心仓的发布规则等。只有通过这些校验的构件才能被提升到 Maven 中心仓。
管理发布流程：OSSRH 使用 Sonatype Nexus 仓库管理器来管理构件的发布过程，包括部署开发版本的二进制文件（快照版本）、暂存发布版本的二进制文件，以及将经过审核的发布版本的二进制文件同步到 Maven 中心仓。
如果你使用 https://oss.sonatype.org 或 https://s01.sonatype.org 来发布，你正在通过 Legacy OSSRH 服务发布。
OSSRH 迁移到 Central Portal 中央门户要建立新的 namespace

Maven 中心仓

用于 Java 开发者在 Maven 项目中查找开源库和构件，相当于提供 release 版本搜索、下载的地方。

Maven 中心仓的搜索地址是：https://central.sonatype.com/
- 从 2023 年 2 月 23 日起，https://search.maven.org/会自动重定向到https://central.sonatype.com/，官方解释
Maven 中心仓没有账号体系，发布正式版本 10 分钟左右就会在 Maven 中心仓搜索到

Central Portal 中央门户上传步骤

注册账号

访问 https://central.sonatype.com
点击右上角 Sign In

官方指引：https://central.sonatype.org/register/central-portal/#create-an-account

创建 namespace

示例：使用 github 创建 namespace

点击右上角头像，选择 View Namespaces
Add Namespace
- io.github.账户名
- 注意如果账户名是大写，要全转为小写
复制验证码
在 github 创建名为验证码的仓库： github.com/账号名/验证码
回到 sonatype 点击验证
验证成功删除 github 验证仓库即可

官方指引：https://central.sonatype.org/register/namespace/#choosing-a-namespace

生成 token 也就是账号密码

访问 https://central.sonatype.com/account
点击 Generate User Token ，将信息复制到剪切板
确认生成（注意：这将使现有的令牌失效，也就是覆盖已有令牌）
将账号密码配置复制到当前使用的 Maven 的 settings.xml 文件中

配置 settings.xml

注意这里的 id 和 pom.xml 里的发布插件 publishingServerId 标签一致

<server>
  <id>central</id>
  <username>xxxxxxx</username>
  <password>xxxxxxxxxxxxxxxxxxxxxxxxxxx</password>
</server>

使用 GPG/PGP 签名文件

用作 Maven 签名插件配置的前置步骤：
- 1、生成 GPG 密钥对
- 2、安装 gpg 命令行
- 3、配置 settings.xml
官方文档：https://central.sonatype.org/publish/requirements/gpg/

安装 GnuPG

下载地址：https://gnupg.org/download/
mac os 用 Homebrew 安装即可
- brew install gnupg
- 或者安装图形应用 https://gpgtools.org/
linux : apt install gnupg

使用 gpg —version 测试安装结果

生成密钥

gpg —gen-key
- 输入姓名、邮箱
- 会弹出一个窗口，输入密码
- 公钥就在输出的 pub 的下一行

pub   ed25519 2024-05-08 [SC] [有效至：2027-05-07]
      xxxxxxxxxxxxxxxxxxxxxx

使用 gpg 密钥签署文件

gpg -ab myfile.java
- 会生成 myfile.java.asc

发布公钥

gpg --keyserver keyserver.ubuntu.com --send-keys [你的公钥]
中央服务器当前支持的 GPG 密钥服务器有：
- keyserver.ubuntu.com
- keys.openpgp.org
- pgp.mit.edu
示例：—send-keys 发送

→ gpg --keyserver keyserver.ubuntu.com --send-keys xxxxxxxxxxxx
gpg: 正在发送密钥 xxxxxxxxxxxx 到 hkp://keyserver.ubuntu.com

示例：—recv-keys 验证

→ gpg --keyserver keyserver.ubuntu.com --recv-keys xxxxxxxxxxxx
gpg: 密钥 xxxxxx：“名字 <邮箱>” 未改变
gpg: 处理的总数：1
gpg:              未改变：1

配置 settings.xml

注意这里 gpg.executable 是你的可执行命令 gpg，也就是 gpg —version 里的 gpg
gpg.passphrase 是生成密钥时设置的密码

<settings>
  <profiles>
    <profile>
      <id>ossrh</id>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
      <properties>
        <gpg.executable>gpg</gpg.executable>
        <gpg.passphrase>the_pass_phrase</gpg.passphrase>
      </properties>
    </profile>
  </profiles>
</settings>

使用 Maven 插件发布

官方文档：https://central.sonatype.org/publish/publish-maven/

生成 Javadoc 和 source 包

官方文档：https://central.sonatype.org/publish/publish-maven/#javadoc-and-sources-attachments

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-source-plugin</artifactId>
      <version>2.2.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>2.9.1</version>
      <executions>
        <execution>
          <id>attach-javadocs</id>
          <goals>
            <goal>jar</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

GPG 签名组件

pom.xml 配置

<build>
  <plugins>
    <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>
  </plugins>
</build>

确保安装了 gpg 命令
确保 settings.xml 配置了 gpg 密钥

Nexus Staging Maven 插件用于部署和发布

pom.xml 配置中央门户部署插件
- 注意这里的 publishingServerId 和 settings.xml 里的 server id 配置一致
配置好后执行 mvn deploy，输入密码即可自动上传，如果有错误会在网页的 Deployments 显示

<build>
    <plugins>
        <plugin>
          <groupId>org.sonatype.central</groupId>
          <artifactId>central-publishing-maven-plugin</artifactId>
          <version>0.7.0</version>
          <extensions>true</extensions>
          <configuration>
            <publishingServerId>central</publishingServerId>
          </configuration>
        </plugin>
    </plugins>
</build>