Android Studio發布library到Jcenter

前言

各位碼友不知道有沒有發現，不知道從何時，Android Studio的Gradle構建系統就已經把Jcenter作為默認的遠程倉庫了，如下：

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.1.2'
    }
}

而這樣做的好處就是我們只需要在dependencies腳本塊中加入對應lib即可使用遠程倉庫，而不需要再像eclipse那樣苦苦尋找jar包。

dependencies {
    compile fileTree(include: ['*.jar'], dir: 'libs')
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:23.+'
}

你應該在github上也看到過要使用別人的開源庫只需要往dependencies腳本塊中添加一行代碼即可：

github

想象一下，別人往他們的build.gradle中添加了一行代碼就可以使用你的開源庫了，這是一件多么令人興奮的事情。那么接下來我們就把想象變為現實，學習一下怎么將自己的Android Studio Library提交到Jcenter供他人使用。

Bintray

首先我們要了解一個叫做bintray的網站，它和github類似也是用來管理文件的，只不過它管理的是二進制文件，Jcenter就是它眾多倉庫中的一員。

首先需要注冊成為這個網站的用戶，接著進入profile界面：

profile

點擊Edit

Edit

選擇API Key

API Key

這里的API Key和你之前注冊的用戶名在后面會用到。

配置

接著我們新建一個叫做CommitToJcenter的Android工程，并且添加一個叫做jad的android library模塊,這個jad就是我們后面要提交到Jcenter的模塊。

project

然后在工程目錄下local.properties中添加如下內容：

bintray.user=***
bintray.apikey=***

上面的usert填你注冊時候的用戶名，apikey就是上面拿到的那個。

接著在工程目錄下的build.gradle中添加如下內容：

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.1.2'

        //添加一下兩個classpath
        // for jcenter
        // version: https://bintray.com/jfrog/jfrog-jars/gradle-bintray-plugin
        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.7.1'
        // version: https://bintray.com/dcendents/gradle-plugins/com.github.dcendents%3Aandroid-maven-gradle-plugin
        classpath 'com.github.dcendents:android-maven-gradle-plugin:1.3'
    }
}

...

接著進入jad目錄，在build.gradle中添加如下內容：

...

apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'

version = "1.0" //版本號，每次提交到Jcenter都要修改
def siteUrl = *** // project homepage
def gitUrl = ***  // project git
group = "com.zql.android"

install {
    repositories.mavenInstaller {
        // This generates POM.xml with proper parameters
        pom {
            project {
                packaging 'aar'
                name 'Just a demo for jcenter'
                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 *** //Jcenter id
                        name *** //Jcenter name
                        email *** //e-mail
                    }
                }
                scm {
                    connection gitUrl
                    developerConnection gitUrl
                    url siteUrl
                }
            }
        }
    }
}


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))
}


task javadocJar(type: Jar, dependsOn: javadoc) {
    classifier = 'javadoc'
    from javadoc.destinationDir
}

artifacts {
    archives javadocJar
    archives sourcesJar
}

Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
bintray {
    user = properties.getProperty("bintray.user")
    key = properties.getProperty("bintray.apikey")
    configurations = ['archives']
    pkg {
        repo = "maven"
        name = "jad" // project name in jcenter
        websiteUrl = siteUrl
        vcsUrl = gitUrl
        licenses = ["Apache-2.0"]
        publish = true
    }
}

當做完以上幾步后所有的配置工作就完成了，這時候選擇sync一下你的工程，建議在翻墻的情況下sync，成功率會高一點。

提交

接著在Gradle窗口找到如下幾個task，并執行：

• javadocJar
• sourcesJar
• install
• bintrayUpload

gradle

gradle

提交結束后我們再次打開bintray，在profile的last activity中可以看到這樣的信息：

last activity

點擊jad進入模塊界面,點擊add to Jcenter：

add to jcenter

接著填寫一些相關申請信息即可，記得得是英文。我目前的通過率是100%。

request

接著就是等待了，差不多一天時間就能得到答復。

response

OK,進去了，這時候我們已經可以在其他項目中使用我們提交的模塊了。

使用

上面我們新建了jad模塊就直接提交了，并沒有寫代碼，所以也不好在其他工程測試。接下來我們添加一個類JAD.java

package android.zql.com.jad;

import android.content.Context;
import android.widget.Toast;

/**
 * Created by scott on 8/11/16.
 */
public final class JAD {

    public static final void sayHello(Context context){
        Toast.makeText(context,"hello man",Toast.LENGTH_LONG).show();
    }
}

很簡單，使用Toast彈出Hello man這句話。
由于第一次已經被允許加入Jcenter了，所以以后的提交都會默認加入Jcenter。接著我們修改一下這次我們需要提交的版本號為1.0.1：

apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'
version = "1.0.1"

然后執行以下四步：

• javadocJar
• sourcesJar
• install
• bintrayUpload

執行完成后我們看下bintray中的jad:

我們剛提交的1.0.1已經出現在這里了，

1.0.0

這邊給出了jad在gradle中的使用方法，是不是很熟悉？

gradle usage

下面我們就在項目中使用jad吧，在項目的build.gradle中添加如下代碼：

dependencies {
    ...
    compile 'com.zql.android:jad:1.0.1'
}

在Activity中使用：

  @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        JAD.sayHello(this);
    }

運行結果如下：

運行結果

小結

這個技能大神們普遍都會，寫得不到位之處多多提點。還希望這篇總結對大家有所幫助。
最后獻上這個CommitToJcenter的github地址。
最后的最后放上我最敬佩的產品經理，哈哈。

Steven Paul Jobs