任务

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

APlugin可以Task使用其Convention对象向 a 添加方法。

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

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

对于AntBuilder这个任务。您可以在构建文件中使用它来执行 ant 任务。

Convention此任务的对象。APlugin可以使用约定对象来为此任务提供属性和方法。

该任务的依赖关系。

此任务的描述。

此任务的可破坏物。

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

返回此任务是否启用。

扩展的容器。

返回完成此任务的任务。

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

此任务的输入。

此任务的本地状态。

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

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

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

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

该任务的输出。

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

Project该任务属于哪个。

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

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

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

返回一个TaskDependency包含该任务所依赖的所有任务的a。

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

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

该任务的超时时间。

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() }

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

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

典型用法（来自 Java）：

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

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

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

典型用法（来自 Java）：

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

返回此任务的给定属性的值。该方法按如下方式定位属性：

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

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

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

task taskY {
    shouldRunAfter "taskX"
}

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

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

注册BuildService此任务使用的 a，以便 BuildServiceRegistration.getMaxParallelUsages()可以兑现。