发布jar包到maven中央仓库(无个人域名)

发布jar包到maven中央仓库(无个人域名)

一、简介

1.1 概述

我们通常使用的Jar包,大多都是从镜像上拉取的,也有私人仓库,也有直接从Maven中央仓库拉取的,无论从镜像还是仓库,发布到中央仓库的jar包,都是可以直接拉取下来的。所以,当我们自己打包了一个jar包之后,打算开源出去装逼的时候,我们就可以将jar包发布到sonatype.org,这个地址看起来不是maven,但是发布上去之后,我们在mvnrepository.com和search.maven.org都可以看到自己的jar包了。

本文按照网上乱七八糟的方式上传过jar包,经过血与泪的洗礼,总结出了一套最简单实用的方式。

1.2 本篇重点

本篇先介绍下如何用git的域名来发布自己的jar包,下一篇介绍下如何用自己的域名来发布jar包。

1.3 地址

工单管理地址https://issues.sonatype.org/secure/Dashboard.jspa

说明:注册账号、创建和管理issue,Jar包的发布是以解决issue的方式起步的

Jar包上传地址https://oss.sonatype.org/#welcome

说明:使用maven提交后的jar包先到这个库中,可以用maven命令上传,也可以直接在界面上上传。

二、开始上传

2.1 创建工单

创建工单是必须的,也很简单,在工单管理中提交下jar包相关信息即可。

首先要注册账号,如果没有账号,需要先注册一个,记住用户名密码,后边要配置到setting.xml中。

点击Craete,弹出如下窗口:


在这里插入图片描述

必填项选择:

Project:Community Support - Open Source Project Repository Hosting

Issue Type:New Project

Summary:JAR包名称,如:JpaMapper

Group Id:你懂得,不用多说,如com.github.ffch,如果是个人域名,填写个人的groupId,如:cn.pomit

Project URL:项目站点,如:https://github.com/ffch/jpa-mapper,如果有项目主页,填写项目主页,如https://www.pomit.cn/jpa-mapper

SCM url:项目源码仓库,如:https://github.com/ffch/jpa-mapper.git

其他内容不用填写,默认即可。

创建Issue后,Sonatype的工作人员审核处理,一般一个工作日以内,当Issue的Status变为RESOLVED后,就可以进行下一步操作了。

使用Group Id为com.github.ffch申请过程如下:

在这里插入图片描述

2.2 配置Maven

2.2.1 配置setting.xml

setting.xml文件一般在当前用户文件夹的.m2文件夹下。

在servers中增加server配置

  <servers>
    <server>
      <id>sonatype-nexus-snapshots</id>
      <username>Sonatype 账号</username>
      <password>Sonatype 密码</password>
    </server>
    <server>
      <id>sonatype-nexus-staging</id>
      <username>Sonatype 账号</username>
      <password>Sonatype 密码</password>
    </server>
  </servers>

2.2.2 配置pom.xml

2.2.2.1 搜到的方法

网上的一般说要配置oss-parent,这样好处就是很多东西可以省掉。

如:

<parent>
    <groupId>org.sonatype.oss</groupId>
    <artifactId>oss-parent</artifactId>
    <version>7</version>
</parent>

再加上开发者信息:

<licenses>
    <license>
        <name>The Apache Software License, Version 2.0</name>
        <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
        <distribution>actable</distribution>
    </license>
</licenses>

<developers>
    <developer>
        <name>chenfufei</name>
        <email>fufeixiaoyu@163.com</email>
        <organization>chenfufei</organization>
        <url>https://github.com/ffch</url>
    </developer>
</developers>

<scm>
    <tag>master</tag>
    <url>git@github.com:ffch/jpa-mapper.git</url>
    <connection>scm:git:git@github.com:ffch/jpa-mapper.git</connection>
    <developerConnection>scm:git:git@github.com:ffch/jpa-mapper.git</developerConnection>
</scm>
2.2.2.2 我的方法

但是如果我们已经配置了一个parent,可能就不想用这种方式了,可以使用以下方式:

