高级构建的自定义 - 操作 task
一般的 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：
ProcessManifestFile manifestOutputFile
AidlCompileFile sourceOutputDir
RenderscriptCompileFile sourceOutputDirFile resOutputDir
MergeResourcesFile outputDir
MergeAssetsFile outputDir
ProcessAndroidResourcesFile manifestFileFile resDirFile assetsDirFile sourceOutputDirFile textSymbolOutputDirFile packageOutputFileFile proguardOutputFile
GenerateBuildConfigFile sourceOutputDir
DexFile outputFolder
PackageApplicationFile resourceFileFile dexFileFile javaResourceDirFile jniDirFile outputFile- 直接在 Variant 对象中使用 “outputFile” 可以改变最终的输出文件夹。
ZipAlignFile inputFileFile 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 文档。