操作task之applicationVariants

一般的 Java 项目中有一组 task 用于协同处理并最终生成一个输出。
classes task 用于编译 Java 源代码。
可以在 build.gradle 文件中使用 classes 访问 classes task 。classes 是 project.tasks.classes 的缩写。

相比之下在 Android 项目中这就有点复杂。因为 Android 项目中会有大量相同的 task，并且它们的名字基于Build Types 和 Product Flavor 生成。

为了解决这个问题，android 对象有三个属性：

• applicationVariants（只适用于 app plugin）
• libraryVariants（只适用于 library plugin）
• testVariants（app、library 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	合并 assets 的 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 是 Library，该值可为空
packageApplication	PackageApplication	打包最终 APK 的 task。如果该 Variant 是 Library，该值可为空
zipAlign	ZipAlign	对 APK 进行 zipalign 的 task。如果该 Variant 是 Library 或者 APK 不能被签名时，该值可为空
install	DefaultTask	负责安装的 task，可为空
uninstall	DefaultTask	负责卸载的 task

LibraryVariant 类还有以下附加属性：

属性名	属性类型	说明
buildType	BuildType	Variant 的 BuildType
mergedFlavor	ProductFlavor	只有 android.defaultConfig
testVariant	BuildVariant	用于测试 Variant
packageLibrary	Zip	用于打包 Library 项目的 AAR 文件。如果是 Library 项目，该值不能为空

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 是 Library，该值可为空
packageApplication	PackageApplication	打包最终 APK 的 task。如果该 Variant 是 Library，该值可为空
zipAlign	ZipAlign	对 APK 进行 zipalign 的 task。如果该 Variant 是 Library 或者 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 的选项。

另外需要注意，上面的 task 中除了 ZipAlign，其它都要求设置私有数据进行工作。这意味着不能手动创建这些类型的 task 实例。

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

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