Maven發布Release到中心倉庫歷程記錄(無個人域名)


Maven發布Release到中心倉庫歷程記錄(無個人域名)

前言

因為前段時間自己做了一個爬蟲項目(地址),自己很希望分享到maven中心倉庫上,感覺擁有自己的jar包令我興奮,便開始了maven發布的探索之路,在 這個過程中,遇到了不少的問題,本文把整個過程記錄下來,希望以后能夠幫助到有需要的人

准備工作

  • 注冊maven發布的賬號

    注冊地址:注冊,注冊過程中最好能保存一下密碼,不然真的很容易忘記,注冊過程我就不多說了,把用戶名,密碼填寫完就行了

  • 創建一個發布項目的issue

    創建地址:創建

    創建的注意事項:

    創建一個發布項目的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得到了回復,那么應該是如下這樣:

    issue的第一次回復

    2.issue的第二次得到回復

    因為我的項目是放在github上,並且用了io.github.fanyong920的域名作為groupId,所以對方要驗證fanyong920是不是我的賬號

    issue的第二次回復

    3.issue的第三次得到回復

    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中心了

issue第四次回復

一般在這時候,兩個小時左右,你的jar包就同步到了maven中心。

在未同步之前,你可以到https://search.maven.org 查看你的jar包的具體信息

jvppeteer版本信息

我的搜索出來就是這個樣子:

jvppeteer

我的爬蟲框架的坐標是:

<dependency>
  <groupId>io.github.fanyong920</groupId>
  <artifactId>jvppeteer</artifactId>
  <version>1.0.1</version>
</dependency>

如何發布快照版本?
在pom.xml中的項目版本號后面加上 -SNAPSHOT 就行
不需要執行關閉、發布構建步驟,(對應nexus-staging-maven-plugin的autoReleaseAfterClose)快照版發布后就可以直接引用了


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM