发布jar包到maven中央仓库

1. 环境

在网上找的很多文章中写得都有很多问题，这里记录一下最近一次成功地发布jar包到maven中央仓库的过程。并附带上每一个步骤官方的指导链接。

  • 系统：mac（windows系统在下载辅助工具时不太一样，在配置上和mac系统没有区别）

  • IDE：IntelliJ IDEA

  • JDK：1.8

  • maven：3.8.1（IDEA自带的版本）

  • 代码：上传到github上（使用gitee也行）

  • 发布形式：以jar包发布release版本（非SNAPSHOT版本）

2. 项目配置

官方对发布的项目做了一些必需的要求，如果不按要求来，发布可能会报错。

2.1. javadoc和source

以非pom方式打包的项目（pom.xml配置文件中可以通过标签配置打包方式，默认就是jar），在打包完成后，target目录下必须要包含***-sources.jar和***-javadoc.jar。如下图：

为了达成以上效果，需要在pom.xml中依赖两个插件：

<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>

参考：Requirements - The Central Repository Documentation

2.2. 使用 GPG/PGP 签署文件

打包完成后，target目录下必须要包含***.jar.sac。如下图：

为了达成以上效果，需要在pom.xml中依赖插件（加完插件不要急着构建，还要下载GPG生成密钥，后面会说）：

<build><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-gpg-plugin</artifactId><version>3.1.0</version><executions><execution><id>sign-artifacts</id><phase>verify</phase><goals><goal>sign</goal></goals></execution></executions></plugin>
</build>

参考：Requirements - The Central Repository Documentation

2.3. 项目名称和版本配置

  • groupId：使用正确的反向域名。如果有私人域名，可以配置成私人域名（后面配置起来比较麻烦）。如果没有私人域名，可以直接使用github的域名：io.github.{account}（gitee同理，推荐使用这种方式， account是github注册的登录账号）。

  • artifactId：项目名称，可以随意发挥。

  • version：版本，可以使用1.1.1这种格式，不推荐带-SNAPSHOT，快照版本不会直接发布到中央仓库。

参考：Requirements - The Central Repository Documentation

2.4. 项目名称、描述和 URL

这个是为了增加可读性。

  • name：推荐使用这种格式：<name>${project.groupId}:${project.artifactId}</name>，当然也可以自定义。

  • description：项目描述，自己发挥。

  • url：项目地址，直接使用github（或gitee）上项目的地址即可。

参考：Requirements - The Central Repository Documentation

2.5. 许可证书

可以使用Apache/MIT的许可证书，直接拷贝下面的即可：

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

参考：Requirements - The Central Repository Documentation

2.6. 开发人员信息

留你自己的艺名和邮箱：

<developers><developer><name>你的艺名</name><email>你的邮箱</email></developer>
</developers>

参考：Requirements - The Central Repository Documentation

2.7. SCM 源码管理系统信息

可以使用github（或gitee）的项目地址。

<scm><connection>scm:git:git://github.com:maidoubaobao/easy-tool.git</connection><developerConnection>scm:git:ssh://github.com:maidoubaobao/easy-tool.git</developerConnection><url>https://github.com/maidoubaobao/easy-tool/tree/master</url>
</scm>

参考：Requirements - The Central Repository Documentation

2.8. 文件签名校验（非必需）

官网说必需要包含.md5和.sha1签名校验文件，但我没有特地去配置这个，也是可以发布的。可以跳过这一步。

参考：Requirements - The Central Repository Documentation

3. 在 JIRA 上提发布申请

3.1. 注册 JIRA

点击如下链接注册账号并登录，如果有账号直接登录即可：Sign up for Jira - Sonatype JIRA

参考：OSSRH Guide - The Central Repository Documentation

3.2. 创建项目

点击新建，按照下面的图示来填写：

  • groupId：要和项目里对应上，必须是一个可用的域名的反转字符串，如果项目是放在github上，必须使用io.github.{account}的格式，否则会审核不通过（注意：不能使用com.github）。

  • Project URL/SCM url：直接使用github的项目地址即可。

