Android Studio使用Gradle上传AAR至Maven

这几天有个开源library要上传到Maven Central Repository，找到某大神的博客，他用Maven上传的库，我依葫芦画瓢搞了两天，卧槽，可能是人品问题，mvn一直报一个莫名其妙的异常，Google了半天完全没有头绪，恨死那个Windows的黑框框了。

后来从国外某大神的开源project那学到到可以用Gradle来上传AAR到maven central repository，终于可以和那个坑爹的黑框框说good bye了- -

前期工作

前期我们要做一些准备工作，包括：

注册Sonatype帐号
创建一个JIRA ticket

打开Sonatype JIRA注册帐号，注册好之后打开Create Issue创建一个JIRA ticket，一个JIRA ticket对应一个项目。

其中Summary填写项目名，例如AndroidTagGroup；Description填写项目描述；Group Id必须是项目包名的父级，比如我的包名为me.gujun.android.taggroup，那么为了我所有的项目都可以发布，Group Id填写为me.gujun。

其它按照提示填写，完成后大概两个工作日左右，该issue会变成RESOLVED状态，表示可用，在可用前除了最后一步正式发布之外，其它都可以正常进行。

使用GnuPG生成密钥

发布release版本时需要对上传的文件加密和签名，GPG用于生成签名，管理密钥。

上传前我们需要做两件事：

生成密钥对
上传密钥

安装

下载地址：GPG、GPG for Windows

安装之后验证一下

$ gpg --versiongpg (GnuPG) 2.0.26 (Gpg4win 2.2.3)
libgcrypt 1.6.2
Copyright (C) 2013 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>

生成密钥

$ gpg --gen-key

除了姓名、邮箱、备注外其它都可以使用默认设置，最后需要输入一个passphrase，妥善保管这个口令，后面配置Gradle脚本时需要用到。

查看密钥

查看公钥：

$ gpg --list-keysC:/Users/PingGe/AppData/Roaming/gnupg/pubring.gpg
-------------------------------------------------
pub   2048R/F874D485 2015-02-10
uid       [ultimate] JunGu (Sonatype) <2dxgujun@gmail.com>
sub   2048R/F27758E5 2015-02-10

输出的路径为公钥文件，F874D485为keyId，需要上传给服务器。

查看私钥：

$ gpg --list-secret-keysC:/Users/PingGe/AppData/Roaming/gnupg/secring.gpg
-------------------------------------------------
sec   2048R/F874D485 2015-02-10
uid                  JunGu (Sonatype) <2dxgujun@gmail.com>
ssb   2048R/F27758E5 2015-02-10

私钥文件路径在配置Gradle脚本时需要用到。

上传公钥

$ gpg --keyserver hkp://pool.sks-keyservers.net --send-keys F874D485gpg: sending key F874D485 to hkp server pool.sks-keyserver.net

把之前生成的公钥上传至服务器，系统需要你上传的公钥来验证发布时的文件。

F874D485为之前生成的公钥的keyId，一旦提交至一个key server，公钥会自动同步到其它key server。

配置Gradle脚本

Gradle脚本使用了开源项目gradle-mvn-push，Thx Chris大神!

添加maven-push.gradle

把下面的脚本复制到工程目录，新建文件maven-push.gradle。

