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文件里通过脚本非常easy使用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或者更高的版本号）。