Android Gradle 插件中文指南

7.2 操纵任务

普通的 Java 工程有一个有限的任务集合，这些任务相互配合创建一个输出。 classes 是一个编译Java源代码的任务。在 build.gradle 中通过脚本访问和使用 classes 任务是很简单的。可以通过 project.tasks.classes 快捷访问。

对于 Android 工程来说就比较复杂了，因为可能有很多相同的任务，他们的名字是基于 Build Types和Product Flavors 生成的。

为了解决这个问题， android 对象提供了两个属性：

ApplicationVariant, LibraryVariant, and TestVariant 这三个对象都会分别返回一个DomainObjectCollection。

请注意访问这些集合中的任何一个都会触发生成所有的创建。这意味着访问这些集合后无须重新配置就会产生。

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的任务
aidlCompile	AidlCompile	编译AIDL文件的任务
renderscriptCompile	RenderscriptCompile	编译Renderscript文件的任务
mergeResources	MergeResources	合并资源的任务
mergeAssets	MergeAssets	合并资源的任务
processResources	ProcessAndroidResources	处理和编译资源的任务
generateBuildConfig	GenerateBuildConfig	生成BuildConfig类的任务
javaCompile	JavaCompile	编译Java代码的任务
processJavaResources	Copy	处理Java资源的任务
assemble	DefaultTask	这个variant的assemble引导任务

ApplicationVariant类还有以下属性：

属性名	属性类型	说明
buildType	BuildType	variant的BuildType。
productFlavors	List\	variant的ProductFlavors，不能为空，但可以是空值
mergedFlavor	ProductFlavor	android.defaultConfig和variant.productFlavors合并
signingConfig	SigningConfig	这个variant使用的SigningConfig对象
isSigningReady	boolean	如果为true则说明variant已经具备签名所需的一切信息
testVariant	BuildVariant	将会测试这个variant的TestVariant
dex	Dex	dex代码的任务，如果variant是一个库可以为null
packageApplication	PackageApplication	生成最终AP看的任务，如果variant是一个库可以为null
zipAlign	ZipAlign	zip压缩apk的任务，如果variant是一个库或者APK不能被签名可以为null
install	DefaultTask	安装任务，可以为null。
uninstall	DefaultTask	卸载任务

LibraryVariant类还有以下属性：

属性名	属性类型	说明
buildType	BuildType	variant的BuildType
mergedFlavor	ProductFlavor	就是defaultConfig
testVariant	BuildVariant	将要测试这个variant的Build Variant
packageLibrary	Zip	把库打包成一个AAR存档的任务，如果不是一个库值为Null

TestVariant类还有以下属性：

属性名	属性类型	说明
buildType	BuildType	variant的BuildType。
productFlavors	List\	variant的ProductFlavors，不能为空，但可以是空值
mergedFlavor	ProductFlavor	android.defaultConfig和variant.productFlavors合并
signingConfig	SigningConfig	这个variant使用的SigningConfig对象
isSigningReady	boolean	如果为true则说明variant已经具备签名所需的一切信息
testVariant	BaseVariant	将会测试这个variant的BaseVariant
dex	Dex	dex代码的任务，如果variant是一个库可以为null
packageApplication	PackageApplication	生成最终AP看的任务，如果variant是一个库可以为null
zipAlign	ZipAlign	zip压缩apk的任务，如果variant是一个库或者APK不能被签名可以为null
install	DefaultTask	安装任务，可以为null。
uninstall	DefaultTask	卸载任务
connectedAndroidTest	DefaultTask	在已连接的设备上运行android测试的任务
providerAndroidTest	DefaultTask	使用扩展的API运行android测试的任务

Android特定任务类型的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
  - To change the final output file use "outputFile" on the variant object directly.
ZipAlign
- File inputFile
- File outputFile
  - To change the final output file use "outputFile" on the variant object directly.

每一个任务类型的 API 都会因为 Gradle 的工作方式以及 Android plugin 的设置受到限制。首先，Gradle 限制只能配置任务的输入/输出以及一些可选的标志。所以，这里的这些任务只能定义输入/输出。

其次，大多数任务的输入并不唯一，通常会混合 sourceSets，Build Types 以及 Product Flavors。为了保持构建简单以及可读性，我们的目标是让开发者通过 DSL 通过这些对象修改构建，而不是深入的了解任务的输入和选项进而修改它们。

还要注意的是，除了 ZipAlign 任务类型，其他所有的任务都需要设置私有数据让他们运行。这就意味着不能基于这些类型手动的创建新的任务。

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