上文 讲述了 Gradle 中关于任务的基础概念，本文开始讲述下 Task 是如何定义的。
为了方便，我们的语境分不开Gradle和Android Gradle Plugin，因此此处不脱离Android环境来介绍Gradle。
我们在讲述任务依赖的时候，提到一个Manager的东西，在这里，我们说到的是Android Gradle Plugin提供的BuildableArtifactsHolder这个类。
一个 Task 如果有有意义的输出，且产物可能被其他的 Task 所使用的时候，我们可以往BuildableArtifactsHolder注册我们的产物，注册方式有这么几种：
createBuildableArtifact/createDirectory/createArtifactFile
这些 api 需要传入创建文件的类型，文件的文件名，动作等，以createArtifactFile的其中一种形式为例：
fun createArtifactFile(
artifactType: ArtifactType,
operationType: OperationType,
taskName: String,
fileName: String) : Provider<RegularFile>artifactType 就是产物类型
operationType 是操作类型，可以是初始化(init)，追加(append)，或者变化(transform)，区别如下：
- 如果指明了是 init，那么它之前不可以有任何针对相同产物类型的调用
- 如果指明了是 append，那么是追加相关的文件
- 如果指明了是 transform，那么就是替换当前的文件。
你可以根据你使用产物的目的来使用不同类型，因为返回值是一个 FileCollection （文件集合，不是文件夹的概念），如果调用的是 transform，你需要注意在 Configuration 阶段对于这些产物调用顺序的问题，如果 B.transform 在 A.transform 之后，那么获取最终产物的时候，就会取走 B 的结果。
BuildableArtifactsHolder 提供的 api 一般都已经让你传入了 taskName，就是让你告诉它，你所产生的产物由哪个任务生成。后续你去根据 artifactType 获取产物（FileCollection）的时候，它会检查这个任务是否执行，如果没有的话会先执行，这部分判断的逻辑由 FileCollection 的 builtBy 做到，由 Gradle 进行管理。
Task 的配置
以上，我们介绍了如何让 Task 的产物和 Task 本身产生一些关联，这种关联建立完成之后，可以看到 createArtifactFile 这个函数的返回值是Provider<RegularFile>，这里代表了一个目的地，我们往这个文件里写入的产物即可；当然这里也可以创建文件夹同理，示例代码：
task.outputFile = variantScope.getArtifacts().createArtifactFile(
InternalArtifactType.BUNDLE,
BuildArtifactsHolder.OperationType.INITIAL,
taskName,
bundleName)然后在 task 定义的地方：
class Task {
private Provider<RegularFile> outputFile;
@OutputFile
public Flie getOutputFile() {
return outputFile.get().asFile();
}
}这样的话，gradle 会自动帮你创建这个文件，开发者需要的只是调用getOutputFile()拿到File然后写入即可。
Task 的联动
我们知道了 Task 产生一个文件的完整流程，我们该如何使用这个文件呢？我们在另外一个 Task 中，定义一下 input
task.input = variantScope.getArtifacts().getArtifactFiles(type); //这里的 type 和上面的type一样，比如 InternalArtifactType.BUNDLE这个拿到是一个 BuildableArtifact 对象，它的声明如下：
interface BuildableArtifact : Iterable<File>, Buildable, Supplier<FileCollection> {
val files : Set<File>
fun isEmpty() : Boolean
}可以使用get()获取一个FileCollection，当再次调用FileCollection.getFiles()方法时，gradle 就会检查产生这个产物的 Task 是否已经执行，如果没有执行，就会先执行前面一个 Task
欢迎关注我的公众号「TalkWithMobile」
本文由 Gemini Wen 创作，采用 知识共享署名4.0 国际许可协议进行许可
本站文章除注明转载/出处外，均为本站原创或翻译，转载前请务必署名
最后编辑时间为: Dec 19, 2020 at 10:25 am