任务

一个 Task 有 4 个属性“作用域”。你可以通过名称从构建文件访问这些属性，或者通过调用 Task.property(java.lang.String) 方法。你可以通过调用 Task.setProperty(java.lang.String, java.lang.Object) 方法更改这些属性的值。

默认情况下，除非任务正在等待异步工作，并且另一个（非依赖）任务已准备好执行，否则任务不会并行执行。并行执行可以通过启动构建时使用 --parallel 标志来启用。在并行模式下，不同项目（即多项目构建中）的任务能够并行执行。

将由此任务执行的 Action 对象序列，按执行顺序排列。

此任务的 AntBuilder。你可以在你的构建文件中使用它来执行 ant 任务。

此任务的 Convention 对象。 Plugin 可以使用约定对象为此任务贡献属性和方法。

此任务的依赖项。

此任务的描述。

此任务的可销毁项。

检查任务是否实际执行了任何工作。即使一个 Task 执行了，它也可能确定它无事可做。例如，一个编译任务可能会确定自上次运行任务以来，源文件没有更改。

返回此任务是否已启用。

扩展的容器。

返回最终确定此任务的任务。

此任务所属的任务组。任务组用于报告和用户界面，以便在向用户呈现任务列表时将相关任务分组在一起。

此任务的输入。

此任务的本地状态。

此任务的 logger。你可以在你的构建文件中使用它来编写日志消息。

LoggingManager 可以用于接收日志记录并控制此任务的标准输出/错误捕获。默认情况下，System.out 在 QUIET 日志级别重定向到 Gradle 日志记录系统，System.err 在 ERROR 日志级别重定向。

返回此任务必须在其之后运行的任务。

此任务的名称。该名称在其 Project 中唯一标识该任务。

此任务的输出。

任务的路径，它是任务的完全限定名称。任务的路径是其 Project 的路径加上任务的名称，用 : 分隔。

此任务所属的 Project。

当启用配置缓存时，不支持从任务 action 调用此方法。

返回此任务应该在其之后运行的任务。

此任务的执行状态。这提供了有关此任务执行的信息，例如它是否已执行、已跳过、已失败等。

返回一个 TaskDependency，其中包含此任务依赖的所有任务。

当启用配置缓存时，不支持从任务 action 调用此方法。

返回此任务可以用来写入临时文件的目录。每个任务实例都提供一个单独的临时目录。不能保证此目录的内容会保留到任务执行完毕之后。

此任务的超时时间。

  task myTask {
      timeout = Duration.ofMinutes(10)
  }

如果任务运行时间超过指定的时间量，则执行此任务的线程将被中断。 为了使任务能够使用此功能正常工作，它需要对中断做出反应，并且必须清理它打开的任何资源。

默认情况下，任务永不超时。

向此任务添加给定的依赖项。 有关可以用作任务依赖项的对象类型的描述，请参见此处。

将给定的闭包添加到此任务的 action 列表的开头。执行时，闭包将传递此任务作为参数。

将给定的 Action 添加到此任务的 action 列表的开头。

将给定的 Action 添加到此任务的 action 列表的开头。

将给定的闭包添加到此任务的 action 列表的末尾。执行时，闭包将传递此任务作为参数。

将给定的 Action 添加到此任务的 action 列表的末尾。

将给定的 Action 添加到此任务的 action 列表的末尾。

不跟踪任务的状态。

指示 Gradle 将此任务视为未跟踪任务。

为此任务添加给定的最终化器任务。

task taskY {
    finalizedBy "taskX"
}

有关可用于指定最终任务的对象类型的描述，请参阅此处。

确定此任务是否具有给定的属性。有关任务可用的属性的详细信息，请参见此处。

指定此任务必须在所有提供的任务之后运行。

task taskY {
    mustRunAfter "taskX"
}

对于每个提供的任务，此操作都会添加任务“排序”，并且不指定任务之间的“依赖关系”。 因此，即使不先执行示例中的“taskX”，仍然可以执行“taskY”。

有关可用于指定排序关系的对象类型的描述，请参阅此处。

仅当给定的闭包返回 true 时才执行任务。闭包将在任务执行时而不是在配置期间进行评估。闭包将传递一个参数，即此任务。如果闭包返回 false，则将跳过该任务。

您可以添加多个此类谓词。 如果任何谓词返回 false，则会跳过该任务。

典型用法：myTask.onlyIf { isProductionEnvironment() }

仅当给定的 spec 满足时才执行任务。spec 将在任务执行时而不是在配置期间进行评估。如果 Spec 不满足，则将跳过该任务。

您可以添加多个此类谓词。 如果任何谓词返回 false，则会跳过该任务。

典型用法（来自 Java）

myTask.onlyIf("run only in production environment", new Spec<Task>() {
   boolean isSatisfiedBy(Task task) {
      return isProductionEnvironment();
   }
});

仅当给定的 spec 满足时才执行任务。spec 将在任务执行时而不是在配置期间进行评估。如果 Spec 不满足，则将跳过该任务。

您可以添加多个此类谓词。 如果任何谓词返回 false，则会跳过该任务。

典型用法（来自 Java）

myTask.onlyIf(new Spec<Task>() {
   boolean isSatisfiedBy(Task task) {
      return isProductionEnvironment();
   }
});

返回此任务的给定属性的值。此方法按以下方式查找属性

设置此任务的属性。此方法在以下位置搜索具有给定名称的属性，并在找到属性的第一个位置设置该属性。

如果未找到该属性，则会抛出 MissingPropertyException。

指定此任务应在所有提供的任务之后运行。

task taskY {
    shouldRunAfter "taskX"
}

对于每个提供的任务，此操作都会添加任务“排序”，并且不指定任务之间的“依赖关系”。 因此，即使不先执行示例中的“taskX”，仍然可以执行“taskY”。

有关可用于指定排序关系的对象类型的描述，请参阅此处。

注册一个 BuildService，该服务由此任务使用，以便可以遵守 BuildServiceRegistration.getMaxParallelUsages()。

对于声明为 ServiceReference 的任务属性，这不是必需的。