图文教程：从0到1将项目发布到 Maven 中央仓库

于 2024-09-02 21:00:00 发布
阅读量821 收藏 15
点赞数 15
分类专栏： 教程指南 文章标签： maven java
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/iminghe/article/details/141814754
版权

前言

本文基于官方文档 https://central.sonatype.org/publish/publish-guide/ 编写。

发布步骤：

  1. 创建账号
  2. 创建用户 Token
  3. 创建命名空间
  4. 配置 GPG
  5. 配置项目
  6. 发布

注意事项：

  • 发布成功的项目无法修改或者删除

准备阶段

创建账号

已有 Google 或者 Github 账号可以跳过此步骤，可以直接使用它们关联登录。

创建账号步骤如下：

  1. 打开官网 https://central.sonatype.com/ 点击右上角的Sign In，然后在打开的登录页中点击Sign up。
    注意：邮箱要填写真实的邮箱，有验证的。
    官网
    登录页

  2. 注册成功之后会提示验证邮箱。
    邮箱验证提示

  3. 打开邮箱，收取邮件，点击Confirm My Account验证邮箱。
    邮件

  4. 在打开的页面中提示邮箱已验证，表示注册成功。
    邮箱验证成功

创建用户 Token

  1. 打开官网 https://central.sonatype.com/ 点击右上角的Sign In，然后在打开的登录页直接输入用户名和密码登录，也可以直接选择 Google 或者 Github 关联登录。

  2. 点击右上角的账号，在下拉菜单中选择View Account。
    View Account

  3. 点击Generate User Token。
    Generate User Token

  4. 然后在弹出来的对话框中点击Ok，就会生成如下形式的 Token。

    <server>
   <id>${server}</id>
   <username>0j6XV+5V</username>
   <password>lSbp/2aMFiSiyzwNstB9zmzo6+5YyLqNHr9JDD8yKC5T</password>
</server>

    注意这里的id信息，需要改成你自定义的，后面会用到。然后将上述内容复制到要发布项目使用的settings.xml文件中，这里将id值改为central。

    <servers>
   <server>
      <id>central</id>
      <username>0j6XV+5V</username>
      <password>lSbp/2aMFiSiyzwNstB9zmzo6+5YyLqNHr9JDD8yKC5T</password>
   </server>
</servers>

创建命名空间

官网对命名空间的解释：

Before you can publish your components, you must choose a namespace. In the Maven ecosystem, this is also known as a groupId, which is one of the three required coordinates to describe any component published to Maven Central, i.e. groupId, artifactId, version.

在发布组件之前，你必须选择一个命名空间。在Maven生态系统中，这也被称为groupId，它是描述发布到Maven Central的任何组件所需的三个坐标之一，即groupId、artifactId、version。

有两种方式选择你的命名空间：

  1. 你拥有域名，可以使用反向域名的方式来作为命名空间，如下所示：

    • www.springframework.org -> org.springframework
    • subdomain.example.com -> com.example
    • my-domain.com -> com.my-domain

    这种方式需要为对应的域名添加指定的域名解析以验证你对域名的所有权，验证成功之后可删除。

  2. 你拥有以下列表中的代码托管服务账号，可以使用个人域名的反向域名的方式来作为命名空间

    ServiceExample namespace
    GitHubio.github.myusername
    GitLabio.gitlab.myusername
    Giteeio.gitee.myusername
    Bitbucketio.bitbucket.myusername

    这种方式需要在对应的账号下创建指定名称的公共仓库以验证账号所有权，验证成功之后可删除。

