android发布三方库到远程maven仓库详细教程

前提

为什么突然要使用maven了，jcenter可是google御用三方仓库，难道jcenter不香了吗？没错，jcenter就是不香了。当你升级AndroidStudio版本再次创建项目后发现build.gradle的文件仓库声明中jcenter()出现了一条横线并且后面出现了一行注释

这意味着jcenter已经被废弃，当你升级到Android Studio Arctic Fox | 2020.3.1 Patch 2之后已经不会出现jcenter()只有google()和mavenCentral()了。

android上几乎所有的第三方开源项目都会选择将库发布到jcenter，例如Glide、OkHttp、Rxjava等。google突然放弃jcenter可谓是影响到了所有的android开发者，那google为什么要这样做呢？是jcenter出什么问题了吗？吓得我赶紧去JFrog官网看看，不看不知道一看还真吓一跳

原来在 2021 年 02 月 03 日，JFrog发布了一篇名为《Into the Sunset on May 1st: Bintray, GoCenter, and ChartCenter》的博文，文章里说为了简化 JFrog 平台的工作效率，我们将于 2021 年 5 月 1 日停用 Bintray、GoCenter 和 ChartCenter 服务。JCenter 将不再接受任何提交。

虽然文章还指出将无限期的将JCenter 保留为只读存储库，但是只停留在当前版本了，那如果想使用最新版本怎么办，办法就是转移到maven仓库。

在开始之前，先对一些概念做一下了解是很必要的，后面用到的时候并不会挠头问这是个什么玩意

Sonatype

Sonatype是美国一家开源DevOps服务供应商，支持开源组件（中央仓），为开发者提供资源库管理器（Nexus）

OSSRH

OSSRH（Open Source Software Repository Hosting）是Sonatype 提供的一个开源软件资源库托管工具，帮助我们来方便的将项目发布到中心仓库中。它是项目所有者和贡献者将其组件发布到中央资源库的主要途径。

JIRA

JIRA是Atlassian公司出品的项目与事务跟踪工具，被广泛应用于缺陷跟踪、客户服务、需求收集、流程审批、任务跟踪、项目跟踪和敏捷管理等工作领域。

GPG

将项目发布到maven仓库的要求之一是它们已与 PGP 签署。GnuPG 或 GPG是 OpenPGP 标准的免费实现。GPG 提供了生成签名、管理密钥和验证签名的功能

下面介绍如何发布三方库到maven。

创建JIRA 帐户

注册地址：https://issues.sonatype.org/secure/Signup!default.jspa

创建新项目工单

地址：https://issues.sonatype.org/secure/CreateIssue.jspa?issuetype=21&pid=10134

Project：选择Community Support - Open Source Project Repository Hosting
(OSSRH)
Issue Type：选择New Project
Summary：写个标题做个简单概述你要做什么。真不知道写什么，直接把项目名称写上就行
Group Id：
- 有域名可以使用子域名作为Group Id 。例：自己的域名叫csdn.com，那么就用com.csdn.test作为Group Id
- 没域名如果有github账号也可以，例：io.github.github账号名

注意：com.github.* Group IDs已经无效

Project URL：填写该项目的Github地址
SCM url：只需要在上面的Github地址后面加上.git后缀即可

查看自己的项目工单：https://issues.sonatype.org/secure/Dashboard.jspa

审核人会根据你填写的GroupId，来要求你配合完成一些验证，会在comments里面回复你，我使用的是github所以让我在github中创建一个文件

如果验证通过那么你就会收到一条如下回复信息表示通过了，可以向maven发布了

使用 GPG 生成密钥对

下载gpg地址：https://gnupg.org/download/
我使用的是windows系统，所以这里只演示在windows下的操作
安装完成后打开cmd，执行

1. gpg --version //查看版本确认是否安装成功
2. gpg --full-generate-key //创建密钥
3. gpg --export-secret-keys -o secring.gpg //导出密钥，记住路径，后面在build.gradle中配置需要用到
4. gpg --keyserver keyserver.ubuntu.com --send-keys CA925CD6C9E8D064FF05B4728190C4130ABA0F98 //分发到密钥服务器，以便用户可以对其进行验证

注意：这里有个坑，坑了我很久，就是官方文档给出的创建密钥命令是

gpg --gen-key

我生成之后得到的公钥是这样的

注意看公钥是ed开头，也就是EDDSA加密算法，而官方使用相同的命令生成的密钥是这样的

是RSA加密算法，这就导致最后提交的时候怎么也不成功，这就是问题所在，所以需要使用gpg --full-generate-key去选择使用RSA的算法

配置gradle

在需要发布类库的build.gradle中添加

// 添加插件
apply plugin: 'maven'
apply plugin: 'signing'// 生成jar包的task
task sourcesJar(type: Jar) {from android.sourceSets.main.java.srcDirsclassifier = 'sources'
}artifacts {archives sourcesJar
}
// 签名
signing {sign configurations.archives
}group = "io.github.lonelypluto"// groupId
version = "3.0.11"// 库的当前版本uploadArchives {repositories {mavenDeployer {beforeDeployment { MavenDeployment deployment -> signing.signPom(deployment) }repository(url: "https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/") {authentication(userName: ossrhUsername, password: ossrhPassword)}snapshotRepository(url: "https://s01.oss.sonatype.org/content/repositories/snapshots/") {authentication(userName: ossrhUsername, password: ossrhPassword)}pom.project {name 'ExampleApplication'// 项目名称packaging 'aar'// 资源类型artifactId 'lib'// 库名description 'A application used as an example'// 描述url 'https://github.com/LonelyPluto/ExampleApplication'scm {connection 'scm:git@github.com:LonelyPluto/ExampleApplication.git'developerConnection 'git@github.com:LonelyPluto/ExampleApplication.git'url 'https://github.com/LonelyPluto/ExampleApplication'}licenses {license {name 'The Apache License, Version 2.0'url 'http://www.apache.org/licenses/LICENSE-2.0.txt'}}developers {developer {id 'manfred'// 开发者账号name 'Manfred Moser'// 名字email 'manfred@sonatype.com'// 邮箱}}}}}
}

在gradle.properties文件中添加签名和上传的凭据

signing.keyId=YourKeyId
signing.password=YourPublicKeyPassword
signing.secretKeyRingFile=PathToYourKeyRingFileossrhUsername=your-jira-id
ossrhPassword=your-jira-password

keyId：gpg中生成的pub的最后 8 个字符
例：CA925CD6C9E8D064FF05B4728190C4130ABA0F98，那么keyId就是0ABA0F98
password：生成pgp时填写的密码
secretKeyRingFile：导出gpg私钥时本地存储路径
例：E\:\\gpg\\secring.gpg实际就是E:\gpg\secring.gpg
ossrhUsername：开始注册JIRA的账号
ossrhPassword：JIRA密码

填写完信息点击Terminal执行命令

gradle uploadArchives

将库发布到中央存储库

地址：https://s01.oss.sonatype.org/#stagingRepositories
账号就是JIRA的账号，登录后点击左侧的Staging Repositories，然后右侧就会显示你所提交的库，如果库没有什么问题那么选中后点击上面工具栏的Close按钮

点击之后maven库会对你的库进行验证，验证完成后点击Close左边的Refresh按钮就会出现Release按钮，然后点击Release，至此发布完成。

完成之后需要等待半小时左右的时间才能使用，在此期间你注册JIRA的时候填写的邮箱会收到邮件通知

https://repo1.maven.org/maven2/ 30分钟之后可以在里面找到自己的库
https://search.maven.org 四个小时之后可以在里面找到自己的库

sonatype提供的官方文档