3.3. 查看刚刚创建的项目

正常情况下创建好默认就会进入刚刚创建的项目，如果进不去，可以按照路径项目-查看所有项目-类别-Central即可看到项目链接，点进去后，切换筛选器我的报告就能看到创建的项目了。

3.4. 在github中创建一个空项目

创建好的项目，会分配一个唯一标识OSSRH-***（见上图），需要用这个标识去github上创建一个空项目，这个是为了向核审管理员证明需要发布的github项目确实是你自己的项目。

3.5. 等待管理员审核

管理员都在国外，因为时差，一般隔天才会核审通过。没办法，耐心等着吧。审核通过后，会发邮件（邮箱就是注册JIRA的那个），也会在JIRA项目下出现活动日志。

4. 获取 GPG 密钥

在等待JIRA项目审核的同时，可以并行把GPG密钥搞定。注意：mac系统和windows系统在获取GPG密钥时有些区别，mac全程都是通过命令行搞定的，而windows提供了操作界面，可能会方便一点。这里只介绍mac系统的配置方式，windows系统可以自行搜配置教程。

4.1. 安装 GnuPG

  • 用下面的链接下载 GnuPG，选择系统对应的版本。

https://gnupg.org/download/index.html#sec-1-2

  • 验证安装是否成功

使用gpg --version命令来验证，如果输出了版本则说明安装成功。

参考：Working with PGP Signatures - The Central Repository Documentation

4.2. 生成密钥对

使用命令gpg --full-generate-key生成密钥对，2年内有效。执行命令后，需要输入姓名和邮箱（建议和注册JIRA时用的一致），然后输入o（注意是字母o）确认生成。随后会提示输入一个passphrase口令来保护你的密钥对，这个口令要记住，后面配置需要使用。注意：这个命令不建议执行多次，不然生成了多个密钥对，发布时还要去配置使用哪个密钥对，比较麻烦。

参考：Working with PGP Signatures - The Central Repository Documentation

4.3. 发布公钥

  • 使用命令gpg --keyserver pgp.mit.edu --send-keys 公钥来发布。

官网提供了3个地址，有的地址可能不能用，上面这个地址亲测有效。（所以官方也不一定靠谱）

  • 使用命令gpg --keyserver pgp.mit.edu --recv-keys 公钥验证是否发布成功。

注意：验证的命令要等一会执行才能响应数据，估计发布可能有点延时，可以多执行几次。反正如果响应如图所示，就代表发布成功了。

参考：Working with PGP Signatures - The Central Repository Documentation

5. JIRA 项目核审通过后的配置

5.1. 仓库地址

核审通过后，在JIRA上的项目里可以看到日志，这代表项目已经拥有发布权限了。下图标记出来的就是仓库地址。

5.2. 修改 maven 配置

这里修改的是maven的setting.xml配置文件，如果不知道配置文件在哪里（那么你不是一个合格的程序猿），可以在IntelliJ IDEA的settings > Build,Execution,Deployment > Builds Tools > Maven页面找到User settings file。

  • 配置JIRA账户用于发布

  • 这里的<server>-<id>是有用的，一会要在项目的pom文件配置中要对应上。

<servers><server><id>ossrh</id><username>JIRA用户名</username><password>JIRA登录密码</password></server>
</servers>

  • 配置GPG用于文件签署校验

  • 前文2.2小节已经在项目中配置了GPG插件了，这里要配置GPG的口令才能进行正常的签署。

  • 前文4.2小节生成GPG密钥对的时候，输入过一个口令passphrase，就用那个。

<profiles><profile><id>ossrh</id><activation><activeByDefault>true</activeByDefault></activation><properties><gpg.executable>gpg2</gpg.executable><gpg.passphrase>GPG口令</gpg.passphrase></properties></profile>
</profiles>

5.3. 配置仓库地址和插件

