android {
compileOptions {
sourceCompatibility = "1.6"
targetCompatibility = "1.6"
}
}
默認值是“1.6”。這個設(shè)置將影響所有task編譯Java源代碼。
android {
aaptOptions {
noCompress 'foo', 'bar'
ignoreAssetsPattern "!.svn:!.git:!.ds_store:!*.scc:.*:<dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"
}
}
這將影響所有使用aapt的task。
android {
dexOptions {
incremental false
preDexLibraries = false
jumboMode = false
}
}
這將應(yīng)用所有使用dex的task。
基礎(chǔ)Java項目有一組有限的task用于互相處理生成一個輸出。
classes
是一個編譯Java源代碼的task??梢栽赽uild.gradle文件中通過腳本很容易使用classes
。這是project.tasks.classes
的縮寫。
在Android項目中,相比之下這就有點復(fù)雜。因為Android項目中會有大量相同的task,并且它們的名字基于_Build Types_和_Product Flavor_生成。
為了解決這個問題,android
對象有兩個屬性:
applicationVariants
(只適用于app plugin)libraryVariants
(只適用于library plugin)testVariants
(兩個plugin都適用)這三個都會分別返回一個ApplicationVariant、LibraryVariant和TestVariant對象的DomainObjectCollection。
注意使用這三個collection中的其中一個都會觸發(fā)生成所有對應(yīng)的task。這意味著使用collection之后不需要更改配置。
DomainObjectCollection可以直接訪問所有對象,或者通過過濾器進行篩選。
android.applicationVariants.each { variant ->
....
}
這三個variant類都共享下面的屬性:
屬性名 | 屬性類型 | 說明 |
---|---|---|
name | String | Variant的名字,必須是唯一的。 |
description | String | Variant的描述說明。 |
dirName | String | Variant的子文件夾名,必須也是唯一的??赡芤矔胁恢挂粋€子文件夾,例如“debug/flavor1” |
baseName | String | Variant輸出的基礎(chǔ)名字,必須唯一。 |
outputFile | File | Variant的輸出,這是一個可讀可寫的屬性。 |
processManifest | ProcessManifest | 處理Manifest的task。 |
aidlCompile | AidlCompile | 編譯AIDL文件的task。 |
renderscriptCompile | RenderscriptCompile | 編譯Renderscript文件的task。 |
mergeResources | MergeResources | 混合資源文件的task。 |
mergeAssets | MergeAssets | 混合asset的task。 |
processResources | ProcessAndroidResources | 處理并編譯資源文件的task。 |
generateBuildConfig | GenerateBuildConfig | 生成BuildConfig類的task。 |
javaCompile | JavaCompile | 編譯Java源代碼的task。 |
processJavaResources | Copy | 處理Java資源的task。 |
assemble | DefaultTask | Variant的標(biāo)志性assemble task。 |
ApplicationVariant類還有以下附加屬性:
屬性名 | 屬性類型 | 說明 |
---|---|---|
buildType | BuildType | Variant的BuildType。 |
productFlavors | List |
Variant的ProductFlavor。一般不為空但也允許空值。 |
mergedFlavor | ProductFlavor | android.defaultConfig和variant.productFlavors的合并。 |
signingConfig | SigningConfig | Variant使用的SigningConfig對象。 |
isSigningReady | boolean | 如果是true則表明這個Variant已經(jīng)具備了所有需要簽名的信息。 |
testVariant | BuildVariant | 將會測試這個Variant的TestVariant。 |
dex | Dex | 將代碼打包成dex的task。如果這個Variant是個庫,這個值可以為空。 |
packageApplication | PackageApplication | 打包最終APK的task。如果這個Variant是個庫,這個值可以為空。 |
zipAlign | ZipAlign | zip壓縮APK的task。如果這個Variant是個庫或者APK不能被簽名,這個值可以為空。 |
install | DefaultTask | 負責(zé)安裝的task,不能為空。 |
uninstall | DefaultTask | 負責(zé)卸載的task。 |
LibraryVariant類還有以下附加屬性:
屬性名 | 屬性類型 | 說明 |
---|---|---|
buildType | BuildType | Variant的BuildType. |
mergedFlavor | ProductFlavor | The defaultConfig values |
testVariant | BuildVariant | 用于測試這個Variant。 |
packageLibrary | Zip | 用于打包庫項目的AAR文件。如果是個庫項目,這個值不能為空。 |
TestVariant類還有以下屬性:
屬性名 | 屬性類型 | 說明 |
---|---|---|
buildType | BuildType | Variant的Build Type。 |
productFlavors | List |
Variant的ProductFlavor。一般不為空但也允許空值。 |
mergedFlavor | ProductFlavor | android.defaultConfig和variant.productFlavors的合并。 |
signingConfig | SigningConfig | Variant使用的SigningConfig對象。 |
isSigningReady | boolean | 如果是true則表明這個Variant已經(jīng)具備了所有需要簽名的信息。 |
testedVariant | BaseVariant | TestVariant測試的BaseVariant |
dex | Dex | 將代碼打包成dex的task。如果這個Variant是個庫,這個值可以為空。 |
packageApplication | PackageApplication | 打包最終APK的task。如果這個Variant是個庫,這個值可以為空。 |
zipAlign | ZipAlign | zip壓縮APK的task。如果這個Variant是個庫或者APK不能被簽名,這個值可以為空。 |
install | DefaultTask | 負責(zé)安裝的task,不能為空。 |
uninstall | DefaultTask | 負責(zé)卸載的task。 |
connectedAndroidTest | DefaultTask | 在連接設(shè)備上行執(zhí)行Android測試的task。 |
providerAndroidTest | DefaultTask | 使用擴展API執(zhí)行Android測試的task。 |
Android task特有類型的API:
每個task類型的API由于Gradle的工作方式和Android plugin的配置方式而受到限制。 首先,Gradle意味著擁有的task只能配置輸入輸出的路徑和一些可能使用的選項標(biāo)識。因此,task只能定義一些輸入或者輸出。
其次,這里面大多數(shù)task的輸入都不是單一的,一般都混合了sourceSet、_Build Type_和_Product Flavor_中的值。為了保持構(gòu)建文件的簡單和可讀性,目標(biāo)是要讓開發(fā)者通過DSL語言修改這些對象來配飾構(gòu)建的過程,而不是深入修改輸入和task的選項。
另外需要注意,除了ZipAlign這個task類型,其它所有類型都要求設(shè)置私有數(shù)據(jù)來讓它們運行。這意味著不可能自動創(chuàng)建這些類型的新task實例。
這些API也可能會被更改。一般來說,目前的API是圍繞著給定task的輸入和輸出入口來添加額外的處理(如果需要的時候)。歡迎反饋意見,特別是那些沒有預(yù)見過的需求。
對于Gradle的task(DefaultTask,JavaCompile,Copy,Zip),請參考Gradle文檔。
即將到來... 對于Gradle的task(DefaultTask,JavaCompile,Copy,Zip),請參考Gradle文檔。
使用Android KitKat(19版本的buildTools)就可以使用diamond operator,multi-catch,switch中使用字符串,try with resource等等(譯注:都是JDK7的一些新特性,詳情請參考JDK7文檔)。設(shè)置使用1.7版本,需要修改你的構(gòu)建文件:
android {
compileSdkVersion 19
buildToolsVersion "19.0.0"
defaultConfig {
minSdkVersion 7
targetSdkVersion 19
}
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_7
targetCompatibility JavaVersion.VERSION_1_7
}
}
注意:
你可以將minSdkVersion
的值設(shè)置為19之前的版本,只是你只能使用除了try with resources之外的其它新語言特性。如果你想要使用try with resources特性,你就需要把minSdkVersion
也設(shè)置為19。
你同樣也需要確認Gradle使用1.7或者更高版本的JDK(Android Gradle plugin也需要0.6.1或者更高的版本)。