Android發(fā)布項目到JCenter

通過Gradle把自己開發(fā)的開源項目發(fā)布到公共倉庫JCenter中,可以很方便地在其他項目中引用。

關于Maven, JCenter, MavenCentral等易于混淆的概念罚拟,這篇文章做了非常詳盡的闡述:擁抱 Android Studio 之四:Maven 倉庫使用與私有倉庫搭建,這里簡要概括下诅病。

Maven

對于Android開發(fā)者而言揍魂,Maven是一種構建工具,Maven包是由POM(Project Object Model)所定義的文件包格式檩电。
Gradle可以使用Maven包拄丰,且Android能使用的大部分遠程依賴包都是Maven包府树。

Maven 倉庫

Maven包集中存放的地方就是Maven倉庫。倉庫可以放在本地料按,也可以放在遠程服務器上奄侠,可以是公開的,也可以是私有的载矿。
Android Studio Gradle默認支持兩種Maven中央倉庫:MavenCentral和JCenter垄潮。我們在Project級別的build.gradle文件添加需要的倉庫:

mavenCentral()
jcenter()
maven {
     url 'file:///Users/my-user-name/Documents/Android/repo/'
}
maven {
     url 'http://192.168.99.100:8081/content/repositories/releases/'
}

mavenCentral是最早的Maven中央倉庫;
JCenter是Android Studio 0.8版本起的默認Maven中央倉庫闷盔;
第三個是本地倉庫弯洗;
第四個是部署在內網服務器的私有倉庫。

至于為什么Google將MavenCentral切換成了JCenter逢勾,因為JCenter有如下優(yōu)點:

JCenter的優(yōu)點

發(fā)布包到Bintray JCenter遠程倉庫

我們可以將項目發(fā)布到本地倉庫牡整,私有倉庫以及JCenter遠程倉庫(關于各種倉庫如何區(qū)分,有點混亂溺拱,后面理一理)逃贝。這里主要討論如何發(fā)布到Bintray JCenter倉庫,關于如何發(fā)布到本地和私有倉庫上盟迟,不是這篇文章討論的重點秋泳。

我們用一張圖來展示Bintray的工作方式:


how-bintray-works

至于這里打的是aar還是jar包,取決于你的項目是Android Library還是Java Library攒菠。
可以看到迫皱,當我們的項目上傳到Bintray后,最開始是在我們自己的倉庫中辖众。如果想進入JCenter卓起,還需要網站的審核“颊ǎ基本晚上上傳上去戏阅,第二天早上就審核通過了。

我們可以將Maven包發(fā)布到Bintray提供的JCenter倉庫啤它,步驟如下:

申請Bintray賬號

因為JCenter是Bintray公司在維護奕筐,所以我們要先注冊一個Bintray賬號,這里有一個深坑变骡。
https://bintray.com/
https://bintray.com/signup/oss
這里是兩個不同的注冊地址离赫。上面的地址是供企業(yè)用戶注冊的,會有一個叫Organization的概念塌碌。當你使用該網址注冊完也上傳完后渊胸,會發(fā)現(xiàn)沒有“add to JCenter”按鈕,那就意味著你上傳的包只是放到你自己創(chuàng)建的倉庫台妆,并沒有放到JCenter倉庫翎猛。除非你是企業(yè)用戶胖翰,或者等待30天后,才能看到“add to JCenter”按鈕切厘。
個人開發(fā)者請使用下方的免費版注冊地址注冊!
https://bintray.com/signup/oss

允悲

注冊過程略過萨咳,很簡單。
注冊完成后迂卢,我們需要添加一個倉庫:


添加倉庫

其中必填的某弦,Name可以自己選定,Type選擇Maven而克。

倉庫添加完成后靶壮,現(xiàn)在要做的就是使用Bintray腳本將本地的Module打包并上傳。

上傳到Bintray

1.在項目級別的build.gradle中添加如下配置:


project/build.gradle配置
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.2'
classpath 'com.github.dcendents:android-maven-gradle-plugin:2.0'

2.在需要上傳的module的build.gradle文件中添加如下配置(在最末尾追加即可):


module/build.gradle配置

下面詳細解釋需要添加的配置及其含義:

/** 以下開始是將Android Library上傳到JCenter的相關配置**/

apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'

//項目主頁
def siteUrl = 'https://github.com/JayZhaoCN'
//項目的版本控制地址
def gitUrl = 'https://github.com/JayZhaoCN'

//發(fā)布到組織名稱名字员萍,必須填寫
group = "com.utils.zhaojiabao"
//發(fā)布到JCenter上的項目名字腾降,必須填寫
def libName = "baseui"
// 版本號,下次更新是只需要更改版本號即可
version = "0.0.3"
/**  上面配置后上傳至JCenter后的編譯路徑是這樣的: compile 'group:libName:version'  **/

//生成源文件
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))
    options.encoding "UTF-8"
    options.charSet 'UTF-8'
    options.author true
    options.version true
    options.links "https://github.com/JayZhaoCN"
    failOnError false
}

//文檔打包成jar
task javadocJar(type: Jar, dependsOn: javadoc) {
    classifier = 'javadoc'
    from javadoc.destinationDir
}
//拷貝javadoc文件
task copyDoc(type: Copy) {
    from "${buildDir}/docs/"
    into "docs"
}

//上傳到jCenter所需要的源碼文件
artifacts {
    archives javadocJar
    archives sourcesJar
}

// 配置maven庫碎绎,生成POM.xml文件
install {
    repositories.mavenInstaller {
        // This generates POM.xml with proper parameters
        pom {
            project {
                packaging 'aar'
                name 'baseui'
                url siteUrl
                licenses {
                    license {
                        name 'The Apache Software License, Version 2.0'
                        url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                    }
                }
                developers {
                    developer {
                        id 'JayZhao'
                        name 'Zhaojiabao'
                        email '1760064052@qq.com'
                    }
                }
                scm {
                    connection gitUrl
                    developerConnection gitUrl
                    url siteUrl
                }
            }
        }
    }
}

//上傳到JCenter
Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
bintray {
    user = properties.getProperty("bintray.user")    //讀取 local.properties 文件里面的 bintray.user
    key = properties.getProperty("bintray.apikey")   //讀取 local.properties 文件里面的 bintray.apikey
    configurations = ['archives']
    pkg {
        repo = "maven"
        name = libName    //發(fā)布到JCenter上的項目名字螃壤,必須填寫
        desc = 'baseui'    //項目描述
        websiteUrl = siteUrl
        vcsUrl = gitUrl
        licenses = ["Apache-2.0"]
        publish = true
    }
}

需要在local.properties文件中配置Bintray用戶名和apiKey:

bintray.user=jayzhaoccc
bintray.apikey=******************************

apiKey的獲取方式:


點擊Edit Profile

點擊API Key

點擊復制,即可

3.上傳
在terminal中依次輸入:

./gradlew install
./gradlew bintrayUpload

ok,現(xiàn)在到Bintray官網上查看筋帖,發(fā)現(xiàn)倉庫里多了一個package奸晴,點擊進去:


add to JCenter

我這里已經是添加到JCenter過了。
剛上傳的包在自己的倉庫日麸,還沒有進入JCenter寄啼,點擊“add to JCenter”,審核過即可代箭。
現(xiàn)在墩划,只要在需要的項目中引入即可:

implementation 'com.utils.zhaojiabao:baseui:0.0.3'

借鑒了下面幾篇文章,非常感謝大牛的無私分享:
http://blog.bugtags.com/2016/01/27/embrace-android-studio-maven-deploy/
https://blog.csdn.net/zhcswlp0625/article/details/54895584

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末嗡综,一起剝皮案震驚了整個濱河市乙帮,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌极景,老刑警劉巖察净,帶你破解...
    沈念sama閱讀 211,817評論 6 492
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異盼樟,居然都是意外死亡塞绿,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,329評論 3 385
  • 文/潘曉璐 我一進店門恤批,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人裹赴,你說我怎么就攤上這事喜庞【骼耍” “怎么了?”我有些...
    開封第一講書人閱讀 157,354評論 0 348
  • 文/不壞的土叔 我叫張陵延都,是天一觀的道長雷猪。 經常有香客問我,道長晰房,這世上最難降的妖魔是什么求摇? 我笑而不...
    開封第一講書人閱讀 56,498評論 1 284
  • 正文 為了忘掉前任,我火速辦了婚禮殊者,結果婚禮上与境,老公的妹妹穿的比我還像新娘。我一直安慰自己猖吴,他們只是感情好摔刁,可當我...
    茶點故事閱讀 65,600評論 6 386
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著海蔽,像睡著了一般共屈。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上党窜,一...
    開封第一講書人閱讀 49,829評論 1 290
  • 那天拗引,我揣著相機與錄音,去河邊找鬼幌衣。 笑死矾削,一個胖子當著我的面吹牛,可吹牛的內容都是我干的泼掠。 我是一名探鬼主播怔软,決...
    沈念sama閱讀 38,979評論 3 408
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼择镇!你這毒婦竟也來了挡逼?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 37,722評論 0 266
  • 序言:老撾萬榮一對情侶失蹤腻豌,失蹤者是張志新(化名)和其女友劉穎家坎,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體吝梅,經...
    沈念sama閱讀 44,189評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡虱疏,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 36,519評論 2 327
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了苏携。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片做瞪。...
    茶點故事閱讀 38,654評論 1 340
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出装蓬,到底是詐尸還是另有隱情著拭,我是刑警寧澤,帶...
    沈念sama閱讀 34,329評論 4 330
  • 正文 年R本政府宣布牍帚,位于F島的核電站儡遮,受9級特大地震影響,放射性物質發(fā)生泄漏暗赶。R本人自食惡果不足惜鄙币,卻給世界環(huán)境...
    茶點故事閱讀 39,940評論 3 313
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望蹂随。 院中可真熱鬧十嘿,春花似錦、人聲如沸糙及。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,762評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽浸锨。三九已至唇聘,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間柱搜,已是汗流浹背迟郎。 一陣腳步聲響...
    開封第一講書人閱讀 31,993評論 1 266
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留聪蘸,地道東北人宪肖。 一個月前我還...
    沈念sama閱讀 46,382評論 2 360
  • 正文 我出身青樓,卻偏偏與公主長得像健爬,于是被迫代替她去往敵國和親控乾。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 43,543評論 2 349

推薦閱讀更多精彩內容