这里是在项目的pom文件中配置。

  • 配置发布的仓库地址

  • 这里的仓库域名，可以从JIRA项目的日志里看到，核审通过后会给你一个地址，就用那个做为域名。按照下面的格式来配：

<build><plugins><plugin><groupId>org.sonatype.plugins</groupId><artifactId>nexus-staging-maven-plugin</artifactId><version>1.6.13</version><extensions>true</extensions><configuration><serverId>ossrh</serverId><nexusUrl>https://s01.oss.sonatype.org/</nexusUrl><autoReleaseAfterClose>true</autoReleaseAfterClose></configuration></plugin></plugins>
</build>

6. 发布

JIRA 核审通过后，就可以发布了

6.1. 发布到中央仓库

  • 可以直接在IntelliJ IDEA中点击deploy来发布：

  • 输出如下结果说明发布成功了：

6.2. 验证发布结果

发布成功以后，并不能立刻在maven中央仓库中搜索到，大概隔一天以后才能搜索得到，所以不要心急，耐心等待。

  • JIRA 上的回应

执行完发布动作以后，大概隔了几分钟以后，JIRA项目下会多出一条日志：

这条日志给出了两个地址和两个时间，反正差不多要等个那么长的时间才能搜得到。我已经发布到中央仓库里了，第一个地址里还是找不到，但是第二个地址里能搜到：

下面这个地址好像是执行完发布操作后，过一会就能搜得到，可以试试：Index of /groups/public

  • 在中央仓库里搜索

一般是隔天，才能在中央仓库里搜得到，在阿里云的仓库里也可以搜得到，阿里云本来就是从中央仓库同步的。

建议使用groupId来搜，一搜一个准。用artifactId来搜在第一页可能找不到，因为maven会对搜索结果做排序。

7. 彩蛋

  • JAVA_HOME 报错

如果遇到这样的报错The environment variable JAVA_HOME is not correctly set，不要慌，一般是因为你本地环境变量没有设置JAVA_HOME或者设置成了jre的目录。如果是因为前者可以去设置一下JAVA_HOME，如果是因为后者，可以把JAVA_HOME的目录改成jdk/bin的目录，或者可以改一下项目的pom配置文件：

<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><configuration><!-- 这里需要指定jdk的bin目录下的javadoc执行文件 --><javadocExecutable>${java.home}/../bin/javadoc</javadocExecutable></configuration></execution></executions>
</plugin>

文章转载自：是秃子迟早会发光的

原文链接：https://www.cnblogs.com/wind-wound/p/17893935.html

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/news/219710.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

docker部署go gin框架 Linux环境

docker部署go gin框架 Linux环境

目录 文章目的是什么 环境介绍 Linux 环境下 docker 部署 go gin 详细步骤 部署 gin 文章目的是什么 假设我们学习了 go 语言&#xff0c;在 Linux 上安装了 go 相关的程序&#xff0c;也能直接运行&#xff0c;使用以下命令&#xff1a; go run main.go 假如代码是这样的…
阅读更多...
算法中的最优化方法课程复习

算法中的最优化方法课程复习

算法中的最优化方法课程复习 单模函数、拟凸函数、凸函数证明证明一个线性函数与一个凸函数的和也是凸的 梯度线性规划标准形式以及如何标准化标准形式常见标准化方法线性化技巧 单纯形法二次规划无约束优化Nelder-Mead线搜索FR共轭梯度法例题 优化算法的选择、停止准则算法选择…
阅读更多...
electron命令下载失败，手动安装教程

electron命令下载失败，手动安装教程

现象&#xff1a;pnpm i electron, 一直卡在提示错误node install.js 一 、下载需要的electron版本 地址 二、下载完毕&#xff0c;解压压缩包&#xff0c; 进入项目的node_modules/electron文件夹&#xff0c;创建dist文件夹&#xff0c;将下载的zip包里的文件复制到dist…
阅读更多...
Docker笔记：docker compose部署项目, 常用命令与负载均衡

Docker笔记：docker compose部署项目, 常用命令与负载均衡

