任务

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

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

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

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

此任务的依赖项。

此任务的描述。

此任务的可销毁项。

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

返回此任务是否启用。

扩展容器。

返回完成此任务的任务。

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

此任务的输入。

此任务的本地状态。

此任务的记录器。您可以在构建文件中使用它来写入日志消息。

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

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

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

此任务的输出。

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

此任务所属的 Project。

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

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

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

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

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

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

此任务的超时。

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

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

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

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

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

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

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

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

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

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

不跟踪任务的状态。

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

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

task taskY {
    finalizedBy "taskX"
}

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

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

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

task taskY {
    mustRunAfter "taskX"
}

对于每个提供的任务，此操作添加一个任务“排序”，但不指定任务之间的“依赖关系”。因此，在示例中仍然可以在不先执行“taskX”的情况下执行“taskY”。

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

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

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

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

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

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

典型用法（来自 Java）

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

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

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

典型用法（来自 Java）

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

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

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

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

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

task taskY {
    shouldRunAfter "taskX"
}

对于每个提供的任务，此操作添加一个任务“排序”，但不指定任务之间的“依赖关系”。因此，在示例中仍然可以在不先执行“taskX”的情况下执行“taskY”。

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

注册此任务使用的 BuildService，以便可以遵守 BuildServiceRegistration.getMaxParallelUsages()。

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