创建命名空间步骤如下：

  1. 打开官网 https://central.sonatype.com/ 点击右上角的Sign In，然后在打开的登录页直接输入用户名和密码登录，也可以直接选择 Google 或者 Github 关联登录。

  2. 点击右上角的账号，在下拉菜单中选择View Namespaces。
    View Namespaces

  3. 在打开的页面中点击Add Namespace。
    Add Namespace

  4. 在弹出来的对话框中输入自定义的 Namespace。
    Namespace

  5. 创建成功之后显示 Namespace 是待验证状态，点击Verify Namespace进行验证。
    Verify Namespace

  6. 在弹出来的对话框中会根据你填写的 Namespace 类型不同，给出不同的提示，如果你填写的是代码托管服务的个人域名，会提示你到对应的平台中创建一个指定名称的公共仓库；如果是个人域名，会提示你创建一个指定内容的TXT类型的域名解析。总之你会得到一个Verification Key，你需要使用这个值去做对应的操作。点击对话框的Confirm按钮，Namespace 变成待验证状态：
    待验证
    以下两种验证方式，选择一种即可：

    • 创建公共仓库：
      创建公共代码仓库
    • 增加域名解析：
      添加域名解析

  7. 等待 Namespace 验证成功，然后可以把刚刚创建的公共仓库或添加的域名解析记录删除。
    Namespace验证成功

配置 GPG

  1. 打开官网https://gnupg.org/download/index.html#sec-1-2下载系统对应的版本并安装。使用gpg --version验证是否安装成功。

    C:\Users\Administrator>gpg --version
gpg (GnuPG) 2.3.8
libgcrypt 1.10.1
Copyright (C) 2021 g10 Code GmbH
License GNU GPL-3.0-or-later <https://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Home: C:\Users\Administrator\AppData\Roaming\gnupg
Supported algorithms:
Pubkey: RSA, ELG, DSA, ECDH, ECDSA, EDDSA
Cipher: IDEA, 3DES, CAST5, BLOWFISH, AES, AES192, AES256, TWOFISH,
      CAMELLIA128, CAMELLIA192, CAMELLIA256
AEAD: EAX, OCB
Hash: SHA1, RIPEMD160, SHA256, SHA384, SHA512, SHA224
Compression: Uncompressed, ZIP, ZLIB, BZIP2

  2. 使用gpg --gen-key命令生成密钥对，过程中会提示输入Real name和Email address（建议输入真实的邮箱，以便以后用于秘钥恢复），输入之后，会弹窗要求你输入密码（注意：每次发布项目都会用到这个密码），然后就会生成密钥对。
    下面内容中的5BBA74D9F7E76AAA234ACB337B583099E6B290D8就是生成的公钥，接下来需要把它发送到秘钥服务器，因为其他人需要这个公钥来验证你发布的文件。

    C:\Users\Administrator>gpg --gen-key
gpg (GnuPG) 2.3.8; Copyright (C) 2021 g10 Code GmbH
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Note: Use "gpg --full-generate-key" for a full featured key generation dialog.

GnuPG needs to construct a user ID to identify your key.

Real name: t1
Email address: t1@test.com
You selected this USER-ID:
   "t1 <t1@test.com>"

Change (N)ame, (E)mail, or (O)kay/(Q)uit? O
We need to generate a lot of random bytes. It is a good idea to perform
some other action (type on the keyboard, move the mouse, utilize the
disks) during the prime generation; this gives the random number
generator a better chance to gain enough entropy.
We need to generate a lot of random bytes. It is a good idea to perform
some other action (type on the keyboard, move the mouse, utilize the
disks) during the prime generation; this gives the random number
generator a better chance to gain enough entropy.
gpg: revocation certificate stored as 'C:\\Users\\Administrator\\AppData\\Roaming\\gnupg\\openpgp-revocs.d\\5BBA74D9F7E76AAA234ACB337B583099E6B290D8.rev'
public and secret key created and signed.

pub   ed25519 2024-08-26 [SC] [expires: 2026-08-26]
      5BBA74D9F7E76AAA234ACB337B583099E6B290D8
