一步一步教你在JCenter發(fā)布開源庫

register1

當(dāng)你寫好了一個(gè)開源庫间护,是否也想像其他的開源庫一樣在Android Studio中一句compile就可以引用。比如:

compile 'com.android.support:appcompat-v7:25.1.0'

這看起來是一件很酷的事情,其實(shí)也不難悠瞬。將你的項(xiàng)目上傳Maven昵骤,然后發(fā)布到JCenter即可。下面我們來看看詳細(xì)過程交惯。

準(zhǔn)備工作

首先你要寫好一個(gè)開源項(xiàng)目次泽。嗯,不用我說你也知道席爽。

注冊Bintray

說到注冊意荤,大家第一時(shí)間肯定是想到去官網(wǎng)注冊。但是只锻,現(xiàn)在官網(wǎng)首頁的注冊入口(上面第一張圖)已經(jīng)變成組織的注冊了玖像,并不是個(gè)人注冊。所以我們要去個(gè)人注冊入口:

傳送門:https://bintray.com/signup/oss

register2

在上面這個(gè)頁面注冊就對了齐饮。也可以用第三方登錄捐寥,我是直接用Github登錄(好像其它兩個(gè)在我國也登錄不了)笤昨,省事。

創(chuàng)建一個(gè)Maven倉庫

注冊完登錄進(jìn)去后握恳,點(diǎn)擊“Add New Repository”瞒窒,新建倉庫:

create

接下來,我們會看到這么一個(gè)界面:

create1

Name填maven乡洼,Type選Maven崇裁,Default Licenses選Apache-2.0,Description是描述就珠,隨便填寇壳,點(diǎn)擊Create。然后回到主頁就會在剛剛“Add New Repository”下面多了一個(gè)叫maven的倉庫妻怎。

配置build.gradle

在你Project的build.gradle文件中加入Maven和Jfrog Bintray的依賴插件:

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.2.3'
        //下面這兩句
        classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'
        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.7.3'
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

你不一定要和我用同樣版本的插件壳炎,說不定你用的時(shí)候就不是這個(gè)版本了。建議去Github上看看最新的版本:

Maven:https://github.com/dcendents/android-maven-gradle-plugin
Jfrog Bintray:https://github.com/bintray/gradle-bintray-plugin

然后在library的build.gradle文件中進(jìn)行配置逼侦,這里以我的開源控件CircleView為例:

gradle

整個(gè)build.gradle文件如下:

apply plugin: 'com.android.library'
//添加這兩行
apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'

android {
    compileSdkVersion 25
    buildToolsVersion "25.0.0"

    defaultConfig {
        minSdkVersion 14
        targetSdkVersion 25
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"

    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
        exclude group: 'com.android.support', module: 'support-annotations'
    })
    compile 'com.android.support:appcompat-v7:25.1.0'
    testCompile 'junit:junit:4.12'
}

//項(xiàng)目主頁
def siteUrl = 'https://github.com/backkomyoung/CircleView'
//項(xiàng)目的git地址
def gitUrl = 'https://github.com/backkomyoung/CircleView.git'
//發(fā)布到JCenter上的項(xiàng)目名字
def libName = "CircleView"

//發(fā)布到組織名稱名字匿辩,必須填寫
group = "me.songning.CircleView"
// 版本號,下次更新是只需要更改版本號即可
version = "1.0.0"
//上面配置后上傳至JCenter后的編譯路徑是這樣的: compile 'me.songning.CircleView:library:1.0.0'

//生成源文件
task sourcesJar(type: Jar) {
    from android.sourceSets.main.java.srcDirs
    classifier = 'sources'
}

//生成Javadoc文檔
task javadoc(type: Javadoc) {
    source = android.sourceSets.main.java.srcDirs
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}

//文檔打包成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'
                //項(xiàng)目描述铲球,隨意填
                name 'A colorful circle view with text.'
                url siteUrl
                licenses {
                    license {
                        //開源協(xié)議
                        name 'The Apache Software License, Version 2.0'
                        url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                    }
                }
                developers {
                    developer {
                        //開發(fā)者的個(gè)人信息
                        id 'backkomyoung'
                        name 'SongNing'
                        email 'backkomyoung@gmail.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值必須要和你創(chuàng)建Maven倉庫的時(shí)候的名字一樣
        repo = "maven"
        //發(fā)布到JCenter上的項(xiàng)目名字
        name = libName
        //項(xiàng)目描述
        desc = 'A colorful circle view with text.'
        websiteUrl = siteUrl
        vcsUrl = gitUrl
        licenses = ["Apache-2.0"]
        publish = true
    }
}

javadoc {
    options{
        //如果你的項(xiàng)目里面有中文注釋的話,必須將格式設(shè)置為UTF-8晰赞,不然會出現(xiàn)亂碼
        encoding "UTF-8"
        charSet 'UTF-8'
        author true
        version true
        links "http://docs.oracle.com/javase/7/docs/api"
    }
}

除此外稼病,還要將user和key寫到local.properties文件中:

sdk.dir=E\:\\Android\\Sdk
//uer和key
bintray.user=username
bintray.apikey=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

user即為你的賬號:

user

key的話點(diǎn)擊修改信息:

edit

選擇左邊的“API key”,然后復(fù)制key:

key

把user和key填到上面的local.properties文件中就ok啦掖鱼。準(zhǔn)備工作到這里算是完成了然走。

