将github项目上传到Maven中央仓库操作小记

   之前写了一个工具类, 想着给他发到中央仓库其他项目引用, 查了很多资料, 写一篇操作博客记录一下  仓库地址

 1. 先注册 sonatype 账号

 官网地址: https://issues.sonatype.org/projects

 注册完成后访问 https://issues.sonatype.org/secure/CreateIssue.jspa?issuetype=21&pid=10134创建一个项目

2. 创建 sonatype 项目

这里的groupId 必须是 io.github 开头的  如果是 com.github 新会被驳回的, 填好信息后点击新建就可以了

 这时会跳转到项目详情页, 状态是开放, 意思就是待审核

 

  过一会刷新页面后发现被驳回了, 主要的问题是 groupId 必须 io.github.lijiahangmax 这里的 lijiahangmax 是我 github 的名称, 还需要用 lijiahangmax 这个账号创建一个名称为 OSSRH-78844 的临时仓库, 验证这是你的仓库

创建完成后点击 Respond 按钮重新提交审核

过一会刷新状态为 已解决 就已经创建完成了, 刚刚创建的临时仓库可以删除 

 注意: 这里也说明了发布地址, 下面会用到

 3. 下载 GPG 秘钥

下载地址：https://www.gpg4win.org/download.html

# 查看版本来检查
gpg --version
# 生成密钥对
gpg --gen-key
# 查看生成的公钥
gpg --list-keys
# 将公钥发布到GPG密钥服务器
gpg --keyserver hkp://keyserver.ubuntu.com:11371 --send-keys 公钥ID
# 查询是否已将公钥发布到服务器
gpg --keyserver hkp://keyserver.ubuntu.com:11371 --recv-keys 公钥ID

gpg --gen-key

生成秘钥 输入名称以及邮箱, 之后会弹出一个输入密码的框

查询上传的秘钥

gpg --list-keys

上传秘钥到服务器

gpg --keyserver hkp://keyserver.ubuntu.com:11371 --send-keys C65D0261F17DA6CAEDD09C329FC86145FECFF74F

查询是否上传成功

gpg --keyserver hkp://keyserver.ubuntu.com:11371 --recv-keys C65D0261F17DA6CAEDD09C329FC86145FECFF74F

我这里不知道为什么 返回No Data, 可能是网络问题, 重新在执行一次就好了

4. 发布 maven 库

  修改 setting.xml

<server>
   <id>oss</id>
   <username>刚刚注册的sonatype用户名</username>
   <password>刚刚注册的sonatype密码</password>
