玩轉Android studio 插件開發、測試、JCenter庫發佈(2)

上一節,我們以實例的方式,講解了android studio依賴庫的開發過程,但是,似乎還沒有完成。
是的,還缺少插件的生成、發佈和使用。

下面我們便接着上一節,繼續講解依賴庫的生成、發佈和使用

依賴庫的發佈,是在build.gradle構建腳本中處理的。
在講解構建腳本之前,我們先說下JCenter庫的申請等前期準備工作。

1、註冊賬號
https://bintray.com/上註冊一個賬號。

2、獲取API Key
註冊後,在https://bintray.com/profile/edit頁面的左邊菜單的最下面有API Key,

這裏寫圖片描述

複製明文API key,後面會用到。

3、定義相關網站
有單獨的官方網站那是最好的,沒用的話就用git網址就可以了。

def siteUrl = ‘https://github.com/xxxxxx‘// project homepage
def gitUrl = ‘https://github.com/xxxxxx.git‘// project git

4、定義Group(上一節已經定義,此處只是瞭解原因)
舉個例子,當我們引用recylerview的時候是這樣的:

compile'com.android.support:recyclerview-v7:21.0.2'

引號內字符串以冒號分割爲三部分,第一部分就是group,第二部分是name, 第三部分是version。
其中group和version分別對應上一節最後在build.gradle中添加的信息,而name對應我們的模塊名,由於上一節中模塊名爲app,所以name=app。
合起來,上一節開發的依賴庫的引用就應該是這樣:

compile 'com.myutils:app:0.1'

接着,便是上傳依賴庫到Jcenter庫。需要知道的是上傳到Jcenter庫至少需要四個文件,除了打包的aar之外,還需要pom和javadoc,source,否則是通不過Jcenter庫審覈的。不過不用緊張,這些我們都可以用腳本生成。
添加創建javadocjar、sourcejar、pom和aar(也可以是jar)的腳本任務。

5、打包javadocjar和sourcejar
這兩個也是上傳到jcenter必須要的。

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
}

6、定義pom並打包aar

install {
    repositories.mavenInstaller {
        // This generates POM.xml with proper parameters
        pom {
            project {
                packaging 'aar'
                name 'Utils For Android'      //project title
                url siteUrl
                // Set your license
                licenses {
                    license {
                        name 'The Apache Software License, Version 2.0'
                        url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                    }
                }
                developers {
                    developer {
                        id 'test'      //your user id
                        name 'csky'  // your user name
                        email '[email protected]'   // your email
                    }
                }
                scm {
                    connection gitUrl
                    developerConnection gitUrl
                    url siteUrl
                }
            }
        }
    }
}

7、配置個人信息
上傳到jcenter的網站BinTray,需要用戶驗證,需要2個值。

// 示例值, 僅供參考
bintray.user=openproject                        // your bintray user name
bintray.apikey=c5434272d5xxxxxxxx225564155753   // your bintray api key

第二個API Key就是你在上面記錄的API Key。
因爲這個屬於個人隱私,一般不能傳到網上去,所以需要在記錄到工程下的local.properties中(利用gitignore忽略這個文件到git),然後腳本再從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")
    configurations = ['archives']
    pkg {
        repo = "maven"
        name = "utils"                 //project name in jcenter
        websiteUrl = siteUrl
        vcsUrl = gitUrl
        licenses = ["Apache-2.0"]
        publish = true
    }
}

到目前爲止,完整的build.gradle腳本如下:
項目根目錄下build.gradle腳本內容爲:

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:1.3.0'
        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.0'
        classpath 'com.github.dcendents:android-maven-gradle-plugin:1.3'
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

app目錄下build.gradle腳本內容爲:

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

group = "com.myutils"
version = "0.1"

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.3"

    defaultConfig {
        applicationId "example.com.myutils"
        minSdkVersion 8
        targetSdkVersion 23
        versionCode 1
        versionName "1.0"

        ndk {
            moduleName "hello-jni"
            ldLibs "log", "z", "m"
            abiFilters "armeabi", "armeabi-v7a", "x86"
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

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

def siteUrl = 'https://github.com/xxxxxx'       // project homepage
def gitUrl = 'https://github.com/xxxxxx.git'

install {
    repositories.mavenInstaller {
        // This generates POM.xml with proper parameters
        pom {
            project {
                packaging 'aar'
                name 'Utils For Android'          // project title
                url siteUrl
                // Set your license
                licenses {
                    license {
                        name 'The Apache Software License, Version 2.0'
                        url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                    }
                }
                developers {
                    developer {
                        id 'test'                   // your user id 
                        name 'csky'                 // your user name
                        email '[email protected]'         // your email
                    }
                }
                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 = "utils"             //project name in jcenter
        websiteUrl = siteUrl
        vcsUrl = gitUrl
        licenses = ["Apache-2.0"]
        publish = true
    }
}

8、上傳到Jcenter倉庫
根據上面的build.gradle,會產生幾個特別的gradle任務:

javadocJar
sourcesJar
install
bintrayUpload

通過gradew執行這些任務即可。

gradew javadocJar
gradew sourcesJar
gradew install
gradew bintrayUpload

或者通過Android Studio的最右邊欄的Gradle窗口分別可視化操作,點擊執行。

9、請求審覈
當bintrayUpload成功之後,
在我的主頁https://bintray.com/openproject/右下部分Latest Activity塊,會看到你提交了一個項目,
從這個Latest Activity列表中點擊你的項目,
進入詳情頁https://bintray.com/openproject/maven/lesscode-core/view
找到Maven Central標籤,
鼠標放上去它會提示你去提交審覈,點擊進入後,隨便寫什麼都可以了。
只要上面沒問題,一般審覈很快,幾個小時就差不多了。
庫的默認地址:http://dl.bintray.com/申請的名字/maven
這次審覈通過了,後面升級就不用再審覈了。

10、依賴庫的引用(使用)
在需要引用依賴庫的android studio工程中的build.gradle中添加引用:

compile 'com.myutils:app:latest.release'  //最新版,自動更新
或者
compile 'com.myutils:app:0.2'  //指定版本

剩下的便是在自己代碼中盡情的享受依賴庫帶來的好處吧!

android studio 依賴庫的開發到目前已經講解完成類,下一篇,咱們就聊聊android studio 插件的開發。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章