通過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)點:
發(fā)布包到Bintray JCenter遠程倉庫
我們可以將項目發(fā)布到本地倉庫牡整,私有倉庫以及JCenter遠程倉庫(關于各種倉庫如何區(qū)分,有點混亂溺拱,后面理一理)逃贝。這里主要討論如何發(fā)布到Bintray JCenter倉庫,關于如何發(fā)布到本地和私有倉庫上盟迟,不是這篇文章討論的重點秋泳。
我們用一張圖來展示Bintray的工作方式:
至于這里打的是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中添加如下配置:
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.2'
classpath 'com.github.dcendents:android-maven-gradle-plugin:2.0'
2.在需要上傳的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的獲取方式:
3.上傳
在terminal中依次輸入:
./gradlew install
./gradlew bintrayUpload
ok,現(xiàn)在到Bintray官網上查看筋帖,發(fā)現(xiàn)倉庫里多了一個package奸晴,點擊進去:
我這里已經是添加到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