/*
 * Copyright 2013 Chris Banes
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */apply plugin: 'maven'
apply plugin: 'signing'def isReleaseBuild() {return VERSION_NAME.contains("SNAPSHOT") == false
}def getReleaseRepositoryUrl() {return hasProperty('RELEASE_REPOSITORY_URL') ? RELEASE_REPOSITORY_URL: "https://oss.sonatype.org/service/local/staging/deploy/maven2/"
}def getSnapshotRepositoryUrl() {return hasProperty('SNAPSHOT_REPOSITORY_URL') ? SNAPSHOT_REPOSITORY_URL: "https://oss.sonatype.org/content/repositories/snapshots/"
}def getRepositoryUsername() {return hasProperty('NEXUS_USERNAME') ? NEXUS_USERNAME : ""
}def getRepositoryPassword() {return hasProperty('NEXUS_PASSWORD') ? NEXUS_PASSWORD : ""
}afterEvaluate { project ->uploadArchives {repositories {mavenDeployer {beforeDeployment { MavenDeployment deployment -> signing.signPom(deployment) }pom.groupId = GROUPpom.artifactId = POM_ARTIFACT_IDpom.version = VERSION_NAMErepository(url: getReleaseRepositoryUrl()) {authentication(userName: getRepositoryUsername(), password: getRepositoryPassword())}snapshotRepository(url: getSnapshotRepositoryUrl()) {authentication(userName: getRepositoryUsername(), password: getRepositoryPassword())}pom.project {name POM_NAMEpackaging POM_PACKAGINGdescription POM_DESCRIPTIONurl POM_URLscm {url POM_SCM_URLconnection POM_SCM_CONNECTIONdeveloperConnection POM_SCM_DEV_CONNECTION}licenses {license {name POM_LICENCE_NAMEurl POM_LICENCE_URLdistribution POM_LICENCE_DIST}}developers {developer {id POM_DEVELOPER_IDname POM_DEVELOPER_NAME}}}}}}signing {required { isReleaseBuild() && gradle.taskGraph.hasTask("uploadArchives") }sign configurations.archives}task apklib(type: Zip){appendix = extension = 'apklib'from 'AndroidManifest.xml'into('res') {from 'res'}into('src') {from 'src'}}task androidJavadocs(type: Javadoc) {source = android.sourceSets.main.java.srcDirsclasspath += project.files(android.getBootClasspath() .join(File.pathSeparator))}task androidJavadocsJar(type: Jar, dependsOn: androidJavadocs) {classifier = 'javadoc'from androidJavadocs.destinationDir}task androidSourcesJar(type: Jar) {classifier = 'sources'from android.sourceSets.main.java.srcDirs}artifacts {archives androidSourcesJararchives androidJavadocsJararchives apklib}
}

配置Project属性

在工程目录下的gradle.properties文件中设置属性，把属性修改成自己的。

VERSION_NAME=1.0
VERSION_CODE=1
GROUP=me.gujun.android.taggroupPOM_DESCRIPTION=Android Library to display a set of tags
POM_URL=https://github.com/2dxgujun/AndroidTagGroup
POM_SCM_URL=https://github.com/2dxgujun/AndroidTagGroup
POM_SCM_CONNECTION=scm:https://github.com/2dxgujun/AndroidTagGroup.git
POM_SCM_DEV_CONNECTION=scm:https://github.com/2dxgujun/AndroidTagGroup.git
POM_LICENCE_NAME=The Apache Software License, Version 2.0
POM_LICENCE_URL=http://www.apache.org/licenses/LICENSE-2.0.txt
POM_LICENCE_DIST=repo
POM_DEVELOPER_ID=2dxgujun
POM_DEVELOPER_NAME=Jun GuSNAPSHOT_REPOSITORY_URL=https://oss.sonatype.org/content/repositories/snapshots
RELEASE_REPOSITORY_URL=https://oss.sonatype.org/service/local/staging/deploy/maven2

注意：VERSION_NAME后面加-SNAPSHOT表示发布的是版本快照。

GROUP设置成项目包名，注意，父级要和之前创建JIRA ticket时的Group Id一致。

配置Project构建脚本

之后修改工程目录下的build.gradle：

buildscript {repositories {jcenter()}dependencies {classpath 'com.android.tools.build:gradle:1.0.1'}
}allprojects {version = VERSION_NAMEgroup = GROUPrepositories {jcenter()}
}

配置Module属性

工程配置好之后，我们还需要给上传的Module配置（我们的工程中可能有多个Module需要上传到仓库中，要给每个Module添加配置）

给需要上传到Maven仓库的Module提供一个gradle.properties文件：

POM_NAME=Android TagGroup Library
POM_ARTIFACT_ID=library
POM_PACKAGING=aar

POMARTIFACTID设置成Module名。

这个组件对应的依赖已经浮出水面了：GROUP:POMARTIFACTID:VERSION_NAME

即

me.gujun.android.taggroup:library:1.0

配置Module构建脚本

修改Module目录的build.gradle，在最后加上：

apply from: '../maven-push.gradle'

配置全局属性

这个全局的Gradle配置文件默认在USER_HOME/.gradle/gradle.properties，没有的话可以新建一个。

在这里配置Maven服务器的用户名和密码，还需要配置之前生成的keyId, password和一个secretKeyRingFile，这个文件用来在上传release版本时对文件进行签名。

NEXUS_USERNAME=2dxgujun
NEXUS_PASSWORD=123456signing.keyId=F874D485
signing.password=123456
signing.secretKeyRingFile=C:/Users/PingGe/AppData/Roaming/gnupg/secring.gpg

Windows的secretKeyRingFile路径如上所示，其它系统可以使用gpg --list-secret-keys命令查看。

部署release版本

所有的配置已经完成，现在可以上传了，在Android Studio的Terminal输入命令：

gradle uploadArchives

如果上传成功，最后你会看到控制台打印类似的信息：

