上一節,我們以實例的方式,講解了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 插件的開發。