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)快照版發布后就可以直接引用了