Uploading: me/gujun/android/taggroup/library/1.0/library-1.0.aar to repository remote at https://oss.sonatype.org/service/local/staging/deploy/maven2
Transferring 19K from remote
Uploaded 19K
Uploading: me/gujun/android/taggroup/library/1.0/library-1.0.aar.asc to repository remote at https://oss.sonatype.org/service/local/staging/deploy/maven2
Transferring 0K from remote
Uploaded 0K
Uploading: me/gujun/android/taggroup/library/1.0/library-1.0-sources.jar to repository remote at https://oss.sonatype.org/service/local/staging/deploy/maven2
Transferring 7K from remote
Uploaded 7K
Uploading: me/gujun/android/taggroup/library/1.0/library-1.0-sources.jar.asc to repository remote at https://oss.sonatype.org/service/local/staging/deploy/maven2
Transferring 0K from remote
Uploaded 0K
Uploading: me/gujun/android/taggroup/library/1.0/library-1.0.apklib to repository remote at https://oss.sonatype.org/service/local/staging/deploy/maven2
Transferring 11K from remote
Uploaded 11K
Uploading: me/gujun/android/taggroup/library/1.0/library-1.0.apklib.asc to repository remote at https://oss.sonatype.org/service/local/staging/deploy/maven2
Transferring 0K from remote
Uploaded 0K
Uploading: me/gujun/android/taggroup/library/1.0/library-1.0-javadoc.jar to repository remote at https://oss.sonatype.org/service/local/staging/deploy/maven2
Transferring 34K from remote
Uploaded 34K
Uploading: me/gujun/android/taggroup/library/1.0/library-1.0-javadoc.jar.asc to repository remote at https://oss.sonatype.org/service/local/staging/deploy/maven2
Transferring 0K from remote
Uploaded 0K
Uploading: me/gujun/android/taggroup/library/1.0/library-1.0.pom.asc to repository remote at https://oss.sonatype.org/service/local/staging/deploy/maven2
Transferring 0K from remote
Uploaded 0K

上传成功后，打开Sonatype Nexus Professional登录，选择左侧Build Promotion菜单中的Staging Repositories选项，在出现的选项卡右上角的搜索框输入关键字，筛选出你上传的组件所在的repository。

部署时创建的repository会根据部署项目的groupId来命名，例如我的groupId为me.gujun，那么我的repository即为megujun-xxxx，后面的xxxx为4个数字，初次部署为1000，后面每次部署这个数字都会+1。选择这个repository，列表下面的面板会显示一些详细信息。

正式发布

部署完成之后，上传的组件会存储在一个独立的临时staging repository，在正式发布之前如果你在测试时遇到任何问题，都可以删除这个staging repository，在修复之后重新部署。正式发布才会同步到maven central repository。

通常情况下正式发布操作需要手动完成。

首先打开Sonatype Nexus Professional登录，打开Staging Repositories列表，筛选出之前部署的repository。

部署完成之后，这个repository会处于Open状态，你可以切换到Content标签页检查这个repository，如果确信没有问题，可以点击列表上面的Close按钮，这样会触发系统对这个repository进行评估。

如果你的组件不满足评估要求，Close操作会失败。

遇到这种情况，可以切换到Activity标签查看系统评估时出现的具体问题，修复问题，再尝试Close操作；如果需要重新部署，可以点击列表上面的Drop按钮删除这个repository，在本地修改之后，再重新部署。

成功close之后，可以点击Release按钮正式发布repository，组件会被移动到OSSRH的release repository，这个仓库会同步到maven central repository。

注意：如果你是第一次发布，需要到之前创建的JIRA ticket评论一下，告诉他们你已经release了，需要同步下。

Gradle文件的配置可以参考我的项目：AndroidTagGroup

我的JIRA ticket：OSSRH-13721

遇到问题

androidJavadocs 错误: 编码GBK的不可映射字符。

解决方法：把中文注释替换成英文注释。

androidJavadocs task 错误：不允许使用自关闭元素。

解决方法：删除注释中<br/>、<p/>之类的标签，把整段注释内容使用<p></p>标签包裹起来。

Close时评估出现错误：Failed: Signature Validation

解决方法：重试上传GPG生成的keyId

备注

在正式发布时可能会出现403错误：

Release failed
Nexus returned an error: ERROR 403： Forbidden

这是因为之前创建的JIRA ticket的状态还未变成RESOLVED，等待可用既可。

参考：

Working with PGP signatures
Releasing the deployment
Release the deployment to the central repository

本文出自2dxgujun，转载时请注明出处及相应链接。