Android Gradle Plugin指南（六）——高级构建定制

原文地址：http://tools.android.com/tech-docs/new-build-system/user-guide#TOC-Advanced-Build-Customization

7、 Advanced Build Customization（高级构建定制）

7.1 Build options（构建选项）

7.1.1 Java Compilation options（Java编译选项）

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

默认值是“1.6”。这个设置将影响所有task编译Java源代码。

7.1.2 aapt options（aapt选项）

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

这将影响所有使用aapt的task。

7.1.3 dex options（dex选项）

    android {
        dexOptions {
            incremental false

            preDexLibraries = false

            jumboMode = false

        }
    }

这将应用所有使用dex的task。

7.2 Manipulation tasks（操作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中的其中一个都会触发生成所有对应的task。这意味着使用collection之后不需要更改配置。

DomainObjectCollection可以直接访问所有对象，或者通过过滤器进行筛选。

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

这三个variant类都共享下面的属性：

属性名	属性类型	说明
name	String	Variant的名字，必须是唯一的。
description	String	Variant的描述说明。
dirName	String	Variant的子文件夹名，必须也是唯一的。可能也会有不止一个子文件夹，例如“debug/flavor1”
baseName	String	Variant输出的基础名字，必须唯一。
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的标志性assemble task。

ApplicationVariant类还有以下附加属性：

属性名	属性类型	说明
buildType	BuildType	Variant的BuildType。
productFlavors	List<ProductFlavor>	Variant的ProductFlavor。一般不为空但也允许空值。
mergedFlavor	ProductFlavor	android.defaultConfig和variant.productFlavors的合并。
signingConfig	SigningConfig	Variant使用的SigningConfig对象。
isSigningReady	boolean	如果是true则表明这个Variant已经具备了所有需要签名的信息。
testVariant	BuildVariant	将会测试这个Variant的TestVariant。
dex	Dex	将代码打包成dex的task。如果这个Variant是个库，这个值可以为空。
packageApplication	PackageApplication	打包最终APK的task。如果这个Variant是个库，这个值可以为空。
zipAlign	ZipAlign	zip压缩APK的task。如果这个Variant是个库或者APK不能被签名，这个值可以为空。
install	DefaultTask	负责安装的task，不能为空。
uninstall	DefaultTask	负责卸载的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<ProductFlavor>	Variant的ProductFlavor。一般不为空但也允许空值。
mergedFlavor	ProductFlavor	android.defaultConfig和variant.productFlavors的合并。
signingConfig	SigningConfig	Variant使用的SigningConfig对象。
isSigningReady	boolean	如果是true则表明这个Variant已经具备了所有需要签名的信息。
testedVariant	BaseVariant	TestVariant测试的BaseVariant
dex	Dex	将代码打包成dex的task。如果这个Variant是个库，这个值可以为空。
packageApplication	PackageApplication	打包最终APK的task。如果这个Variant是个库，这个值可以为空。
zipAlign	ZipAlign	zip压缩APK的task。如果这个Variant是个库或者APK不能被签名，这个值可以为空。
install	DefaultTask	负责安装的task，不能为空。
uninstall	DefaultTask	负责卸载的task。
connectedAndroidTest	DefaultTask	在连接设备上行执行Android测试的task。
providerAndroidTest	DefaultTask	使用扩展API执行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只能配置输入输出的路径和一些可能使用的选项标识。因此，task只能定义一些输入或者输出。

其次，这里面大多数task的输入都不是单一的，一般都混合了sourceSet、Build Type和Product Flavor中的值。为了保持构建文件的简单和可读性，目标是要让开发者通过DSL语言修改这些对象来配饰构建的过程，而不是深入修改输入和task的选项。

另外需要注意，除了ZipAlign这个task类型，其它所有类型都要求设置私有数据来让它们运行。这意味着不可能自动创建这些类型的新task实例。

这些API也可能会被更改。一般来说，目前的API是围绕着给定task的输入和输出入口来添加额外的处理（如果需要的时候）。欢迎反馈意见，特别是那些没有预见过的需求。

对于Gradle的task（DefaultTask，JavaCompile，Copy，Zip），请参考Gradle文档。

7.3 BuildType and Product Flavor property reference（BuildType和Product Flavor属性参考）

coming soon。。。。= =
对于Gradle的task（DefaultTask，JavaCompile，Copy，Zip），请参考Gradle文档。

7.4 Using sourceCompatibility 1.7（使用（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或者更高的版本）。