首页 > 其他分享 >图文教程：从0到1将项目发布到 Maven 中央仓库

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

时间：2024-09-01 21:14:03浏览次数：3  
标签：maven 教程 验证 -- gpg Maven org com 图文

前言

本文基于官方文档 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. 你拥有以下列表中的代码托管服务账号，可以使用个人域名的反向域名的方式来作为命名空间

    Service Example namespace
    GitHub io.github.myusername
    GitLab io.gitlab.myusername
    Gitee io.gitee.myusername
    Bitbucket io.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: [email protected]
You selected this USER-ID:
   "t1 <[email protected]>"

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 <[email protected]>
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 <[email protected]>" 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>[email protected]</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，就代表发布成功了，恭喜你！

标签：maven,教程,验证,--,gpg,Maven,org,com,图文
From： https://www.cnblogs.com/iminghe/p/18391745

相关文章

  • 通过 Docker 部署 WordPress 搭建博客保姆级教程
    前言（废话）因为最近想搭建一个属于自己的博客，这样就能像筑巢一样随意装饰自己的家，没有那么多的平台约束。虽然搭建个人博客的框架有很多，比如HEXO，HUGO，VuePress等，但在思前想后，最终还是选择了WordPress。我在部署过程中遇到了一系列的问题：需要什么服务，Mysql、PHP、Nginx？如何突破WordP......
  • 【教程4＞第3章＞第9节】8FSK解调系统的FPGA开发与matlab验证
    本课程学习成果预览 欢迎订阅FPGA/MATLAB/Simulink系列教程《★教程1:matlab入门100例》《★教程2:fpga入门100例》《★教程3:simulink入门60例》《★教程4:FPGA/MATLAB/Simulink联合开发入门与进阶X例》目录1.软件版本2.8FSK解调理论简介3.8FSK解调过程的MATLAB......
  • Maven的常用插件
    ApacheMavenCleanApacheMavenCleanPlugin清理编译期在如下目录内生成的文件。project.build.directoryproject.build.outputDirectoryproject.build.testOutputDirectoryproject.reporting.outputDirectoryPluginDocumentationUsage在命令行中执行如下命令......
  • FlexSim在物流业中的应用技术教程
    FlexSim在物流业中的应用技术教程FlexSim简介FlexSim软件概述FlexSim是一款强大的离散事件模拟软件，由FlexSim软件公司开发。它提供了一个直观的3D建模环境，使用户能够创建、测试和优化复杂的物流系统模型。FlexSim的核心优势在于其灵活性和深度，能够模拟从制造、物流到服......
  • Arena：服务行业Arena仿真案例研究技术教程
    Arena：服务行业Arena仿真案例研究技术教程服务行业仿真概述服务行业仿真的重要性在服务行业中，仿真技术被广泛应用于优化运营流程、提高服务质量、预测顾客需求以及评估新策略的影响。通过构建虚拟模型，服务行业可以模拟真实环境下的各种情况，从而在实际操作前发现潜在问题，......
  • Arena：系统优化与Arena仿真技术教程
    Arena：系统优化与Arena仿真技术教程Arena仿真软件概述Arena是一款广泛应用于工业工程、制造、物流、服务行业等领域的仿真软件，由SimulationSolutions开发。它通过构建虚拟模型来模拟真实世界的系统运作，帮助用户分析、预测和优化系统性能。Arena采用图形化界面，用户可以直......
  • C++菜鸟教程 - 从入门到精通 第一节
    一.C++简介C++是一种编程语言，它是由BjarneStroustrup于1979年在贝尔实验室开始设计开发的。C++进一步扩充和完善了C语言，是一种面向对象的程序设计语言。C++可运行于多种平台上，如Windows、MAC操作系统以及 UNIX的各种版本。C++是一种静态类型的、编译式的、......
  • [图文直播]基于ZFile和MinIO搭建私有网盘
    前言ZFile以下是ZFile的官网，上面也涉及到了搭建方法https://docs.zfile.vip/install/os-windows此次仅记录本人按照官方的部署方法进行实操验证。下载ibm-semeru-open-jdk_x64_windows_8u372b07_openj9-0.38.0.msizfile-release.jar具体下载地址见上面的官网安装......
  • 【2025】基于Django的水果商城系统（源码+文档+调试+教程+答疑）
    ......
  • python动画教程|Animations using Matplotlib-官网教程程序解读
    随着python学习的深入，我们不可避免进入画图模块matplotlib，也不可避免会遇到制作动画的需求。【1】官网教程如何学习python制作动画，最简单的就是直奔官网：https://matplotlib.org/stable/users/explain/animations/animations.html#animations它给出很长的代码，下面是除引入nu......

赞助商

阅读排行

网站主页关于我们联系我们网站地图

本网站内容转载自其他媒体，侵权联系[admin##ips99.com]。

Copyright © 2020-2023 IPS99 版权所有 IPS99