</server>

  修改项目的 pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>io.github.lijiahangmax</groupId>
    <version>1.0.1</version>
    <packaging>pom</packaging>
    <artifactId>orion-kit</artifactId>
    <name>${project.artifactId}</name>
    <description>orion dev kit</description>
    <url>https://github.com/lijiahangmax/orion-kit</url>

    <modules>
        <module>orion-lang</module>
        <module>orion-ext</module>
        <module>orion-office</module>
        <module>orion-log</module>
        <module>orion-http</module>
        <module>orion-net</module>
        <module>orion-web</module>
        <module>orion-redis</module>
        <module>orion-spring</module>
        <module>orion-generator</module>
        <module>orion-all</module>
    </modules>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
        <maven.compiler.charset>UTF-8</maven.compiler.charset>
        <maven.javadoc.failOnError>false</maven.javadoc.failOnError>
        <orion.parent.version>1.0.1</orion.parent.version>
        <orion.lang.version>1.0.1</orion.lang.version>
        <orion.ext.version>1.0.1</orion.ext.version>
        <orion.office.version>1.0.1</orion.office.version>
        <orion.log.version>1.0.1</orion.log.version>
        <orion.http.version>1.0.1</orion.http.version>
        <orion.net.version>1.0.1</orion.net.version>
        <orion.web.version>1.0.1</orion.web.version>
        <orion.redis.version>1.0.1</orion.redis.version>
        <orion.spring.version>1.0.1</orion.spring.version>
        <orion.generator.version>1.0.1</orion.generator.version>
        <orion.all.version>1.0.1</orion.all.version>
    </properties>

    <!-- license -->
    <licenses>
        <license>
            <name>MIT</name>
            <url>https://github.com/lijiahangmax/orion-kit/blob/master/LICENSE</url>
        </license>
    </licenses>

    <!-- scm -->
    <scm>
        <connection>scm:git:git@github.com:lijiahangmax/orion-kit.git</connection>
        <developerConnection>scm:git:git@github.com:lijiahangmax/orion-kit.git</developerConnection>
        <url>git@github.com:lijiahangmax/orion-kit.git</url>
    </scm>

    <!-- issue -->
    <issueManagement>
        <system>Github Issue</system>
        <url>https://github.com/lijiahangmax/orion-kit/issues</url>
    </issueManagement>

    <!-- developers -->
    <developers>
        <developer>
            <name>Jiahang Li</name>
            <email>li1553488@aliyun.com</email>
            <timezone>+8</timezone>
            <roles>
                <role>Developer</role>
            </roles>
        </developer>
    </developers>

    <build>
        <plugins>
            <!-- 编译插件 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <source>${maven.compiler.source}</source>
                    <target>${maven.compiler.target}</target>
                </configuration>
            </plugin>

            <!-- Javadoc -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-javadoc-plugin</artifactId>
                <version>3.1.1</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>jar</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>


    <profiles>
        <profile>
            <id>release</id>
            <distributionManagement>
                <snapshotRepository>
                    <id>oss</id>
                    <url>https://s01.oss.sonatype.org/content/repositories/snapshots/</url>
                </snapshotRepository>
                <repository>
                    <id>oss</id>
                    <url>https://s01.oss.sonatype.orgservice/local/staging/deploy/maven2/</url>
                </repository>
            </distributionManagement>
            <build>
                <plugins>
                    <!-- Source -->
                    <plugin>
                        <groupId>org.apache.maven.plugins</groupId>
                        <artifactId>maven-source-plugin</artifactId>
                        <version>3.2.1</version>
                        <executions>
                            <execution>
                                <id>oss</id>
                                <phase>package</phase>
                                <goals>
                                    <goal>jar-no-fork</goal>
                                </goals>
                            </execution>
                        </executions>
                    </plugin>
                    <!-- Gpg Signature -->
                    <plugin>
                        <groupId>org.apache.maven.plugins</groupId>
                        <artifactId>maven-gpg-plugin</artifactId>
                        <version>1.6</version>
                        <executions>
                            <execution>
                                <id>oss</id>
                                <phase>verify</phase>
                                <goals>
                                    <goal>sign</goal>
                                </goals>
                            </execution>
                        </executions>
                    </plugin>
                    <plugin>
                        <groupId>org.sonatype.plugins</groupId>
                        <artifactId>nexus-staging-maven-plugin</artifactId>
                        <version>1.6.8</version>
                        <extensions>true</extensions>
                        <configuration>
                            <serverId>oss</serverId>
                            <nexusUrl>https://s01.oss.sonatype.org</nexusUrl>
                            <autoReleaseAfterClose>true</autoReleaseAfterClose>
                        </configuration>
                    </plugin>
                </plugins>
            </build>
        </profile>
    </profiles>

</project>

这里的 pom.xml 我是参考 hutool 的配置

修改完后就可以deploy了  在cmd中执行命令: mvn -U clean deploy -P release -DskipTests -Dgpg.passphrase=刚刚输入的密码

注意: 执行的时候会弹出密码框, 需要输入刚刚生成的密码GPG密码

注意: 这里的 https://s01.oss.sonatype.org 是生成 sonitype 项目时, 机器人评论的那个地址, 不要复制错了

deploy 中可能会遇到很多个错误, 看看代码或者其他配置, 研究研究, 这里我遇到的错误有点多 就不配图片了, 很多都是粗心的问题, 不是什么大问题

 5.  在中央仓库发布

访问仓库并且登陆: https://s01.oss.sonatype.org/#welcome

账号密码就是刚刚注册是 sonitype 的账号密码

Staging Repositories > 勾选发布的服务 > 点击 close > 等待 close 完成 > 点击 release 就成功了 

 这里 close 可能失败

改完错误后重新 deploy

 老样子, 输入密码

 经过漫长的等待 deploy 终于成功了, 然后就去 Staging Repositories 找我刚刚发布的依赖 居然没有找到, 然后我搜索了一下, 就直接搜索到刚刚发布的依赖了, 这次没有点击 close 和 release, 这就很奇怪, 算是瞎猫碰到死耗子了吧 (我觉得可能是因为第一次 close 过了)

这时候我本地 maven 引入坐标是引不进来的, 百度了一下说是需要几个小时才能在公共仓找到, 然后我就去睡觉了, 第二天一早搜了一下发现真的成功了, 哈哈哈

 

 https://repo1.maven.org/maven2/io/github/

 https://search.maven.org/search?q=lijiahangmax

总结

这里面的坑还是很多的 , 很多东西都是慢慢百度来的, 有很多都是参照 这篇博客 慢慢搞的, 记录一下, 防止下次搞的时候不知道怎么弄 。

中央仓库不支持版本覆盖, 比如第一次成功deploy版本1.0.0, 第二次deploy版本1.0.0 会报错的, 第二次应该改为1.0.1或者更高才不会报错