鍍金池/ 教程/ Android/ 高級構(gòu)建定制 - Advanced Build Customization
依賴關(guān)系,Android 庫和多項目設(shè)置 - Dependencies,Android Libraries and Multi-
要求 - Requirements
構(gòu)建變種版本 - Build Variants
高級構(gòu)建定制 - Advanced Build Customization
測試 - Testing
基本項目 - Basic Project
簡介 - Introduction

高級構(gòu)建定制 - Advanced Build Customization

構(gòu)建選項

Java 編譯選項)

    android {
        compileOptions {
            sourceCompatibility = "1.6"
            targetCompatibility = "1.6"
        }
    }

默認值是“1.6”。這個設(shè)置將影響所有task編譯Java源代碼。

aapt 選項

    android {
        aaptOptions {
            noCompress 'foo', 'bar'
            ignoreAssetsPattern "!.svn:!.git:!.ds_store:!*.scc:.*:<dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"
        }
    }

這將影響所有使用aapt的task。

dex 選項

    android {
        dexOptions {
            incremental false

            preDexLibraries = false

            jumboMode = false

        }
    }

這將應(yīng)用所有使用dex的task。

操作 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:

  • ProcessManifest
    • File manifestOutputFile
  • AidlCompile
    • File sourceOutputDir
  • RenderscriptCompile
    • File sourceOutputDir
    • File resOutputDir
  • MergeResources
    • File outputDir
  • MergeAssets
    • File outputDir
  • ProcessAndroidResources
    • File manifestFile
    • File resDir
    • File assetsDir
    • File sourceOutputDir
    • File textSymbolOutputDir
    • File packageOutputFile
    • File proguardOutputFile
  • GenerateBuildConfig
    • File sourceOutputDir
  • Dex
    • File outputFolder
  • PackageApplication
    • File resourceFile
    • File dexFile
    • File javaResourceDir
    • File jniDir
    • File outputFile
      • 直接在Variant對象中使用“outputFile”可以改變最終的輸出文件夾。
  • ZipAlign
    • File inputFile
    • File outputFile
      • 直接在Variant對象中使用“outputFile”可以改變最終的輸出文件夾。

每個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文檔。

BuildType 和 Product Flavor 屬性參考

即將到來... 對于Gradle的task(DefaultTask,JavaCompile,Copy,Zip),請參考Gradle文檔。

使用 JDK 1.7 版本的 sourceCompatibility

使用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或者更高的版本)。