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