docker compose的作用 docker-compose是docker官方的一个开源项目可以实现对docker容器集群的快速编排docker-compose 通过一个配置文件来管理多个Docker容器在配置文件中&#xff0c;所有的容器通过 services来定义然后使用docker-compose脚本来启动&#xff0c;停止和重启容…
阅读更多...
oracle 查看统计信息

oracle 查看统计信息

统计信息在oracle中是非常重要的模块&#xff0c;就好似打仗时的侦察兵&#xff0c;提前了解敌情&#xff0c;来帮助CBO更好地生成执行计划。下面是一些常用地查看统计信息的语句&#xff0c;希望能帮助到大家。 表统计信息查看 select t.owner, t.table_name, t.num_rows, t…
阅读更多...
考研真题c语言

考研真题c语言

【2016年山西大学考研真题】输入10个学生三门课的成绩&#xff0c;用函数实现&#xff1a;找出最高的分数所对应的学号和成绩。 1. 定义一个结构体 Student 来表示每个学生&#xff0c;包括学号和三门课的成绩。 c typedef struct { int studentID; int score1; i…
阅读更多...
链路追踪详解（四）：分布式链路追踪的事实标准 OpenTelemetry 概述

链路追踪详解（四）：分布式链路追踪的事实标准 OpenTelemetry 概述

目录 OpenTelemetry 是什么&#xff1f; OpenTelemetry 的起源和目标 OpenTelemetry 主要特点和功能 OpenTelemetry 的核心组件 OpenTelemetry 的工作原理 OpenTelemetry 的特点 OpenTelemetry 的应用场景 小结 OpenTelemetry 是什么&#xff1f; OpenTelemetry 是一个…
阅读更多...
DevEco Studio 鸿蒙（HarmonyOS）项目结构

DevEco Studio 鸿蒙（HarmonyOS）项目结构

DevEco Studio 鸿蒙&#xff08;HarmonyOS&#xff09;项目结构 一、操作环境 操作系统: Windows 10 专业版 IDE:DevEco Studio 3.1 SDK:HarmonyOS 3.1 二、项目结构 创建简单的Hello World移动应用项目结构如下图 由上到下说明各个文件夹的作用 .hvigor&#xff1a;存…
阅读更多...
阅读笔记——《UTOPIA: Automatic Generation of Fuzz Driverusing Unit Tests》

阅读笔记——《UTOPIA: Automatic Generation of Fuzz Driverusing Unit Tests》

【参考文献】Jeong B, Jang J, Yi H, et al. UTOPIA: automatic generation of fuzz driver using unit tests[C]//2023 IEEE Symposium on Security and Privacy (SP). IEEE, 2023: 2676-2692.【注】本文仅为作者个人学习笔记&#xff0c;如有冒犯&#xff0c;请联系作者删除。…
阅读更多...
智慧储能数字孪生：能源未来的智慧引擎

智慧储能数字孪生：能源未来的智慧引擎

随着社会对清洁能源的需求不断增加&#xff0c;智能储能技术成为能源转型的关键驱动力。在这一领域中&#xff0c;数字孪生技术的应用为智慧储能带来了全新的可能性。数字孪生是指数字化、实时、可视化的模拟系统&#xff0c;通过复制现实世界中的对象或过程&#xff0c;为智能…
阅读更多...
SpeechGPT领航：创新的130亿参数跨模态AI模型

SpeechGPT领航：创新的130亿参数跨模态AI模型

引言 在人工智能的最新进展中&#xff0c;SpeechGPT以其130亿参数的规模和跨模态会话能力引起了业界的广泛关注。这一由复旦大学邱锡鹏教授团队开发的模型&#xff0c;不仅在技术层面上取得了重大突破&#xff0c;也为多模态人工智能&#xff08;AI&#xff09;的未来发展指明…
阅读更多...
力扣120. 三角形最小路径和

力扣120. 三角形最小路径和

