Android Studio 上傳aar(Library)到JCenter

目的

這篇文章介紹通過Gradle把開源項目發布到公共倉庫JCenter中,發布自己的android library(也就是aar)到公共的jcenter倉庫。
為什么選擇JCenter,因為JCenter現在是Android Studio中repositories的默認節點了,之前是Maven的,不過JCenter是兼容Maven的。

環境

Android Studio 2.2.3

參考資料
http://www.lxweimin.com/p/c4f4894ad215
http://www.lxweimin.com/p/6a6eca8c24c4
http://www.cnblogs.com/qianxudetianxia/p/4322331.html

申請Bintray賬號

bintray上注冊一個賬號 建議注冊個人賬號
可以使用github賬號直接授權登陸。

很重要,由于 Bintray網站 改版了,增加了Organization的概念。如果點擊中間那個大大的綠色按鈕,用那個點了注冊就錯了!! 變成了注冊一個組織,注冊地址是 https://bintray.com/signup 提交aar的時候就會出現Unauthorized這個錯誤 注意:個人的注冊地址為https://bintray.com/signup/oss

點擊首頁默認注冊的是組織號
個人注冊
登錄

天大的坑!一開始就進入了上面的坑到最后提交上傳aar的時候一直上傳不上去!!!,查閱相關資料后才爬出坑....得注冊個人號 組織號如何提交待研究

404
Unauthorized

記錄API Key

注冊后,在https://bintray.com/profile/edit 中查看,首次查看的時候提示需要輸入登錄密碼確認。

組織號的查看API Key
個人號的查看API Key

創建maven倉庫

Add New Repository
創建maven倉庫

配置build.gradle

配置插件上傳到bintray需要的插件

項目級別的`build.gradle`中添加依賴
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.0'
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.4.1'

插件版本過低可能遇到如下的異常

解決方案:http://www.lxweimin.com/p/c4f4894ad215

然后在你需要發布的那個module(即是library aar)的build.gradle里配置如下內容:

1、配置插件
// 根節點添加
apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'
2、配置版本
// 根節點添加
version = "0.0.1"

3、定義相關網站
// 根節點添加
def siteUrl = 'https://github.com/Javen205/JPay'    // project homepage
def gitUrl = 'https://github.com/Javen205/JPay.git' // project git 
4、定義Group

舉個例子,當我們引用retrofit的時候是這樣的:

compile 'com.squareup.retrofit2:retrofit:2.1.0

引號內字符串以冒號分割為三部分,第一部分就是group,第二部分是name, 第三部分是上面定義的version。

// 根節點添加
group = "com.javen205.jpay"

上傳到jcenter至少需要四個文件,除了打包的aar之外,還需要pom和javadoc,source,否則是通不過jcenter的審核。這些我們都可以用腳本生成。

5、打包javadocjar和sourcejar

這也是上傳到jcenter必須要的。

task sourcesJar(type: Jar) {
    from android.sourceSets.main.java.srcDirs
    classifier = 'sources'
}
task javadoc(type: Javadoc) {
    source = android.sourceSets.main.java.srcDirs
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}
task javadocJar(type: Jar, dependsOn: javadoc) {
    classifier = 'javadoc'
    from javadoc.destinationDir
}
artifacts {
    archives javadocJar
    archives sourcesJar
}
6、定義pom并打包aar
// 根節點添加
install {
    repositories.mavenInstaller {
        // This generates POM.xml with proper parameters
        pom {
            project {
                packaging 'aar'
                name 'JPay For Android'
                url siteUrl
                // Set your license
                licenses {
                    license {
                        name 'The Apache Software License, Version 2.0'
                        url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                    }
                }
                developers {
                    developer { //填寫的一些基本信息
                        id 'javen205'
                        name 'javen.zhou'
                        email 'javen205@126.com'
                    }
                }
                scm {
                    connection gitUrl
                    developerConnection gitUrl
                    url siteUrl
                }
            }
        }
    }
}
7、上傳到Jcenter倉庫

上傳到jcenter的網站Bintray,需要用戶驗證:

bintrayUser=your_user_name 我這里為javendev
bintrayApiKey=your_apikey 就是在上面記錄的API Key

