清晰的教你如何将 Maven 项目上传至中央仓库以及版本更新

提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

项目中总会依赖一些大牛的开源库，例如 Android 开发通过以下方式就可以方便的引入库。那么如何将我们自己的库也能这样来使用呢？下面我们将详细的讲解每一步的过程：

implementation 'io.github.meetsl:SCardView:1.0'

一、通过 sonatype 把你的开源库提交到Maven的中心库

1.首先，在sonatype 官网中注册账号。

2. 然后在 https://issues.sonatype.org/secure/CreateIssue.jspa?issuetype=21&pid=10134 中新建一个“Project ticket”。

点击 Create 之后，你就会进入一个 jira 页面(sonatype 使用jira 来追踪每一个项目进度)，与此同时你注册时使用的邮箱中也会收到一封邮件提示你，任务创建成功,正在等待处理。

3. 创建完毕后就等待一段时间，刷新页面。当状态变为“resolved”，然后你就可以使用Gradle上传项目了。或者就等着接收 sonatype 的反馈邮件，确认已经为你创建好了新项目

4. 上传项目到 Maven 中心仓库

示例项目是一个 Android 项目，所以通过在开源库的 Libray Module 下的 build.gradle 末尾添加如下配置：

apply plugin: 'maven'
apply plugin: 'signing'signing {
sign configurations.archives
}group = "io.github.meetsl"
archivesBaseName = "SCardView"
version = "1.0"uploadArchives {
repositories {
mavenDeployer {
beforeDeployment {
MavenDeployment deployment -> signing.signPom(deployment)
} repository(url: "https://oss.sonatype.org/service/local/staging/deploy/maven2/") {
authentication(userName: ossrhUsername, password: ossrhPassword)
} snapshotRepository(url: "https://oss.sonatype.org/content/repositories/snapshots/") {
authentication(userName: ossrhUsername, password: ossrhPassword)
} pom.project {
name 'SCardView'
packaging 'aar'
description 'This is a view that is similar to the CardView of google ，but it can change the position of shadow and the shadow color of it . '
url 'https://github.com/meetsl/SCardView-master' scm {
connection 'scm:git:https://github.com/meetsl/SCardView-master.git'
developerConnection 'scm:git:https://github.com/meetsl/SCardView-master.git'
url 'https://github.com/meetsl/SCardView-master.git'
} licenses {
license {
name 'The Apache License, Version 2.0'
url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
}
} developers {
developer {
id 'xxxxxx'
name 'xxxxxx'
email 'xxxxxxxx.com'
}
}
}
}
}
}

在上面的代码中，大家请将根域中的 group , archiveBaseName , version 以及 uploadArchives#pom.project 中的相关描述信息替换成自己的就好了。这些信息将会在接下来上传的时候，自动打包成 Maven 项目，并封装相应信息。

5. 上面配置好了相应的版本信息，接下来我们需要配置上传时需要的签名以及密码等相关信息

① 首先我们需要创建一个 gpg 签名秘钥，并将公钥上传到指定服务器。对于在 MacOS 下，我们可以下载一个叫做GPGTools （http://www.gpgtools.org）的工具生成我们的签名文件。在 Windows 下，我们下载安装一个 Kleopatra（https://www.gpg4win.org/thanks-for-download.html）工具生成我们的签名文件。这两个工具使用基本一致，在安装完成之后，新建一个密钥对，并将本地公钥上传到指定服务器。

② 上传完成之后，就可以正式配置签名信息以及你的 Maven 账户信息了，我们在 Library Module 的根目录下新建一个 gradle.properties 文件，内容如下:

signing.keyId= 密钥的ID （注意一下，密钥ID 是一个八个字节的字符串 Kleopatra工具需要悬浮在密钥ID 一栏查看）
signing.password= 密钥的密码 (生成证书时填写的密码)
signing.secretKeyRingFile=..\\secret.gpg（secret.gpg为私密证书。将导出的私密证书，放置在工程目录下）
ossrhUsername= sonatype 账号
ossrhPassword= sonatype 密码

配置成功之后，按照下图运行 uploadArchives 就可以开始上传了，这样就可以将你的文件上传到 Maven 中央库了

6. 将上传的开源库发布出去

通过上面的步骤，我们只是把开源库放置在了一个私有的 Maven 仓库中，是不能被其他人所访问的。所以还需要我们自己将它发布出去。那么如何发布：

① 进入 Maven 项目控制台

进入以下地址:https://oss.sonatype.org/，并使用 sonatype 的账号密码在右上角进行登录。

② 查找你上传的项目

如果你登录成功，在左侧的导航栏，你会看到一个叫做 Staging Repositories 的选项，点击它，你会发现出现了很多列表选项，如下图4。

根据列表名称，你会发现一个以你的 groud id 去掉点号后加上一个四位数字命名的Repository，选中它，你会发现上方的 Close 按钮亮起，当你确认上传无误之后，你可以点击 Close 按钮，关闭掉这个仓库，不允许再次上传。如果关闭成功，你点击刷新以后会发现，Release 按钮亮起，点击它即可发布。如果关闭失败，你可以看看下方的界面，查找一下失败原因，再次上传代码，关闭后发布。

当然我在 close 的时候遇到一个问题： No public key: Key with id: (XXXXX) was not able to be located (oss.sonatype.org) 出现这个问题的原因是 openGPG 的各种 key 服务同步需要花费时间，你在close 的时候还没有同步过去。就会出现这个问题。那么如何解决：stackoverflow https://stackoverflow.com/questions/19462617/no-public-key-key-with-id-xxxxx-was-not-able-to-be-located-oss-sonatype-org