這幾天有個開源library要上傳到Maven Central Repository，找到某大神的博客，他用Maven上傳的庫，我依葫蘆畫瓢搞了兩天，臥槽，可能是人品問題，mvn一直報一個莫名其妙的異常，Google了半天完全沒有頭緒，恨死那個Windows的黑框框了。

后來從國外某大神的開源project那學到到可以用Gradle來上傳AAR到maven central repository，終于可以和那個坑爹的黑框框說good bye了- -

前期工作

前期我們要做一些準備工作，包括：

注冊Sonatype帳號

創(chuàng)建一個JIRA ticket

打開Sonatype JIRA注冊帳號，注冊好之后打開Create Issue創(chuàng)建一個JIRA ticket，一個JIRA ticket對應一個項目。

其中Summary填寫項目名，例如AndroidTagGroup；Description填寫項目描述；Group Id必須是項目包名的父級，比如我的包名為me.gujun.android.taggroup，那么為了我所有的項目都可以發(fā)布，Group Id填寫為me.gujun。

其它按照提示填寫，完成后大概兩個工作日左右，該issue會變成RESOLVED狀態(tài)，表示可用，在可用前除了最后一步正式發(fā)布之外，其它都可以正常進行。

使用GnuPG生成密鑰

發(fā)布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

把之前生成的公鑰上傳至服務器，系統(tǒng)需要你上傳的公鑰來驗證發(fā)布時的文件。

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表示發(fā)布的是版本快照。

GROUP設置成項目包名，注意，父級要和之前創(chuàng)建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路徑如上所示，其它系統(tǒng)可以使用gpg --list-secret-keys命令查看。

部署release版本

所有的配置已經完成，現(xiàn)在可以上傳了，在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選項，在出現(xiàn)的選項卡右上角的搜索框輸入關鍵字，篩選出你上傳的組件所在的repository。

部署時創(chuàng)建的repository會根據部署項目的groupId來命名，例如我的groupId為me.gujun，那么我的repository即為megujun-xxxx，后面的xxxx為4個數字，初次部署為1000，后面每次部署這個數字都會+1。選擇這個repository，列表下面的面板會顯示一些詳細信息。

正式發(fā)布

部署完成之后，上傳的組件會存儲在一個獨立的臨時staging repository，在正式發(fā)布之前如果你在測試時遇到任何問題，都可以刪除這個staging repository，在修復之后重新部署。正式發(fā)布才會同步到maven central repository。

通常情況下正式發(fā)布操作需要手動完成。

首先打開Sonatype Nexus Professional登錄，打開Staging Repositories列表，篩選出之前部署的repository。

部署完成之后，這個repository會處于Open狀態(tài)，你可以切換到Content標簽頁檢查這個repository，如果確信沒有問題，可以點擊列表上面的Close按鈕，這樣會觸發(fā)系統(tǒng)對這個repository進行評估。

如果你的組件不滿足評估要求，Close操作會失敗。

遇到這種情況，可以切換到Activity標簽查看系統(tǒng)評估時出現(xiàn)的具體問題，修復問題，再嘗試Close操作；如果需要重新部署，可以點擊列表上面的Drop按鈕刪除這個repository，在本地修改之后，再重新部署。

成功close之后，可以點擊Release按鈕正式發(fā)布repository，組件會被移動到OSSRH的release repository，這個倉庫會同步到maven central repository。

注意：如果你是第一次發(fā)布，需要到之前創(chuàng)建的JIRA ticket評論一下，告訴他們你已經release了，需要同步下。

Gradle文件的配置可以參考我的項目：AndroidTagGroup

我的JIRA ticket：OSSRH-13721

遇到問題

androidJavadocs 錯誤: 編碼GBK的不可映射字符。

解決方法：把中文注釋替換成英文注釋。

androidJavadocs task 錯誤：不允許使用自關閉元素。

解決方法：刪除注釋中<br/>、<p/>之類的標簽，把整段注釋內容使用<p></p>標簽包裹起來。

Close時評估出現(xiàn)錯誤：Failed: Signature Validation

解決方法：重試上傳GPG生成的keyId

備注

在正式發(fā)布時可能會出現(xiàn)403錯誤：

Release failed Nexus returned an error: ERROR 403： Forbidden

這是因為之前創(chuàng)建的JIRA ticket的狀態(tài)還未變成RESOLVED，等待可用既可。

參考：

Working with PGP signatures

Releasing the deployment

Release the deployment to the central repository

本文出自2dxgujun，轉載時請注明出處及相應鏈接。

總結

以上是生活随笔為你收集整理的Android Studio使用Gradle上传AAR至Maven的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。