<?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>cn.pomit</groupId>
    <artifactId>jpa-mapper</artifactId>
    <version>2.0</version>
    <packaging>pom</packaging>

    <name>jpa-mapper</name>
    <description>jpa code for mybatis</description>
    <url>https://www.pomit.cn/jpa-mapper</url>
    
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <mybatis.version>3.4.6</mybatis.version>
        <mybatis-spring.version>1.3.2</mybatis-spring.version>
        <mybatis-spring-boot.version>1.3.0</mybatis-spring-boot.version>
        <spring-boot.version>2.0.0.RELEASE</spring-boot.version>
        <jpa.version>1.0</jpa.version>
        <jpa-mapper.version>1.2.2</jpa-mapper.version>
    </properties>
    <licenses>
        <license>
            <name>The Apache Software License, Version 2.0</name>
            <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
            <distribution>actable</distribution>
        </license>
    </licenses>

    <developers>
        <developer>
            <name>chenfufei</name>
            <email>fufeixiaoyu@163.com</email>
            <organization>chenfufei</organization>
            <url>https://github.com/ffch</url>
        </developer>
    </developers>

    <scm>
        <tag>master</tag>
        <url>git@github.com:ffch/jpa-mapper.git</url>
        <connection>scm:git:git@github.com:ffch/jpa-mapper.git</connection>
        <developerConnection>scm:git:git@github.com:ffch/jpa-mapper.git</developerConnection>
    </scm>
    <distributionManagement>
        <snapshotRepository>
            <id>sonatype-nexus-snapshots</id>
            <name>Sonatype Nexus Snapshots</name>
            <url>https://oss.sonatype.org/content/repositories/snapshots</url>
        </snapshotRepository>
        <repository>
            <id>sonatype-nexus-staging</id>
            <name>Nexus Release Repository</name>
            <url>https://oss.sonatype.org/service/local/staging/deploy/maven2/</url>
        </repository>
    </distributionManagement>
    
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>javax.persistence</groupId>
                <artifactId>persistence-api</artifactId>
                <version>${jpa.version}</version>
            </dependency>
            <dependency>
                <groupId>org.mybatis.spring.boot</groupId>
                <artifactId>mybatis-spring-boot-autoconfigure</artifactId>
                <version>${mybatis-spring-boot.version}</version>
            </dependency>
            <dependency>
                <groupId>org.mybatis</groupId>
                <artifactId>mybatis</artifactId>
                <version>${mybatis.version}</version>
            </dependency>
            <dependency>
                <groupId>org.mybatis</groupId>
                <artifactId>mybatis-spring</artifactId>
                <version>${mybatis-spring.version}</version>
            </dependency>
            <dependency>
                <groupId>cn.pomit</groupId>
                <artifactId>jpa-mapper-spring-boot-autoconfigure</artifactId>
                <version>${jpa-mapper.version}</version>
            </dependency>
            <dependency>
                <groupId>cn.pomit</groupId>
                <artifactId>jpa-mapper-spring-boot-starter</artifactId>
                <version>${jpa-mapper.version}</version>
            </dependency>
            <dependency>
                <groupId>cn.pomit</groupId>
                <artifactId>jpa-mapper-core</artifactId>
                <version>${jpa-mapper.version}</version>
            </dependency>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>${spring-boot.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <profiles>
        <profile>
            <id>sonatype-oss-release</id>
            <build>
                <plugins>
                    <plugin>
                        <groupId>org.apache.maven.plugins</groupId>
                        <artifactId>maven-source-plugin</artifactId>
                        <version>2.1.2</version>
                        <executions>
                            <execution>
                                <id>attach-sources</id>
                                <goals>
                                    <goal>jar-no-fork</goal>
                                </goals>
                            </execution>
                        </executions>
                    </plugin>
                    <plugin>
                        <groupId>org.apache.maven.plugins</groupId>
                        <artifactId>maven-javadoc-plugin</artifactId>
                        <version>2.9.1</version>
                        <executions>
                            <execution>
                                <id>attach-javadocs</id>
                                <goals>
                                    <goal>jar</goal>
                                </goals>
                            </execution>
                        </executions>
                        <configuration>
                            <aggregate>true</aggregate>
                            <javadocExecutable>${JAVA_HOME}/bin/javadoc</javadocExecutable>
                        </configuration>
                    </plugin>
                    <plugin>
                        <groupId>org.apache.maven.plugins</groupId>
                        <artifactId>maven-gpg-plugin</artifactId>
                        <version>1.1</version>
                        <executions>
                            <execution>
                                <id>sign-artifacts</id>
                                <phase>verify</phase>
                                <goals>
                                    <goal>sign</goal>
                                </goals>
                            </execution>
                        </executions>
                    </plugin>
                </plugins>
            </build>
        </profile>
    </profiles>
    <modules>
        <module>jpa-mapper-spring-boot</module>
        <module>jpa-mapper-core</module>
    </modules>
</project>

2.3 配置gpg-key

如果是使用的windows,可以下载gpg4win,地址:https://www.gpg4win.org/download.html,安装后在命令行中执行

gpg --gen-key

生成,过程中需要填写名字、邮箱等,其他步骤可以使用默认值,不过有个叫:Passphase的参数需要记住,这个相当于是是密钥的密码,下一步发布过程中进行签名操作的时候会用到。

命令执行之后,会提示输入真实姓名和邮箱,之后提示输入密码。


在这里插入图片描述

之后会得到pub,上图中深色部分
将pub上传到key验证库

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

2.4 上传Jar包

使用maven命令上传jar包:

mvn clean deploy -P sonatype-oss-release -Darguments="gpg.passphrase=密钥密码"

实际操作过程中,-Darguments="gpg.passphrase=密钥密码"不写会提示输入密码,我这里写了还是提示了。

使用maven命令部署会更好一点,因为我用eclipse没部署成功,提示出错,eclipse是这样玩的:


在这里插入图片描述

这个过程也是很让人崩溃的,特别慢,而且上传完成之后还是有很多问题。下面介绍一种快捷上传的方式。

2.5 快捷上传jar包

使用maven命令上传多个jar包时,sonatype会自动把项目分割成多个Repository,这样close的时候就会校验失败,因为这个原因,上传了n次,不得不另辟蹊径。

失败情况如图,不是asc文件没有,而是在第二个Repository中,close的时候就失败了:


在这里插入图片描述

因此,我们不能用这种方式,我们可以在页面上直接上传:

先drop掉失败记录(个人强迫证),点击左侧的staging-upload,选择自己的pom文件和其他文件上传

Select Artifact(s) for Upload按钮点了选择文件之后,要点Add Artifact按钮将文件放置到Artifacts列表框中。
Description必填,但随意。

如图:

在这里插入图片描述

三、Jar入库

经过漫长的等待,jar包可能应该已经上传到stagingRepositories了。

如图所示,我们可以在右上角的搜索框输入关键字查找我们的jar包。多个jar包的上传,会出现多个Repository,点击相应的Repositories,可以查看内容。

图示:


在这里插入图片描述

3.1 校验Jar包

选择列表中的Repositories,多个Repositories要同时选定,此时的构件状态为open,点击上方的close–>Confirm。

在下边的Activity选项卡中查看状态,当状态变成closed后,执行Release–>Confirm,并在下边的Activity选项卡中查看状态。

成功后构件自动删除,一小段时间(约1-2个小时)后即可同步到maven的中央仓库。

下一篇介绍下如何用自己的域名来发布jar包。步骤类似,前面部分略有不同,需要配置其他东西。

四、 JpaMapper

JpaMapper官方地址:
https://www.pomit.cn/jpa-mapper/

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 201,468评论 5 473
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,620评论 2 377
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 148,427评论 0 334
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,160评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,197评论 5 363
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,334评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,775评论 3 393
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,444评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,628评论 1 295
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,459评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,508评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,210评论 3 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,767评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,850评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,076评论 1 258
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,627评论 2 348
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,196评论 2 341