uid                      t1 <t1@test.com>
sub   cv25519 2024-08-26 [E] [expires: 2026-08-26]

  3. 使用gpg --keyserver keyserver.ubuntu.com --send-keys <公钥>命令将公钥发送至服务器，如果出现发送失败的情况，可以选择其他服务器多次重试，总会成功的。

    中央服务器支持的GPG密钥服务器有：

    • keyserver.ubuntu.com
    • keys.openpgp.org
    • pgp.mit.edu
    # 发送公钥
C:\Users\Administrator>gpg --keyserver keyserver.ubuntu.com --send-keys 5BBA74D9F7E76AAA234ACB337B583099E6B290D8
gpg: sending key 7B583099E6B290D8 to hkp://keyserver.ubuntu.com

# 验证公钥失败
C:\Users\Administrator>gpg --keyserver keyserver.ubuntu.com --recv-keys 5BBA74D9F7E76AAA234ACB337B583099E6B290D8
gpg: keyserver receive failed: No data

# 验证公钥成功
C:\Users\Administrator>gpg --keyserver keyserver.ubuntu.com --recv-keys 5BBA74D9F7E76AAA234ACB337B583099E6B290D8
gpg: key 7B583099E6B290D8: "t1 <t1@test.com>" not changed
gpg: Total number processed: 1
gpg:              unchanged: 1

配置项目

以下为一个项目完整的pom.xml配置示例，你需要根据项目的实际信息做出修改：

<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>cc.minghe</groupId>
    <artifactId>no-bug-spring-boot-starter</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>

    <name>No Bug</name>
    <description>Bug退散，Buff拉满</description>
    <url>https://github.com/iminghe/no-bug</url>

    <licenses>
        <license>
            <name>Apache License, Version 2.0</name>
            <url>https://www.apache.org/licenses/LICENSE-2.0.txt</url>
        </license>
    </licenses>

    <scm>
        <url>https://github.com/iminghe/no-bug</url>
        <connection>scm:git:https://github.com/iminghe/no-bug.git</connection>
        <developerConnection>scm:git:https://github.com/iminghe/no-bug.git</developerConnection>
    </scm>

    <developers>
        <developer>
            <name>minghe</name>
            <email>iminghe@xxx.com</email>
        </developer>
    </developers>

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>2.7.18</version>
                <scope>import</scope>
                <type>pom</type>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <!-- Compiler -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.13.0</version>
                <configuration>
                    <source>${maven.compiler.source}</source>
                    <target>${maven.compiler.target}</target>
                    <encoding>${project.build.sourceEncoding}</encoding>
                </configuration>
            </plugin>
            <!-- Source -->
            <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>
            <!-- Javadoc -->
            <plugin>
               <groupId>org.apache.maven.plugins</groupId>
               <artifactId>maven-javadoc-plugin</artifactId>
               <version>3.10.0</version>
               <executions>
                     <execution>
                        <id>attach-javadocs</id>
                        <goals>
                           <goal>jar</goal>
                        </goals>
                     </execution>
               </executions>
            </plugin>
        </plugins>
    </build>

    <profiles>
        <profile>
            <id>release</id>
            <build>
                <plugins>
                    <!-- GPG -->
                    <plugin>
                        <groupId>org.apache.maven.plugins</groupId>
                        <artifactId>maven-gpg-plugin</artifactId>
                        <version>3.2.5</version>
                        <executions>
                            <execution>
                                <id>sign-artifacts</id>
                                <phase>verify</phase>
                                <goals>
                                    <goal>sign</goal>
                                </goals>
                            </execution>
                        </executions>
                    </plugin>
                    <plugin>
                        <groupId>org.sonatype.central</groupId>
                        <artifactId>central-publishing-maven-plugin</artifactId>
                        <version>0.5.0</version>
                        <extensions>true</extensions>
                        <configuration>
                            <publishingServerId>central</publishingServerId>
                        </configuration>
                    </plugin>
                </plugins>
            </build>
        </profile>
    </profiles>
</project>

