新版Bintray網站釋出Library到JCenter

Tsy遠發表於2017-09-22
網站

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

前言

由於Bintray網站增加了Organization的概念，所以我在釋出Library的時候發現網上很多文章都已經過時了。網站樣子發生了很大的變化。所以在這篇文章把如何在最新的Bintray上釋出Library到JCenter上做個整理

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

相信很多人分不清這幾個概念究竟代表什麼，只知道跟著開源庫的引入步驟走，比如如下的庫，要你在root下的gradle中加一個maven地址，然後在app的gradle中加compile

示例

現在我們將Maven、JCenter、MavenCenter、JitPack、Bintray這幾個概念分個類解釋下

Maven倉庫

在用Eclipse+Ant組合的時候，我們往往引入一個庫都是下載jar包或者aar包放到lib目錄下，然後右鍵新增引用。 But！這並不友好，比如當升級版本庫的時候往往需要下載新的包替換引用，非常麻煩。 所以，當升級到Android Studio + Gradle 組合後 gradle中提供了可以從遠端拉取jar包和aar包引入本地。規則就是：

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 了

JCenter、MavenCenter、JitPack

這3個名詞即具體的Maven倉庫的地址，他們都是Maven倉庫，但是屬於不同的服務源。總的來說，只有兩個標準的Android library檔案伺服器：Jcenter 和  Maven Central，現在JitPack也流行了起來。（比較方便）

從哪引用這幾個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的library

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

相關文章