高級構建定制 - Advanced Build Customization

構建選項

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