说明：

  • groupId：前面步骤认证的 Namespace。
  • licenses：项目的许可证信息。
  • scm：source control system,源代码管理系统。这部分元素是必需的，如果URL本身不需要是公开的。你可以指定一个公众无法访问的URL，甚至是一个占位符，指出你的SCM URL是私有的，不适合公众访问。
  • developers：开发人员信息。
  • build：打包的公共插件。
  • profiles：定义不同环境的配置，使用id作为标识，可用于执行mvn命令时，选择指定环境。这里定义了release环境用于项目发布，其中central-publishing-maven-plugin是用来发布项目的，其中publishingServerId对应用户Token设置的id。

发布阶段

在Profiles选中release，然后依次执行clean、deploy命令。
发布

或者也可以在终端的本项目目录下直接执行mvn clean deploy -P release

等待命令执行完成，然后登录官网，点击右上角的账号，选择View Deployments，会看到已验证待发布的项目。
发布页面
确认无误后，点击Publish，状态会变为PUBLISHING，然后等待一会儿，状态变为PUBLISHED，就代表发布成功了，恭喜你！

不止编码
关注
  • 15
    点赞
  • 踩
  • 15
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
将项目发布到 Maven 中央仓库踩过的坑
xiaolyuh的专栏
08-26 6053
转：http://brianway.github.io/2017/05/17/release-to-maven-central-repo/ 大致步骤 注册 Sonatype 的账户。地址：https://issues.sonatype.org/secure/Signup!default.jspa 提交发布申请。创建 Issue 地址：https://issues.sonatype.or...
发布项目到Nexus Maven中央仓库(整合版+坑)
DDLoveWorld的博客
05-07 1322
本来不打算写这篇文章，因为看到了很多这样的文章，本想着按照网上的做一遍，发现遇到的坑是找遍各个博客论坛也没有解决，所以还是打算也弄一篇这样的教程，记录下自己走过的坑。本文主要是整合，也是借鉴了许多优秀的文章。 这是我第一次尝试去开源自己封装的一个小工具，虽然不起眼。但是还是千里之行的第一步，还是让自己狠狠的高兴了一番。 首先我要先感谢一些博主的博客，真...
将项目发布到 maven 中央仓库踩过的坑
brianway
05-17 6510
记录第一次将项目发布到 maven 中央仓库踩过的坑和解决方案。
maven配置smartupload_将项目发布到 maven 中央仓库踩过的坑
weixin_39834149的博客
12-18 365
将项目发布到 maven 中央仓库踩过的坑标签 ： webporter maven[TOC]记录第一次将项目发布到 maven 中央仓库踩过的坑和解决方案。大致步骤项目类型是 Community Support - Open Source Project Repository HostinggroupId 对应的域名你需要有所有权使用 GPG 生成密钥对。下载地址：https://www.gnup...
Maven安装与eclipse配置和创建Maven项目教程【图文教学】
热门推荐
万维网连五洲，二进制写尽天下事，喜欢结识新伙伴寻找志同道合的朋友，欢迎一起探讨学习
08-11 1万+
Maven是一个基于Java的项目管理工具（POM项目对象模型），它可以帮助开发人员自动化构建、测试和部署Java项目。Maven通过一个中央仓库来管理项目依赖，可以自动下载所需的依赖库，并且可以自动生成项目的构建脚本。使用Maven可以大大简化Java项目的构建和管理过程，提高开发效率和项目质量。
Maven保姆式教程---从入门到安装(超级详细)
weixin_53622554的博客
04-14 1790
Maven是Apache旗下的一个开源项目，是一款用于管理和构建java项目的工具。Apache软件基金会，成立于1999年7月，是目前世界上最大的最受欢迎的开源软件基金会，也是一个专门为支持开源项目而生的非盈利性组织。
发布包到maven公共仓库图文教程(1) --- 注册账号和提交申请
之城的专栏
05-21 4691
当你有个很好的想法， 写了一个开源的项目，想发布到仓库给别人用的时候， 你可能就需要这篇教程。 发布jar包主要分以下几步。 申请账号 提交申请 GPG的安装使用 打包上传 发布 申请账号 打开网址： https://issues.sonatype.org/secure/Dashboard.jspa 这个网址打开会有点慢， 如果不能打开就需要一些科技了。 毕竟国外的网络只能这样。 因为我已经注册了账号并记住密码了， 所以图中账号密码自动填写了。 注册账号 点击sign up 链接会跳转到注册信息填写页面
Maven环境，仓库配置（图文教程加小案例）
10-17
默认是Maven中央仓库（http://repo1.maven.org/maven2/）。 - **公司或团队内部仓库**：如果是私有的库，可以配置为镜像或设置为额外的远程仓库。 配置仓库主要通过修改`~/.m2/settings.xml`文件。以下是一些常见...
Eclipse配置maven环境的图文教程
08-28
"Eclipse配置maven环境的图文教程" 本教程旨在指导读者如何在Eclipse中配置maven环境，从而方便地管理项目依赖项。本教程涵盖了maven的基本概念、maven仓库的类型、Eclipse中安装maven的步骤、连接本地仓库等知识点...
Windows下maven安装配置图文教程（包括本地化仓库配置）
09-29
远程仓库是Maven官方维护的，所有开源项目都可以将构建好的包发布到中央仓库中。随着时间推移，本地仓库会逐渐增大，这也是为什么要将本地仓库放置在非系统盘（比如C盘）的原因。 综上所述，Maven安装配置是一个...
maven的安装配置以及在IDEA中的配置图文教程
08-28
这篇教程不仅为Java开发者提供了详细的Maven安装与配置指南，还特别针对了IntelliJ IDEA这一流行的开发工具，确保开发者能够无缝地将Maven集成到自己的开发环境中，提升开发效率。了解并掌握Maven的安装与配置对于...
Maven
k11582kk的博客
08-29 748
简介：Maven 是一个主要用于 Java 项目的管理工具。它有以下主要特点：1.依赖管理：自动下载和管理项目所需的依赖库（jar包），解决依赖冲突，实现依赖传递。2.提供标准统一的项目结构，使得代码可以在不同的开发工具之间移植。
如何给Maven添加阿里云镜像
tyxjolin的专栏
08-29 452
【代码】如何给Maven添加阿里云镜像。
Maven聚合与继承
最新发布
Mr_Susy的博客
09-02 684
当我们一次想要构建多个项目时应该怎么做？当我们多个模块下存在很多相同的配置时如何进行版本控制？
解决Springboot项目Maven下载依赖速度慢的问题
interest_ing_的博客
08-28 1092
在使用Maven构建项目时，有时会遇到下载依赖包速度慢的问题。为了提高下载速度，我们可以将默认的仓库地址替换为国内镜像源。以下是如何通过修改`settings.xml`文件来实现这一目的的详细步骤
【drools】intelj修改JDK版本、进行maven test
突围
08-29 318
ApplicantRuleTest
Maven的使用
juanmiao的专栏
09-02 98
Maven可以帮助开发人员管理项目所需的外部依赖库。开发人员只需在项目的配置文件中声明所需的依赖，Maven就会自动下载并管理这些依赖。开发人员可以将一个大型项目划分为多个模块，每个模块可以独立进行构建和测试。这样可以提高开发效率，并且使得模块之间的依赖关系更加清晰和可控。开发人员可以使用Maven提供的命令来执行这些任务，而不需要手动编写复杂的构建脚本。开发人员可以使用Maven插件来生成各种类型的文档，如API文档、用户手册等。开发人员可以通过修改配置文件来定制项目的构建过程，而不需要修改构建脚本。
Maven介绍
m0_52049533的博客
09-02 203
Maven是一款用于管理和构建java项目的工具依赖管理：避免jar包冲突统一项目结构标准跨平台的自动化项目构建方式导入maven模块时直接导入pom文件即可。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值