新版Bintray網站發佈Library到JCenter

本文介紹了Maven、JCenter、MavenCenter、JitPack、Bintray的概念以及如何在新版的Bintray網站上發佈Library並提交到JCenter上java

前言

因爲Bintray網站增長了Organization的概念,因此我在發佈Library的時候發現網上不少文章都已通過時了。網站樣子發生了很大的變化。因此在這篇文章把如何在最新的Bintray上發佈Library到JCenter上作個整理android

1 什麼是Maven、JCenter、MavenCenter、JitPack、Bintray?

相信不少人分不清這幾個概念究竟表明什麼,只知道跟着開源庫的引入步驟走,好比以下的庫,要你在root下的gradle中加一個maven地址,而後在app的gradle中加compilegit

示例

如今咱們將Maven、JCenter、MavenCenter、JitPack、Bintray這幾個概念分個類解釋下github

Maven倉庫

在用Eclipse+Ant組合的時候,咱們每每引入一個庫都是下載jar包或者aar包放到lib目錄下,而後右鍵添加引用。 But!這並不友好,好比當升級版本庫的時候每每須要下載新的包替換引用,很是麻煩。 因此,當升級到Android Studio + Gradle 組合後 gradle中提供了能夠從遠端拉取jar包和aar包引入本地。規則就是:web

compile 'com.tsy:pay:1.0.0'  //groupid:projectid:version
複製代碼
  1. "com.tsy" 即GroupId,就是你在網上標識這是惟一標識你的一個組,就像Android裏的包名同樣
  2. "pay" 就是個人項目名稱
  3. "1.0.0" 即版本號

這個概念咱們懂了。可是這個下載源是哪呢,就是maven倉庫。那maven倉庫的地址是什麼呢,是否是Android Studio都是從一個倉庫獲取包呢,這時候就須要瞭解 JCenter、MavenCenter、JitPack 了apache

JCenter、MavenCenter、JitPack

這3個名詞即具體的Maven倉庫的地址,他們都是Maven倉庫,可是屬於不一樣的服務源。總的來講,只有兩個標準的Android library文件服務器:Jcenter 和  Maven Central,如今JitPack也流行了起來。(比較方便)api

從哪引用這幾個Maven倉庫呢,就是在根目錄build.gradle中安全

allprojects {
    repositories {
        jcenter()      //JCenter倉庫
        mavenCenter()    //mvenCenter倉庫
        maven { url "https://jitpack.io" }   // jitpack倉庫
    }
}
複製代碼

具體使用哪一個要看開源項目把Library傳到了哪一個倉庫。它就會要求你在這加哪一個倉庫。 起初,Android Studio 選擇Maven Central做爲默認倉庫。若是你使用老版本的Android Studio建立一個新項目,mavenCentral()會自動的定義在build.gradle中。 可是Maven Central的最大問題是對開發者不夠友好。上傳library異常困難。上傳上去的開發者都是某種程度的極客。同時還由於諸如安全方面的其餘緣由,Android Studio團隊決定把默認的倉庫替換成jcenter。正如你看到的,一旦使用最新版本的Android Studio建立一個項目,jcenter()自動被定義,而不是mavenCentral() 咱們發現第三個jitpack的寫法和前2個不同,寫法是maven {} 裏面加入地址,其實這個纔是maven倉庫標準引用方法,jcenter和mavenCenter因爲是標準的Android倉庫,至關於定義了一個別名。 因此一些自定義的倉庫都是這種寫法而後填入本身的倉庫網址,好比Fabric.io的librarybash

maven { url 'https://maven.fabric.io/public' }
複製代碼

Bintray是什麼

Bintray其實只是一個網站,他們負責維護JCenter這個庫,就是說JCenter庫是託管在Bintray網站上的。 可是Bintray不僅只有JCenter庫,每一個人均可以在上面建立本身的帳號,生成本身的maven倉庫,好比個人帳號tangsiyuan下面建立了一個名叫"maven"的maven倉庫。那個人maven倉庫地址就是 https://dl.bintray.com/tangsiyuan/maven 固然也能夠再build中引入服務器

maven { url 'https://dl.bintray.com/tangsiyuan/maven' }
複製代碼

而JCenter倉庫只是Bintray官方帳戶建立的一個maven倉庫,地址是 https://jcenter.bintray.com

其實我的的倉庫和JCenter是平級的,只不過JCenter被Android Gradle設爲了標準倉庫。

2 如何在新版的Bintray網站上發佈Library到JCenter上

上面把全部的概念都介紹清楚了。如今咱們來介紹怎麼把本身的Libary傳到JCenter上。(mavenCenter已通過時了,jitpack很簡單就不做介紹了)

