抽象测试任务

目录

特性
方法
脚本块
物业详情
方法详情
脚本块详细信息
API文档：AbstractTestTask
已知亚型：
Test
XCTest

所有测试任务的抽象类。

  • 支持测试监听器
  • 支持报告
  • 支持控制台输出中的报告链接

注意：此抽象类不适用于构建脚本或插件作者的实现。

特性

财产描述
binaryResultsDirectory

内部二进制格式的测试结果的根目录属性。

ignoreFailures

指定当此任务执行的验证失败时构建是否应中断。

reports

该任务可能产生的报告。

方法

方法描述
addTestListener(listener)

向此任务注册一个测试侦听器。还可以考虑以下方便的方法来更快地连接到测试执行：AbstractTestTask.beforeTest(groovy.lang.Closure), AbstractTestTask.afterTest(groovy.lang.Closure), AbstractTestTask.beforeSuite(groovy.lang.Closure),AbstractTestTask.afterSuite(groovy.lang.Closure)

addTestOutputListener(listener)

向此任务注册一个输出侦听器。挂钩输出事件的更快方法是使用该AbstractTestTask.onOutput(groovy.lang.Closure)方法。

afterSuite(closure)

添加一个在测试套件执行后通知的关闭。 ATestDescriptor和TestResult实例作为参数传递给闭包。

afterTest(closure)

添加一个在测试执行后通知的关闭。 ATestDescriptor和TestResult实例作为参数传递给闭包。

beforeSuite(closure)

添加在执行测试套件之前要通知的闭包。实例TestDescriptor作为参数传递给闭包。

beforeTest(closure)

添加在执行测试之前要通知的闭包。实例TestDescriptor作为参数传递给闭包。

onOutput(closure)

添加一个在收到测试输出时收到通知的闭包。 ATestDescriptor和TestOutputEvent实例作为参数传递给闭包。

removeTestListener(listener)

通过此任务取消注册测试侦听器。此方法只会删除通过调用AbstractTestTask.addTestListener(org.gradle.api.tasks.testing.TestListener)此任务添加的侦听器。如果侦听器已向 Gradle 注册，则使用Gradle.addListener(java.lang.Object)此方法将不会执行任何操作。相反，使用Gradle.removeListener(java.lang.Object).

removeTestOutputListener(listener)

取消注册此任务的测试输出侦听器。此方法只会删除通过调用AbstractTestTask.addTestOutputListener(org.gradle.api.tasks.testing.TestOutputListener)此任务添加的侦听器。如果侦听器已向 Gradle 注册，则使用Gradle.addListener(java.lang.Object)此方法将不会执行任何操作。相反，使用Gradle.removeListener(java.lang.Object).

reports(configureAction)

配置此任务可能生成的报告。

setTestNameIncludePatterns(testNamePattern)

设置要包含在执行中的测试名称模式。支持类或方法名称，支持通配符“*”。有关更多信息，请参阅用户指南中有关测试的章节。有关支持模式的更多信息，请参阅TestFilter

脚本块

堵塞描述
reports

配置此任务可能生成的报告。

物业详情

DirectoryProperty binaryResultsDirectory

内部二进制格式的测试结果的根目录属性。

默认：
project.testResultsDir/binary/task.name

boolean ignoreFailures

指定当此任务执行的验证失败时构建是否应中断。

TestTaskReports reports（只读）

该任务可能产生的报告。

方法详情

void addTestListener（TestListener听众）

向此任务注册一个测试侦听器。还可以考虑以下方便的方法来更快地连接到测试执行：AbstractTestTask.beforeTest(groovy.lang.Closure), AbstractTestTask.afterTest(groovy.lang.Closure), AbstractTestTask.beforeSuite(groovy.lang.Closure),AbstractTestTask.afterSuite(groovy.lang.Closure)

该侦听器不会收到其他任务执行的测试的通知。要获得该行为，请使用Gradle.addListener(java.lang.Object).

void addTestOutputListener（TestOutputListener听众）

向此任务注册一个输出侦听器。挂钩输出事件的更快方法是使用该AbstractTestTask.onOutput(groovy.lang.Closure)方法。

void afterSuite（Closure关闭）

添加一个在测试套件执行后通知的关闭。 ATestDescriptor和TestResult实例作为参数传递给闭包。

在执行所有测试套件后也会调用此方法。提供的描述符将有一个空的父套件。

void afterTest（Closure关闭）

添加一个在测试执行后通知的关闭。 ATestDescriptor和TestResult实例作为参数传递给闭包。

void beforeSuite（Closure关闭）

添加在执行测试套件之前要通知的闭包。实例TestDescriptor作为参数传递给闭包。

在执行任何测试套件之前也会调用此方法。提供的描述符将有一个空的父套件。

void beforeTest（Closure关闭）

添加在执行测试之前要通知的闭包。实例TestDescriptor作为参数传递给闭包。

void onOutput（Closure关闭）

添加一个在收到测试输出时收到通知的闭包。 ATestDescriptor和TestOutputEvent实例作为参数传递给闭包。 

apply plugin: 'java'

test {
   onOutput { descriptor, event ->
       if (event.destination == TestOutputEvent.Destination.StdErr) {
           logger.error("Test: " + descriptor + ", error: " + event.message)
       }
   }
}

void removeTestListener（TestListener听众）

通过此任务取消注册测试侦听器。此方法只会删除通过调用AbstractTestTask.addTestListener(org.gradle.api.tasks.testing.TestListener)此任务添加的侦听器。如果侦听器已向 Gradle 注册，则使用Gradle.addListener(java.lang.Object)此方法将不会执行任何操作。相反，使用Gradle.removeListener(java.lang.Object).

void removeTestOutputListener（TestOutputListener听众）

取消注册此任务的测试输出侦听器。此方法只会删除通过调用AbstractTestTask.addTestOutputListener(org.gradle.api.tasks.testing.TestOutputListener)此任务添加的侦听器。如果侦听器已向 Gradle 注册，则使用Gradle.addListener(java.lang.Object)此方法将不会执行任何操作。相反，使用Gradle.removeListener(java.lang.Object).

TestTaskReports reports（配置动作）Action<? super TestTaskReports>

配置此任务可能生成的报告。

AbstractTestTask setTestNameIncludePatterns（测试名称模式）List<String>

设置要包含在执行中的测试名称模式。支持类或方法名称，支持通配符“*”。有关更多信息，请参阅用户指南中有关测试的章节。有关支持模式的更多信息，请参阅TestFilter

脚本块详细信息

reports{ }

配置此任务可能生成的报告。

代表们：
TestTaskReports从reports