這個屬于個人隱私,一般不傳,所以需要在記錄到項目下的local.properties中(利用gitignore忽略這個文件到git),然后腳本再從local.properties中讀取這兩個值。

//配置bintray參數
Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
bintray {
    user = properties.getProperty("bintrayUser")
    key = properties.getProperty("bintrayApiKey")
    configurations = ['archives']
    pkg {
        repo = "maven"               //跟上面創建的Maven倉庫名字保持一致
        name = "JPay"                //發布到JCenter上的項目名字
        websiteUrl = siteUrl
        vcsUrl = gitUrl
        licenses = ["Apache-2.0"]
        publish = true
    }
}

準備工作終于都做完了,我們開始使用插件自動上傳aar到bintray。如果一切順利的話就可以完成上傳

使用插件自動上傳aar到bintray

誰便填寫一個repoName

誰便填寫一個repoName

不填寫repoName

不填寫reopName
查看maven Rep
JPay上傳成功

重復提交

重復提交

將庫提交到JCenter,點擊右側的Add to JCenter

Paste_Image.png

出現這個錯誤的原因是執行腳本時并沒有默認生成pom-default.xml以及相關的文檔和jar,添加到JCenter又必須需要,以下是解決方案

點擊

可以在Terminal中執行如下命令如果成功了就會在Lib工程build目錄中自動生成docs libs

 ./gradlew clean build bintrayUpload

可能會遇到的錯誤
Fix the issues identified by lint, or add the following to your build script...

正常情況下會生成以下文件

以上問題解決了,我們在maven中刪除之前上傳的,再次上傳arr到bintray,成功之后再點擊右側的Add to JCenter

Add to JCenter

然后直接send就行(提交JCenter后groupID和在本地定義的一樣,所以本地定義groupID要能標識個人,最好到 https://jcenter.bintray.com 看下有沒有重復的包名

最后耐心等待Bintray審核通過。

其實我們的aar 已近上傳到的Maven中我可以可以直接引用,上傳到JCenter 就不再需要定義自己maven倉庫地址,直接compile即可。

已上傳到自己的Maven倉庫

引用自己的庫

1、Maven方式引用自己的庫

只要在root下的build加上自己maven地址

maven{
     url "https://dl.bintray.com/javendev/maven"
    }

然后在app的build中加上引用即可

compile 'com.javen205.jpay:jpaylib:0.0.1'
2、compile方式引用自己的庫

如果上面添加到JCenter審核通過,就可以直接在app的build中加上引用即可

compile 'com.javen205.jpay:jpaylib:0.0.1'

如果沒有審核通過就添加引用當然就會存在引用異常,如下圖

沒有審核通過引用異常的信息

安利時間

JPay是對微信App支付和支付寶支付App支付的SDK進行二次封裝,對外提供一個較為簡單的接口和支付結果回調

[https://github.com/Javen205/JPay](https://github.com/Javen205/JPay)
[![License](https://img.shields.io/badge/license-Apache%202-green.svg)](https://www.apache.org/licenses/LICENSE-2.0)
[![Download](https://api.bintray.com/packages/javendev/maven/JPay/images/download.svg)](https://dl.bintray.com/javendev/maven/JPay/_latestVersion)

推薦閱讀
Android依賴管理與私服搭建
Android版-支付寶APP支付
Android版-微信APP支付
支付寶Wap支付你了解多少?
一張二維碼集成微信、支付寶支付

安利時間:
JPay是對微信App支付、支付寶App支付的二次封裝,對外提供一個相對簡單的接口以及支付結果的回調

極速開發微信公眾號是對微信公眾平臺接口的二次封裝。包括開發者模式、事件回調監聽、微信模板消息、微信客服消息、自定義菜單、微信支付、素材管理等

如遇到問題歡迎留言交流

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,002評論 6 542
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,400評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,136評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,714評論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,452評論 6 412
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,818評論 1 328
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,812評論 3 446
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,997評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,552評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,292評論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,510評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,035評論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,721評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,121評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,429評論 1 294
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,235評論 3 398
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,480評論 2 379

推薦閱讀更多精彩內容