2.1 完成本身的Library

發佈的前提固然是本身的Library已經完成了。具體怎麼寫Library就再也不贅述。給你們截個個人MyOKHttp的圖就行

MyOkHttp

MyOkHttp是建立的一個完整項目,app是sample應用,myokhttp是Library

2.2 Bintray網站上建立帳戶

因爲 Bintray網站 改版了,增長了Organization的概念,首頁變成了這樣

Bintray首頁

對!就是中間那個大大的綠色按鈕,用那個點了就錯了!!!變成了註冊一個組織,註冊地址是 https://bintray.com/signup

signup

而註冊我的的地址應該是 https://bintray.com/signup/oss

signup-oss

坑爹!重要的事情說3遍!!!

註冊地址是 https://bintray.com/signup/oss

註冊地址是 https://bintray.com/signup/oss

註冊地址是 https://bintray.com/signup/oss

具體註冊過程就很少說了,注意一點,好像不能用QQ郵箱註冊

2.3 建立maven倉庫

註冊完成,激活郵箱,登陸後建立一個maven倉庫

建立maven倉庫

name寫maven(由於上傳的時候不指定的話默認倉庫名是maven) type選擇maven

建立成功後就像上圖我成功建立的maven倉庫同樣。

2.3 上傳Library到本身建立的maven倉庫

在這裏我使用了開源庫上傳本身的Library

https://github.com/novoda/bintray-release

根目錄build添加

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.2.2'
        classpath 'com.novoda:bintray-release:0.3.4'
    }
}
複製代碼

須要上傳Library的build添加

apply plugin: 'com.novoda.bintray-release'

...

publish {
    userOrg = 'tangsiyuan'      //bintray註冊的用戶名
    groupId = 'com.tsy'         //compile引用時的第1部分groupId
    artifactId = 'myokhttp'     //compile引用時的第2部分項目名
    publishVersion = '1.0.0'    //compile引用時的第3部分版本號
    desc = 'This is a okhttp3 extend library'
    website = 'https://github.com/tsy12321/MyOkHttp'
}
複製代碼

最後打開Termainal執行命令

./gradlew clean build bintrayUpload -PbintrayUser=BINTRAY_USERNAME -PbintrayKey=BINTRAY_KEY -PdryRun=false
複製代碼

其中BINTRAY_USERNAME換成bintray註冊的用戶名,BINTRAY_KEY換成本身的APIKEY

APIKEY的查看以下

APIKEY

回車執行命令,看到BUILD SUCCESS即上傳成功

這時候咱們能夠打開maven倉庫看到本身提交的項目

maven倉庫

2.4 提交到JCenter

在咱們上傳到本身maven倉庫後其實就已經能夠引用本身的庫了。只要在root下的build加上本身maven地址

maven { url 'https://dl.bintray.com/tangsiyuan/maven' }
複製代碼

而後在app的build中加上引用便可

compile 'com.tsy:myokhttp:1.0.0'
複製代碼

我的maven倉庫

點Sync,能夠發現引用成功。

固然若是可以提交到JCenter就更好了,再也不須要定義本身maven倉庫地址,直接compile便可。 進入項目頁,點擊Add to JCenter

Add to JCenter

而後直接commit send就行(提交JCenter後groupID和在本地定義的同樣,因此本地定義groupID要能標識我的,最好到 https://jcenter.bintray.com 看下有沒有重複的包名

commit to JCenter

最後等待Bintray審覈經過。(我晚上提交,次日就審覈經過了)

經過後會有右上方小郵箱按鈕提示信息,提示審覈經過

tips

項目頁信息多了個JCenter圖標

JCenter審覈經過

這時候Library就已經成功提交到了JCenter,咱們回到項目中將build中的我的maven倉庫引用刪掉,只保留JCenter,Sync。大功告成!!!

彩蛋

教一個高逼格的小技巧,Github上常常會看到2個小圖標

dvg

就是這兩行代碼

[![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/tangsiyuan/maven/myokhttp/images/download.svg) ](https://bintray.com/tangsiyuan/maven/myokhttp/_latestVersion)
複製代碼

具體裏面怎麼替換就很少說咯。加上後感受逼格立馬提升!

最後安利一波本身的2個庫,歡迎star、pr

MyOkHttp

對Okhttp3進行二次封裝,對外提供了POST請求、GET請求、PATCH請求、PUT請求、DELETE請求、上傳文件、下載文件、取消請求、Raw/Json/Gson返回、後臺下載管理等功能

https://github.com/tsy12321/MyOkHttp

PayAndroid

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

https://github.com/tsy12321/PayAndroid

相關文章
相關標籤/搜索