动态规划 思路&#xff1a; 假设 dp[i][j] 为最小路径到第 i 层的第 j 个元素的值&#xff1b;则 dp[i][j] min(dp[i - 1][j - 1], dp[i - 1][j]) tr[i][j]&#xff1b;当 j 0 时&#xff0c;dp[i][j] dp[i - 1][0] tr[i][0]&#xff1b;&#xff08;可以认为 j - 1 不能…
阅读更多...
目标检测YOLO实战应用案例100讲-基于深度学习的跌倒检测(续)

目标检测YOLO实战应用案例100讲-基于深度学习的跌倒检测(续)

目录 3.3 基于YOLOv7算法的损失函数优化 3.3.1 IoU损失策略 3.3.2 GIoU回归策略 3.3.3
阅读更多...
Selenium库自动化测试入门

Selenium库自动化测试入门

前言 为什么要学selenium&#xff1f;&#xff1f;前面已经学了requests库我们会发现 对于绝大多数动态渲染的网页来说&#xff0c;用requests进行爬虫比较繁琐。 所以我们还是要学习一下selenium库&#xff0c;以帮助我们更高效的爬取网页。 环境&#xff1a; pychar 202…
阅读更多...
Linux--绝对路径和相对路径

Linux--绝对路径和相对路径

1. 绝对路径 从根目录算起的路径叫做绝对路径 例如: /home/python/Desktop/usr/bin 2. 相对路径 从当前目录算起的路径叫做相对路径 例如: ./test/hello../static/images 3. 绝对路径和相对路径的使用 使用绝对路径切换到桌面 cd /home/python/Desktop 在下载目录以相…
阅读更多...
机器学习算法新手入门指南

机器学习算法新手入门指南

AI算法的种类在人工智能领域中非常丰富&#xff0c;而且多样化&#xff0c;AI算法利用数学、统计学和计算机科学等领域的原理和方法&#xff0c;通过模拟人类智能和学习能力来解决各种复杂的问题。 在监督学习领域&#xff0c;我们有经典的线性回归和逻辑回归算法&#xff0c;…
阅读更多...
光栅化渲染：可见性问题和深度缓冲区算法

光栅化渲染：可见性问题和深度缓冲区算法

在前面第二章中&#xff0c;我们了解到&#xff0c;在投影点&#xff08;屏幕空间中的点&#xff09;的第三个坐标中&#xff0c;我们存储原始顶点 z 坐标&#xff08;相机空间中点的 z 坐标&#xff09;&#xff1a; 当一个像素与多个三角形重叠时&#xff0c;查找三角形表面上…
阅读更多...
Java 多线程之线程安全集合

Java 多线程之线程安全集合

文章目录 一、概述二、List 接口线程安全实现类2.1 普通 List 变线程安全 List2.2 Vector2.3 CopyOnWriteArrayList 三、Map 接口线程安全实现类3.1 普通 Map 变线程安全 Map3.2 Hashtable3.3 ConcurrentHashMap3.4 ConcurrentSkipListMap 有序/跳表 四、Set 接口线程安全实现类…
阅读更多...
J2EE（架构师考试复习资料）

J2EE（架构师考试复习资料）

J2EE 是针对 Web Service、业务对象、数据访问和消息报传送的一组规范。这组应用编程接口确定了 Web 应用与驻留它们的服务器之间的通信方式。J2EE 注重两件事&#xff0c;一是建立标准&#xff0c;使 Web 应用的部署与服务器无关&#xff1b;二是使服务器能控制构件的生命周期…
阅读更多...
前端传的true后端变false？

前端传的true后端变false？

前端传来true&#xff0c;后端变成false&#xff1f; 背景&#xff1a;原因分析&#xff1a;解决&#xff1a; 背景&#xff1a; 最近在搞项目的时候遇到了神奇的东西&#xff0c;后端定了了boolean类型的变量&#xff0c;前端在传值的时候传的是true&#xff0c;但是到了后端…
阅读更多...
最新文章

Copyright @ 2022~2023