執(zhí)行命令

打開Android Studio底部工具欄的Terminal窗口,輸入命令:

gradlew install

build

漫長的等待...可能是我的網(wǎng)絡(luò)問題戏挡,吃了個(gè)飯回來才弄好芍瑞。

succeed

顯示“BUILD SUCCESSFUL”即表示成功。

到這里已經(jīng)成功一半了褐墅,只差上傳到Bintray了拆檬。然后我們接著在Terminal窗口輸入命令:

gradlew bintrayUpload

bintrayUpload

這個(gè)很快就好~

upload

同樣,顯示“BUILD SUCCESSFUL”即表示成功妥凳。

發(fā)布到JCenter

這時(shí)候打開我們創(chuàng)建的maven倉庫竟贯,就會在里面發(fā)現(xiàn)已經(jīng)成功將項(xiàng)目上傳到倉庫里。

maven

點(diǎn)擊我們的項(xiàng)目名逝钥,進(jìn)入詳情:

jcenter

點(diǎn)擊“Add to JCenter”后:

send

直接點(diǎn)Send就行了澄耍。因?yàn)闀r(shí)差的關(guān)系,接下來就是漫長的等待審核了。

approved

經(jīng)過幾個(gè)小時(shí)齐莲,在Bintray的網(wǎng)站上會有提示審核通過。這時(shí)候磷箕,就可以在Android Studio上通過compile的方式使用了选酗。

遇到的問題

說說我遇到的問題,就是執(zhí)行上傳命令的時(shí)候岳枷,顯示這個(gè)錯(cuò)誤:

fail

提示找不到“maven”芒填,原因是我當(dāng)時(shí)還沒創(chuàng)建Maven倉庫就執(zhí)行上傳命令,創(chuàng)建后再執(zhí)行一遍命令就成功了空繁。還有就是創(chuàng)建的Maven倉庫的名字一定要和build.gradle文件里面的repo值一致殿衰。我就遇到這一個(gè)問題。

如果你們遇到其他的問題盛泡,建議看看這篇:

Android 發(fā)布項(xiàng)目到 JCenter 遇到的各種坑

結(jié)語

到這里就把整個(gè)開源庫發(fā)布到JCenter的流程寫完了闷祥,有什么問題可以在下面留言~

參考文章
android 將開源項(xiàng)目發(fā)布到JCenter及問題總結(jié)
利用Gradle發(fā)布項(xiàng)目到JCenter、Maven
新版Bintray-極簡上傳Library到JCenter

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末傲诵,一起剝皮案震驚了整個(gè)濱河市凯砍,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌拴竹,老刑警劉巖悟衩,帶你破解...
    沈念sama閱讀 211,743評論 6 492
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異栓拜,居然都是意外死亡座泳,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,296評論 3 385
  • 文/潘曉璐 我一進(jìn)店門幕与,熙熙樓的掌柜王于貴愁眉苦臉地迎上來挑势,“玉大人,你說我怎么就攤上這事纽门⊙Τ埽” “怎么了?”我有些...
    開封第一講書人閱讀 157,285評論 0 348
  • 文/不壞的土叔 我叫張陵赏陵,是天一觀的道長饼齿。 經(jīng)常有香客問我,道長蝙搔,這世上最難降的妖魔是什么缕溉? 我笑而不...
    開封第一講書人閱讀 56,485評論 1 283
  • 正文 為了忘掉前任,我火速辦了婚禮吃型,結(jié)果婚禮上证鸥,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好枉层,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,581評論 6 386
  • 文/花漫 我一把揭開白布泉褐。 她就那樣靜靜地躺著,像睡著了一般鸟蜡。 火紅的嫁衣襯著肌膚如雪膜赃。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,821評論 1 290
  • 那天揉忘,我揣著相機(jī)與錄音跳座,去河邊找鬼。 笑死泣矛,一個(gè)胖子當(dāng)著我的面吹牛疲眷,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播您朽,決...
    沈念sama閱讀 38,960評論 3 408
  • 文/蒼蘭香墨 我猛地睜開眼狂丝,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了虚倒?” 一聲冷哼從身側(cè)響起美侦,我...
    開封第一講書人閱讀 37,719評論 0 266
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎魂奥,沒想到半個(gè)月后菠剩,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 44,186評論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡耻煤,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,516評論 2 327
  • 正文 我和宋清朗相戀三年具壮,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片哈蝇。...
    茶點(diǎn)故事閱讀 38,650評論 1 340
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡棺妓,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出炮赦,到底是詐尸還是另有隱情怜跑,我是刑警寧澤,帶...
    沈念sama閱讀 34,329評論 4 330
  • 正文 年R本政府宣布吠勘,位于F島的核電站性芬,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏剧防。R本人自食惡果不足惜植锉,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,936評論 3 313
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望峭拘。 院中可真熱鬧俊庇,春花似錦狮暑、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,757評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至鞋囊,卻和暖如春止后,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背溜腐。 一陣腳步聲響...
    開封第一講書人閱讀 31,991評論 1 266
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留瓜喇,地道東北人挺益。 一個(gè)月前我還...
    沈念sama閱讀 46,370評論 2 360
  • 正文 我出身青樓,卻偏偏與公主長得像乘寒,于是被迫代替她去往敵國和親望众。 傳聞我的和親對象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,527評論 2 349

推薦閱讀更多精彩內(nèi)容