相信大家在使用Android Studio開發(fā)項目時轮听，都感受到了使用Gradle來管理項目骗露，以及添加第三方依賴的方便性。同時作為一個Android程序猿血巍，肯定也希望有一款自己的開源庫受到大家的認(rèn)可萧锉，不管是出于自己的虛榮，還是為了開源的精神述寡，我們都應(yīng)該掌握掌握這個裝逼神技??柿隙。正好前段時間寫了一個自定義View的開源庫BezierIndicator，雖然項目簡單鲫凶，正好可以拿來嘗試一下發(fā)布開源庫的操作禀崖。
準(zhǔn)備
首先我們要知道，Android開源庫有兩個常用的開源網(wǎng)站JitPack以及JCenter螟炫，這兩個網(wǎng)站都可以發(fā)布我們的開源庫波附，發(fā)布成功后都可以在項目gradle中通過一行代碼引入開源庫，那它們有什么區(qū)別呢不恭？
在引入JitPack開源庫的時候叶雹，我們需要在項目根目錄的build.gradle中添加這行代碼
allprojects {
repositories {
jcenter()
maven { url 'https://jitpack.io' }
}
}
而引入JCenter的開源庫時只需要到項目build.gradle中添加依賴代碼就行了。
需要準(zhǔn)備以下內(nèi)容
- 新建一個項目换吧，并在項目中添加一個Library Moudle作為你要發(fā)布的開源庫
- 一個github賬號
- 一個bintray賬號
項目結(jié)構(gòu)如下
發(fā)布到JitPack
1折晦、在項目根目錄build.gradle添加Maven插件
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'
2、在要上傳的library的build.gralde文件添加如下代碼：
// JitPack Maven
apply plugin: 'com.github.dcendents.android-maven'
// Your Group
group=‘com.github.你的github_username'
3沾瓦、項目發(fā)布到github上满着，在github項目主頁創(chuàng)建一個release或者Tag：
4、將項目的倉庫提交到JitPack贯莺，Jitpack可使用github賬號授權(quán)登錄：
5风喇、點擊Get it就可發(fā)布開源庫，成功后就可在項目中直接引用
allprojects{
repositories{
...
maven { url 'https://jitpack.io' }
}
}
compile 'com.github.linchenming0516:BezierIndicator:1.0.0'
發(fā)布到JCenter
Bintray準(zhǔn)備
1缕探、注冊Bintray魂莫，這里注意注冊郵箱不能是國內(nèi)的郵箱，所以自備梯子吧爹耗。
2耙考、獲取注冊完的User賬號及APIKey谜喊，后面上傳有用
3、進入你的Bintray主頁倦始，注冊一個Maven倉庫
新建倉庫name最好寫成maven
項目gradle配置
1斗遏、在項目根目錄build.gradle中配置Bintray以及Maven的服務(wù)插件
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.7.3'
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'
可以去插件的github地址獲取最新插件的版本號，添加完插件后鞋邑，需要讓 library module 依賴新的插件诵次，在庫的build.gradle中添加如下代碼
apply plugin: 'com.jfrog.bintray'
apply plugin: 'com.github.dcendents.android-maven'
2、Bintray在上傳庫時需要一個POM文件枚碗，可以通過剛引入的Maven插件自動生成逾一，但還是需要我們給出groudId和version的值，只需在庫的build.gradle中添加如下代碼
//JCenter 添加
group = 'com.lcm.bezierIndicator' // 這里需要和真實包名對應(yīng)视译，不能隨便填寫
version = '1.0.0' // 指定版本號
3嬉荆、為了與Maven標(biāo)準(zhǔn)對應(yīng)，你需要在庫module的build.gradle中添加幾個task酷含，分別生成Jar鄙早、Javadoc和JavadocsJar，只需要將下面三個task代碼添加到庫的build.gradle文件即可椅亚。
task generateSourcesJar(type: Jar) {
from android.sourceSets.main.java.srcDirs //通過from函數(shù)指定代碼源限番，這里是默認(rèn)代碼源
classifier 'sources'
}
task generateJavadocs(type: Javadoc) {
source = android.sourceSets.main.java.srcDirs //source指定了代碼源
classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}
//這里dependsOn意為僅當(dāng)generateJavadocs完成后才開始本task
task generateJavadocsJar(type: Jar, dependsOn: generateJavadocs) {
from generateJavadocs.destinationDir
classifier 'javadoc'
}
為了將你生成的源代碼和Javadoc Jar文件添加到Maven中，你需要將task添加到一個archive中呀舔，只需要向庫module下的build.gradle中添加如下代碼：
artifacts {
archives generateJavadocsJar
archives generateSourcesJar
}
4弥虐、將前面獲取的Bintray的user以及apikey寫在local.properties文件中，這個文件最好不要添加到版本控制中
bintray.user=your_username
bintray.apikey=your_apikey
5媚赖、繼續(xù)在 Library module的build.gradle中添加上傳必須的代碼塊
//需要在local.properties文件中取值
Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
bintray {
user = properties.getProperty("bintray.user")
key = properties.getProperty("bintray.apikey")
pkg {
repo = 'maven'
name = 'com.lcm.bezierIndicator'
version {
name = '1.0.0'
desc = "BezierIndicator"
released = new Date()
vcsTag = '1.0.0'
}
licenses = ['Apache-2.0']
//git管理地址
vcsUrl = 'https://github.com/lichenming0516/BezierIndicator.git'
//項目github地址
websiteUrl = 'https://github.com/lichenming0516/BezierIndicator'
}
configurations = ['archives']
}
在選擇License時霜瘪，可以參考這張圖，來自阮一峰老師的博文惧磺。剛才說過颖对，選擇License只是選擇一種權(quán)利，選好之后可以直接添加就好磨隘。GitHub在創(chuàng)建Repo時可以快速添加License文件缤底。
開始進行上傳
1、選擇AndroidStudio Gradle視圖番捂，菜單點擊View->Tool Windows->Gradle調(diào)出个唧，點擊圖標(biāo)欄的Gradle圖標(biāo)。
2设预、輸入install徙歼，點擊OK。這時會執(zhí)行Maven相關(guān)的task，完成后會在build目錄下生成必要的文件
3鲁沥、成功后再次點擊Gradle圖標(biāo)呼股，輸入bintrayUpload 并點擊OK
上傳成功后耕魄，可以在你的Bintray的maven倉庫中看見上傳完成的項目
4画恰、點擊進入maven倉庫中的項目，會有一個提示讓你七天內(nèi)公開吸奴，點擊Publish
5允扇、為了讓所有開放者使用，我們需要將類庫添加到JCenter中则奥，點擊 Add to JCenter 按鈕提交申請
提交后幾個小時后就會有郵件通知添加成功考润，添加成功后就會變成如下景象
<dependency>
<groupId>com.lcm.bezierIndicator</groupId>
<artifactId>bezierIndicator</artifactId>
<version>1.0.0</version>
<type>pom</type>
</dependency>
6、接下來就可以在項目中直接引用了
compile 'com.lcm.bezierIndicator:bezierIndicator:1.0.0'
小結(jié)
發(fā)布到JitPack的操作比較簡單读处，只不過引用比Jcenter多一句代碼而已糊治，怕麻煩的可以直接發(fā)布到JitPack上。發(fā)布到JCenter操作比較繁瑣點罚舱，反正多掌握一點技巧總不會有錯的??井辜，同時也發(fā)現(xiàn)一種簡化上傳JCneter的方法-極簡上傳Library到JCenter，有興趣的可以嘗試嘗試管闷。
參考文章：
