将 jar 包发布到Maven中央仓库

这里列出一些发布过程中的注意点:

0. 项目的 pom 需要根据Sonatype OSSRH的要求进行整改

以下信息都必须配置:

  • Supply Javadoc and Sources
  • Sign Files with GPG/PGP
  • Sufficient Metadata
    • Correct Coordinates
    • Project Name, Description and URL
    • License Information
    • Developer Information
    • SCM Information

配置可以参考:https://www.cnblogs.com/fundebug/p/how-to-deploy-jar-to-maven-central-repository.html

 

1. javadocs 的验证非常严格,在上传 javadoc 时需要做降级处理,关闭doclint。
maven plugin 配置如下:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.9.1</version>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <phase>package</phase>
            <goals>
                <goal>jar</goal>
            </goals>
            <configuration>
                <additionalparam>-Xdoclint:none</additionalparam>
            </configuration>
        </execution>
    </executions>
</plugin>

see: https://blog.csdn.net/maikelsong/article/details/80828947

 

2. gpg 验证易出问题,建议手动下载 gpg4win 来进行配置
下载地址: https://gpg4win.org/download.html

 

3. gpg 签名验证如果报如下错
gpg: cannot open tty `no tty': No such file or directory
或者 找不到 gpg.exe
可以在 maven 中手动配置 gpg 地址:

<properties>
    <gpg.passphrase>生成密钥时输入的passphrase</gpg.passphrase>
    <!-- gpg.exe的绝对路径,在gpg安装目录下的bin目录中 -->
    <gpg.executable>C:\Program Files (x86)\GnuPG\bin\gpg.exe</gpg.executable>
    <!-- 上一步执行gpg - -list-key命令输出的路径,一般在C:\User\当前用户\AppData\Roaming\gnupg -->
    <gpg.homedir>C:/Users/Administrator/AppData/Roaming/gnupg</gpg.homedir>
</properties>

see: https://blog.csdn.net/qq_35433926/article/details/99317773

 

4. 如果 gps 签名正常,但发布后报找不到签名 key ,可以试着将 key 多发几个服务器:

gpg --keyserver http://pool.sks-keyservers.net:11371 --send-keys 200193FF0AFA3142D18C52411D90CBED00686B93
gpg --keyserver http://keyserver.ubuntu.com:11371 --send-keys 200193FF0AFA3142D18C52411D90CBED00686B93
gpg --keyserver http://keys.gnupg.net:11371 --send-keys 200193FF0AFA3142D18C52411D90CBED00686B93
gpg --keyserver http://keys.openpgp.org:11371 --send-keys 200193FF0AFA3142D18C52411D90CBED00686B93

 

5. 推荐 Staging Repositories 自动 colse 插件,可以不用去 sonatype 上手动 close

<!--Nexus Staging Maven插件是将组件部署到OSSRH并将其发布到Central Repository的推荐方法-->
<plugin>
    <groupId>org.sonatype.plugins</groupId>
    <artifactId>nexus-staging-maven-plugin</artifactId>
    <version>1.6.7</version>
    <extensions>true</extensions>
    <configuration>
        <serverId>ossrh</serverId>
        <nexusUrl>https://oss.sonatype.org/</nexusUrl>
        <autoReleaseAfterClose>true</autoReleaseAfterClose>
    </configuration>
</plugin>

注:maven settings.xml 中要配置 id 为 ossrh 的 server,为此 server 设置 sonatype 的用户名、密码 
形如:

<servers>
    <server>
      <id>snapshots</id>
      <username>kvn</username>
      <password>密码</password>
    </server>
    <server>
      <id>releases</id>
      <username>kvn</username>
      <password>密码</password>
    </server>
    <server>
      <id>ossrh</id>
      <username>kvn</username>
      <password>密码</password>
    </server>
</servers>
View Code

 

6. 如果 IDEA 当中 deploy 时失败,可以尝试使用 git bash 命令行来执行试试

git clean deploy -Dmaven.test.skip=true -Dgpg.passphrase=gpg密码

 

---------------------------------------------------------------------------

发布步骤可以参考:
https://blog.csdn.net/alinyua/article/details/83687250
https://blog.csdn.net/weixin_38096157/article/details/88951278
https://blog.csdn.net/qq_35433926/article/details/99317773

gpg配置:
http://c.biancheng.net/view/4832.html

百度搜索关键词可以出来很多教程:
使用gpg签名java工程发布到仓库

 

posted on 2020-04-10 11:30  快鸟  阅读(579)  评论(0编辑  收藏  举报