上传本地jar包到maven中央仓库

前言

1. 本次目的：将jar包上传到maven远程中央仓库上
2. 做用：在Java - maven项目中可在pom文件中引入相应jar包依赖
3. 问题：maven不支持直接上传jar包
4. 解决：将jar包部署到第三方Maven仓库（如：sonatype ossrh仓库）中，以后再将jar包同步更新到Maven中央仓库中
5. Sonatype OSSRH官方介绍地址：central.sonatype.org/pages/ossrh…
6. 中央组件要求：central.sonatype.org/pages/requi…
7. Maven部署到OSSRH参考配置文档： central.sonatype.org/pages/apach…

1、注册sonatype帐号：【申请上传资格】

issues.sonatype.org/secure/Sign…

以下注册成功！

2、登陆

issues.sonatype.org/secure/Dash…

登陆成功进来以后可选择本身喜欢的语言显示~

接下来的就是建立头像等等了，这里很少说

进来以后以下：

3、新建issue

issues.sonatype.org/secure/Crea…

My issue : issues.sonatype.org/browse/OSSR…

建立以后以下，等待审核...

Status状态从OPEN变成RESOLVED表示成功！

小编第一次建立后审核失败，现现在改为以下，再看看是否成功吧~

第二次审核失败，修改以下：

第三次审核失败，修改以下：

在第三次修改后，没有任何回复，这时我就从新建立了一个issue，以下审核成功，此次审核速度就很是快了，可能也就几分钟事后就经过了，以下Status状态从OPEN变成了RESOLVED ~ issues.sonatype.org/secure/Crea…

新建issue遇坑问题总结：

1. 这里能够采用github做为Group Id、Project URL、SCM url
2. 如何使用github的信息呢？ ① Group Id：填写com.github.xx -> xx为github用户名 ② Project URL：刚建立时随便填写一个github中已有的一个开放仓库名，建立后修改成与之对应的名称，以下：

   

   ③ SCM url：填写github中的仓库名.git
3. 用户名设置不要太长，由于小编以前填写名称过长，被要求太重新建立新帐号

4、构件仓库上传jar包：oss.sonatype.org/#welcome

将jar包上传到这里，Release 以后就会同步到maven中央仓库

一、本地安装gpg，并使用gpg生成密钥对

注：发布到Maven仓库中的全部文件都要使用GPG签名，以保障完整性。

① 下载安装gpg4win

Windows系统下载地址： www.gpg4win.org/download.ht…

安装很简单，以下：

由于咱们只须要GnuPG，因此其它的能够没必要勾选

cmd执行以下命令验证是否安装成功：

gpg --version
复制代码

② 使用gpg生成密钥对

cmd执行以下命令：

gpg --gen-key
复制代码

【注】输入的 Passphrase 值至关于密钥的密码，后面会用到！！

若是ok以后出现以下界面，是提示密码安全度不高，须要包含至少一个数字或特殊字符~ 从新输入一下便可

ok以后，咱们的密钥对就设置好了 【注】，下图中的 448854BCFF61E7F7 至关于咱们生成的key，后面要用到！！

③ 上传GPG公钥

目的：将公钥上传到公共的密钥服务器（也就是上传到第三方的key验证库）让其余人能够经过公钥来验证jar包的完整性

查看公钥

gpg --list-keys
复制代码

其中3408AAAFEE3AB847DE82602B448854BCFF61E7F7为公钥ID

将公钥或key发布到 PGP 密钥服务器（注：这里我暂时未发现有何区别~）

gpg --keyserver hkp://pool.sks-keyservers.net --send-keys 公钥ID或上面提到的key
gpg --keyserver hkp://keyserver.ubuntu.com:11371 --send-keys 公钥ID或上面提到的key
复制代码

查询公钥是否发布成功

gpg --keyserver hkp://pool.sks-keyservers.net --recv-keys 公钥ID或上面提到的key
gpg --keyserver hkp://keyserver.ubuntu.com:11371 --recv-keys 公钥ID或上面提到的key
复制代码

二、在maven的setting.xml配置文件中添加以下节点信息：

<servers>
  <!-- 上传jar包到maven中央仓库配置start -->
  <server>
      <id>ossrh</id>
      <username>Sonatype帐号</username>
      <password>Sonatype密码</password>
  </server>
  <!-- 上传jar包到maven中央仓库配置end -->
</servers>
复制代码

三、配置项目的pom.xml文件

可参考Sonatype提供的要求： central.sonatype.org/pages/requi… Sonatype提供的pom文件demo：github.com/simpligilit…

