第 7 章 高級構建定制

構建選項

Java 編譯選項）

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

默認值是“1.6”。這個設置將影響所有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
?
    }
}

這將應用所有使用dex的task。

操作 task

基礎Java項目有一組有限的task用于互相處理生成一個輸出。classes是一個編譯Java源代碼的task。可以在build.gradle文件中通過腳本很容易使用classes。這是project.tasks.classes的縮寫。

在Android項目中，相比之下這就有點復雜。因為Android項目中會有大量相同的task，并且它們的名字基于_Build Types_和_Product Flavor_生成。

為了解決這個問題，android對象有兩個屬性：

• applicationVariants（只適用于app plugin）
• libraryVariants（只適用于library plugin）
• testVariants（兩個plugin都適用）

這三個都會分別返回一個ApplicationVariant、LibraryVariant和TestVariant對象的DomainObjectCollection。

注意使用這三個collection中的其中一個都會觸發(fā)生成所有對應的task。這意味著使用collection之后不需要更改配置。

DomainObjectCollection可以直接訪問所有對象，或者通過過濾器進行篩選。

android.applicationVariants.each { variant ->
    ....
}

這三個variant類都共享下面的屬性：

ApplicationVariant類還有以下附加屬性：

LibraryVariant類還有以下附加屬性：

TestVariant類還有以下屬性：

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只能配置輸入輸出的路徑和一些可能使用的選項標識。因此，task只能定義一些輸入或者輸出。

其次，這里面大多數(shù)task的輸入都不是單一的，一般都混合了sourceSet、_Build Type_和_Product Flavor_中的值。為了保持構建文件的簡單和可讀性，目標是要讓開發(fā)者通過DSL語言修改這些對象來配飾構建的過程，而不是深入修改輸入和task的選項。

另外需要注意，除了ZipAlign這個task類型，其它所有類型都要求設置私有數(shù)據(jù)來讓它們運行。這意味著不可能自動創(chuàng)建這些類型的新task實例。

這些API也可能會被更改。一般來說，目前的API是圍繞著給定task的輸入和輸出入口來添加額外的處理（如果需要的時候）。歡迎反饋意見，特別是那些沒有預見過的需求。

對于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文檔）。設置使用1.7版本，需要修改你的構建文件：

android {
    compileSdkVersion 19
    buildToolsVersion "19.0.0"
?
    defaultConfig {
        minSdkVersion 7
        targetSdkVersion 19
    }
?
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_7
        targetCompatibility JavaVersion.VERSION_1_7
    }
}

注意：
你可以將minSdkVersion的值設置為19之前的版本，只是你只能使用除了try with resources之外的其它新語言特性。如果你想要使用try with resources特性，你就需要把minSdkVersion也設置為19。

你同樣也需要確認Gradle使用1.7或者更高版本的JDK（Android Gradle plugin也需要0.6.1或者更高的版本）。