Gradle是Android Studio中默認(rèn)的構(gòu)建系統(tǒng)。Gradle 采用了 Groovy 語言作為主要的腳本語言。我們app項(xiàng)目的 build.gradle 和APP Moudle里的build.gradle文件,就是一個 Groovy 類。接下來讓我就介紹下Gradle的基本功能和高級技巧。
基本用法
apply plugin: 'com.android.application'
android {
compileSdkVersion 26
buildToolsVersion "26.0.0"
defaultConfig {
applicationId "com.renny.gradletest"
minSdkVersion 17
targetSdkVersion 26
versionCode 1
versionName "1.0"
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
exclude group: 'com.android.support', module: 'support-annotations'
})
compile 'com.android.support:appcompat-v7:26.+'
compile 'com.android.support.constraint:constraint-layout:1.0.2'
testCompile 'junit:junit:4.12'
}
上面的代碼就是剛建好的Android工程時,studio為我們創(chuàng)建的默認(rèn)Module里的build.gradle
,采用的Gradle版本是2.3.3。而Gradle大部分功能配置也是在個文件里實(shí)現(xiàn)的。
apply plugin:
:用來指定用的是哪個插件,開發(fā)中常見的值有
'com.android.application'
:Android APP插件(打包得到的是.apk文件)
'com.android.library'
:Android庫插件(打包得到的是.aar文件)
'java'
:普通的java插件(打包得到的是.jar文件)
android{}
用來指定Android打包插件的相關(guān)屬性,其包含如下節(jié)點(diǎn)
compileSdkVersion(apiLevel)
:設(shè)置編譯時用的Android版本
buildToolsVersion(buildToolsVersionName)
:設(shè)置編譯時使用的構(gòu)建工具的版本
defaultConfig
:設(shè)置一些默認(rèn)屬性,其可用屬性是buildTypes和productFlavors之和。(productFlavors默認(rèn)文件里沒有,會在后面介紹)
buildTypes
:配置構(gòu)建類型,可打出不同類型的包,常見的有debug和release兩種,當(dāng)然你還可以再增加N種
productFlavors
:配置不同風(fēng)格的APP,在buildTypes的基礎(chǔ)上還可以讓每一個類型的APP擁有不同的風(fēng)格,所以最終可以打出的APK的數(shù)量就是buildTypes乘以productFlavors。構(gòu)建的變量名稱是productFlavors+buildTypes。
dependencies
:配置依賴,這項(xiàng)可定是從eclipse換到studio后感覺最方便的一處了。各種外部依賴直接一行代碼搞定,不用手動下依賴包了。其中
compile fileTree(dir: 'libs', include: ['*.jar'])
的意思是依賴libs目錄下全部的jar文件。
進(jìn)階用法
好了,上面的基本配置只是Gradle簡單的用法,其實(shí)我們可以用Gradle玩出很多花樣來。
manifest動態(tài)配置
很多第三方SDK需要在AndroidManifest.xml中配置你的一些key信息,以友盟推送為例:
<meta-data
android:value="YOUR_APP_KEY"
android:name="UMENG_APPKEY"/>
但是你不同測試包和正式包的key是不同的,那么就可以這么修改:
<meta-data
android:name="UMENG_APPKEY"
android:value="${UMENG_APPKEY}" />
然后在productFlavors中的各個版本中加上不同的信息,這樣你打出的不同包采用的appkey也會不一樣。
manifestPlaceholders = [UMENG_CHANNEL: "0",
UMENG_APPKEY : "123456789"]
不僅這些自定義元數(shù)據(jù)可以動態(tài)配置,android:icon
,android:label
這些標(biāo)簽也可以修改,這樣打出的不同包就有不同的圖標(biāo)了,方便做區(qū)分
Moudle動態(tài)依賴
在組件化app里面,我們可能在測試包和正式包需要依賴不同組件。比如測試環(huán)境需要調(diào)試模塊,但正式環(huán)境不需要。假如productFlavors
如下,調(diào)試模塊名字為module-test
。
productFlavors {
ceshi{
}
publish{
}
}
那么在dependencies里面就可以這么依賴test
模塊:
ceshiCompile project(':module-test')
同樣buildTypes也是適用的,兩者可以一起或單獨(dú)使用:
debugCompile project(':module-test')
ceshidebugCompile project(':module-test')
代碼中讀取變量
上面的這些功能都是gradle單獨(dú)配置的,但我們往往針對不同的構(gòu)建包有不同的需要在代碼中體現(xiàn)的需求:日志打印,Toast等等。
雖然BuildConfig.DEBUG
字段就可以判斷,但我們可以用buildConfigField
向代碼中傳遞自定義的值,比如不同構(gòu)建包需要不同Host開頭的api地址,不同的https證書路徑等,用法為:
buildConfigField 'type', 'name', '"vaule"'
比如:
defaultConfig {
buildConfigField 'String', 'author', '"renny"'
}
上面的是加在defaultConfig 中的,而加在buildTypes或productFlavors中就會在不同構(gòu)建版本出現(xiàn)不同的值。如果再配置上不同的applicationId
,那么就可以在同一個手機(jī)上同時安裝不同構(gòu)建版本的應(yīng)用。
productFlavors {
ceshi{
applicationId "com.renny.test"
buildConfigField "String", "API_TEST", "http://test.renny.com/android"
}
publish{
applicationId "com.example.publish"
buildConfigField "String", "API_PUBLISH", "http://publish.renny.com/android"
}
}
經(jīng)過上面的介紹,你可能會發(fā)現(xiàn)buildTypes和productFlavors定義很相似,不過他們的差別在于改變 buildType 不會改變應(yīng)用程序的代碼,它們只是處理的東西不同,你可以通過 buildType 來獲取更多的技術(shù)細(xì)節(jié)(例如:build optimization,log level 等等),但是app的內(nèi)容不會改變,相反的,使用productFlavor 配置可以改變app的內(nèi)容(ps:內(nèi)容可以設(shè)想成 package 理解,buildType 沒法改 applicationId)。
Gradle task
Gradle task適合用來完成一些既繁瑣又容易出錯的重復(fù)性手工作,比如批量修改,復(fù)制,重命名文件。
比如applicationVariants.all這個task可以針對每個構(gòu)建版本設(shè)置各種屬性,比如修改每個構(gòu)建版本生成的apk名字:
applicationVariants.all { variant ->
variant.outputs.each { output ->
output.outputFile = new File(
output.outputFile.parent,
("app-${variant.buildType.name}"+"-" + new Date().format('yyyyMMdd') + ".apk").toLowerCase())
}
}
gradle會默認(rèn)匹配生成每種productFlavors*buildTypes的構(gòu)建版本,如果你想跳過其中的幾種就可以這么做:
variantFilter { variant ->
if (variant.buildType.name.equals('release')) {
variant.setIgnore(!variant.getFlavors().get(1).name.equals('ceshi'));
}
if (variant.buildType.name.equals('debug')) {
variant.setIgnore(variant.getFlavors().get(1).name.equals('ceshi'));
}
}