Maven发布Release到中心仓库历程记录(无个人域名)
前言
因为前段时间自己做了一个爬虫项目(地址),自己很希望分享到maven中心仓库上,感觉拥有自己的jar包令我兴奋,便开始了maven发布的探索之路,在 这个过程中,遇到了不少的问题,本文把整个过程记录下来,希望以后能够帮助到有需要的人
准备工作
-
注册maven发布的账号
注册地址:注册,注册过程中最好能保存一下密码,不然真的很容易忘记,注册过程我就不多说了,把用户名,密码填写完就行了
-
创建一个发布项目的issue
创建地址:创建
创建的注意事项:
-
下载安装GPG并生成密钥
下载地址:下载
下载时候注意一下,它会让你捐赠的,如果你不想捐赠,可以选择捐赠0,然后点击下载,安装时候,一路点击下一步就行了,注意第一步就会让你选择语言,最好选简体中午,如果你英语8级,当我没说
生成密钥
生成密钥有两种方式:命令行和GPG界面生成
1.命令行:
生成: gpg --gen-key Real name: 名字(E文)(我填了fanyong) Email address: 邮箱(自己的邮箱,我的是1023079644@qq.com) You selected this USER-ID: "xxx[xxx@qq.com](mailto:xxx@qq.com)" Change (N)ame, (E)mail, or (O)kay/(Q)uit? o 之后往下,会让你输入用户名和邮箱,还有一个Passphase(输入两次,我的是fanyong920),相当于密钥库密码,不要忘记。
查看公钥 gpg --list-keys 查询结果: C:/Users/fanyong/AppData/Roaming/gnupg/pubring.kbx -------------------------------------------------- pub rsa2048 2020-06-06 [SC] [expires: 2022-06-06] 85B594371E0A38D70243B1E927EDC1D952E45892 uid [ultimate] fanyong <1023079644@qq.com> sub rsa2048 2020-06-06 [E] [expires: 2022-06-06]
其中85B594371E0A38D70243B1E927EDC1D952E45892就是你的公钥的指纹
发布公钥: gpg --keyserver hkp://keyserver.ubuntu.com:11371 --send-keys 85B594371E0A38D70243B1E927EDC1D952E45892
查询发布公钥是否成功 gpg --keyserver hkp://keyserver.ubuntu.com:11371 --recv-keys 85B594371E0A38D70243B1E927EDC1D952E45892 成功的话会有如下结果 gpg: key 27EDC1D952E45891: "fanyong <1023079644@qq.com>" not changed gpg: Total number processed: 1 gpg: unchanged: 1
2.操作界面
第一步
第二步:
填写密钥密码,我的是fanyong920,这一步我借用了别人的截图,所以图片上填的不是fanyong920
第三步:公钥上传至服务器
如果上传服务器失败,则试着更改一下服务器地址:
设置(S)->配置Kleopatra(C),修改 OpenPGP密钥服务器。
可选的服务器地址:
在你上传过程中,如果密钥不存在服务器,那么就会有错误提示信息,里面的服务器地址就是可选的
到这里准备工作就已经做好了
按照issue一步一步往下走
如果你是上午提的issue,估计很快就会得到了回复,因为老外在线,如果你是下午的话,有可能要到半夜才能回你了
1.如果issue得到了回复,那么应该是如下这样:
2.issue的第二次得到回复
因为我的项目是放在github上,并且用了io.github.fanyong920的域名作为groupId,所以对方要验证fanyong920是不是我的账号
3.issue的第三次得到回复
接下来就是最重要的步骤了:上传jar包到release,snapshot仓库
我只是发布了release版本,所以下面步骤以上传jar到release仓库为例:
-
Maven的settins文件设置
1.在servers中添加
<server> <id>sonatype-nexus-snapshots</id> <username>https://issues.sonatype.org的账号</username> <password>https://issues.sonatype.org的密码</password> </server> <server> <id>sonatype-nexus-staging</id> <username>https://issues.sonatype.org的账号</username> <password>https://issues.sonatype.org的密码</password> </server> <server> <id>ossrh</id> <username>https://issues.sonatype.org的账号</username> <password>https://issues.sonatype.org的密码</password> </server>
2.在mirrors中配置了阿里云仓库,已经配置的可以跳过
<mirror> <id>alimaven</id> <name>aliyun maven</name> <url>http://maven.aliyun.com/nexus/content/groups/public/</url> <mirrorOf>central</mirrorOf> </mirror>
3.在profiles中配置
<profile> <id>ossrh</id> <activation> <activeByDefault>true</activeByDefault> </activation> <properties> <gpg.executable>C:/Program Files (x86)/GnuPG/bin/gpg.exe</gpg.executable> <gpg.passphrase>上面生成的密钥密码:fanyong920</gpg.passphrase> <gpg.homedir>{找到dir:cmd->gpg --list-key}C:/Users/fanyong/AppData/Roaming/gnupg</gpg.homedir> </properties> </profile>
-
POM.xml文件设置
1.配置必须的标签:url,developers,licenses,scm,distributionManagement
<url>https://github.com/fanyong920/jvppeteer</url>
<developers>
<developer>
<id>fanyong</id>
<name>fanyong</name>
<email>1023079644@qq.com</email>
<roles>
<role>Project Manager</role>
<role>Architect</role>
</roles>
<timezone>+8</timezone>
</developer>
</developers>
<licenses>
<license>
<name>Apache License</name>
<url>https://github.com/fanyong920/jvppeteer/blob/master/LICENSE</url>
</license>
</licenses>
<scm>
<url>https://github.com/fanyong920/jvppeteer</url>
<connection>https://github.com/fanyong920/jvppeteer.git</connection>
</scm>
<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>
2.配置发布的maven插件
里面有个配置:com.ruiyun改成你对应的包结构
<build>
<!-- configured plugins -->
<pluginManagement>
<plugins>
<plugin>
<groupId>biz.aQute.bnd</groupId>
<artifactId>bnd-maven-plugin</artifactId>
<version>4.3.1</version>
<executions>
<execution>
<goals>
<goal>bnd-process</goal>
</goals>
<!-- com.ruiyun改成你对应的包结构 -->
<configuration>
<bnd><![CDATA[
Export-Package: \
com.ruiyun.*
-noextraheaders: true
-snapshot: SNAPSHOT
]]></bnd>
</configuration>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.7.0</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
<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>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>3.0.2</version>
<configuration>
<archive>
<manifestFile>${project.build.outputDirectory}/META-INF/MANIFEST.MF</manifestFile>
</archive>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.10.3</version>
<configuration>
<encoding>UTF-8</encoding>
<aggregate>true</aggregate>
<charset>UTF-8</charset>
<docencoding>UTF-8</docencoding>
</configuration>
<executions>
<execution>
<id>attach-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-shade-plugin</artifactId>
<version>3.1.0</version>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-source-plugin</artifactId>
<version>3.0.0</version>
<executions>
<execution>
<id>attach-sources</id>
<goals>
<goal>jar-no-fork</goal>
</goals>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.sonatype.plugins</groupId>
<artifactId>nexus-staging-maven-plugin</artifactId>
<version>1.6.8</version>
</plugin>
</plugins>
</pluginManagement>
<sourceDirectory>src/main/java</sourceDirectory>
<testSourceDirectory>src/test/java</testSourceDirectory>
<plugins>
<plugin>
<groupId>biz.aQute.bnd</groupId>
<artifactId>bnd-maven-plugin</artifactId>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
</plugin>
</plugins>
</build>
<profiles>
<profile>
<id>ossrh</id>
<activation>
<property>
<name>performRelease</name>
<value>true</value>
</property>
</activation>
<build>
<plugins>
<plugin>
<groupId>biz.aQute.bnd</groupId>
<artifactId>bnd-maven-plugin</artifactId>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-gpg-plugin</artifactId>
</plugin>
<plugin>
<groupId>org.sonatype.plugins</groupId>
<artifactId>nexus-staging-maven-plugin</artifactId>
<extensions>true</extensions>
<configuration>
<serverId>ossrh</serverId>
<nexusUrl>https://oss.sonatype.org/</nexusUrl>
<autoReleaseAfterClose>true</autoReleaseAfterClose>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-source-plugin</artifactId>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
</plugin>
</plugins>
</build>
</profile>
</profiles>
-
执行发布命令
mvn clean deploy -P ossrh 这里的ossrh是对应profile的id
顺利的话,这个命令会BUILD SUCCESS
发布成功后,你还需要在iusse上回复对方,你已经发布了release版本到maven中心了
一般在这时候,两个小时左右,你的jar包就同步到了maven中心。
在未同步之前,你可以到https://search.maven.org 查看你的jar包的具体信息
我的搜索出来就是这个样子:
我的爬虫框架的坐标是:
<dependency>
<groupId>io.github.fanyong920</groupId>
<artifactId>jvppeteer</artifactId>
<version>1.0.1</version>
</dependency>
如何发布快照版本?
在pom.xml中的项目版本号后面加上 -SNAPSHOT 就行
不需要执行关闭、发布构建步骤,(对应nexus-staging-maven-plugin的autoReleaseAfterClose)快照版发布后就可以直接引用了