个人pom文件配置以下：github.com/zhengqingya…

<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>com.github.zhengqing</groupId>
	<artifactId>OSSRH-49683</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<packaging>jar</packaging>

	<name>${project.groupId}:${project.artifactId}</name>
	<description>The test uploads the jar to the maven central repository</description>
	<url>https://github.com/zhengqingya/OSSRH-49683</url>

	<properties>
		<java.version>1.8</java.version>
		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
		<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
		<maven.compiler.source>${java.version}</maven.compiler.source>
		<maven.compiler.target>${java.version}</maven.compiler.target>
		<maven.deploy.skip>true</maven.deploy.skip>
	</properties>

	<dependencies>
		<!-- ... -->
	</dependencies>

	<!-- 许可证信息 -->
	<licenses>
		<!-- Apache许可证 -->
		<license>
			<name>The Apache Software License, Version 2.0</name>
			<url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
		</license>
		<!-- MIT许可证 -->
		<!-- <license> <name>MIT License</name> <url>http://www.opensource.org/licenses/mit-license.php</url> </license>-->
	</licenses>
	<!-- SCM信息 -> git在github上托管 -->
	<scm>
		<connection>scm:git:git://github.com/zhengqingya/OSSRH-49683.git</connection>
		<developerConnection>scm:git:ssh://github.com/zhengqingya/OSSRH-49683.git</developerConnection>
		<url>https://github.com/zhengqingya/OSSRH-49683/tree/master</url>
	</scm>
	<!-- 开发者信息 -->
	<developers>
		<developer>
			<name>zhengqingya</name>
			<email>960869719@qq.com</email>
			<url>https://github.com/zhengqingya</url>
		</developer>
	</developers>

	<!-- 使用我的资料：因为生成javadoc和源jar以及使用GPG签署组件是一个至关耗时的过程，所以这些执行一般与正常的构建配置隔离并移动到配置文件中。而后，在经过激活配置文件执行部署时，将使用此配置文件。 -->
	<profiles>
		<profile>
			<id>ossrh</id>
			<activation>
				<activeByDefault>true</activeByDefault>
			</activation>
			<build>
				<plugins>
					<!-- 要生成Javadoc和Source jar文件，您必须配置javadoc和源Maven插件 -->
					<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>
					<!-- 必须配置GPG插件用于使用如下配置对组件进行签名 -->
					<plugin>
						<groupId>org.apache.maven.plugins</groupId>
						<artifactId>maven-gpg-plugin</artifactId>
						<version>1.5</version>
						<executions>
							<execution>
								<id>sign-artifacts</id>
								<phase>verify</phase>
								<goals>
									<goal>sign</goal>
								</goals>
							</execution>
						</executions>
					</plugin>
				</plugins>
			</build>
			<!-- 【注】snapshotRepository 与 repository 中的 id 必定要与 setting.xml 中 server 的 id 保持一致！ -->
			<distributionManagement>
				<snapshotRepository>
					<id>ossrh</id>
					<url>https://oss.sonatype.org/content/repositories/snapshots</url>
				</snapshotRepository>
				<repository>
					<id>ossrh</id>
					<url>https://oss.sonatype.org/service/local/staging/deploy/maven2/</url>
				</repository>
			</distributionManagement>
		</profile>
	</profiles>

</project>
复制代码

四、部署和发布Jar包

方法一： 命令

部署命令以下：

mvn clean deploy
复制代码

当咱们的项目中含有多个模块时，咱们可使用 -projects 来指定部署哪个模块

举例：

1. 部署一个模块以下： 【demo和demo2为模块名】

   mvn clean deploy -projects demo
   复制代码

2. 部署两个模块以下：

   mvn clean deploy -projects demo,demo2
   复制代码

方法二： idea图形化 -> 直接双击deploy

【注】第一次执行时须要输入以前设置的passphrase密码 ~

若是不想出现此，也可在一开始直接执行以下命令： mvn clean deploy -P sonatype-oss-release -Darguments="gpg.passphrase=设置gpg密钥时输入的Passphrase"

上传所遇问题

若是出现上传问题，能够尝试将 oss.sonatype.org/#stagingRep… 上以前上传的错误项目所有删除【选中点击Drop便可删除】，而后再次上传~

最后成功以下：

本地仓库：

5、同步到maven中央仓库

到 oss.sonatype.org/#stagingRep… 中勾选本身上传的构件（咱们的jar包上传到这里哦）点击Close而后再Release，Release以后就会同步到maven中央仓库

最终到 maven中央仓库 中就能够搜索到了