XCTest

API文档: XCTest

执行 XCTest 测试。测试总是在一次执行中运行。

属性

Property 描述
binaryResultsDirectory

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

ignoreFailures

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

reports

该任务可能产生的报告。

runScriptFile

返回测试套件包或可执行文件位置

testInstallDirectory

测试套件包或可执行文件位置

workingDirectory

此测试的工作目录属性。

方法

方法 描述
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)

添加一个闭包,以便在测试套件执行后得到通知。 TestDescriptorTestResult 实例作为参数传递给闭包。

afterTest(closure)

添加一个闭包,以便在测试执行后得到通知。 TestDescriptorTestResult 实例作为参数传递给闭包。

beforeSuite(closure)

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

beforeTest(closure)

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

onOutput(closure)

添加一个闭包,以便在收到测试输出时得到通知。 TestDescriptorTestOutputEvent 实例作为参数传递给闭包。

removeTestListener(listener)

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

removeTestOutputListener(listener)

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

reports(configureAction)

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

setTestNameIncludePatterns(testNamePattern)

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

脚本块

没有脚本块

属性详情

DirectoryProperty binaryResultsDirectory

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

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

boolean ignoreFailures

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

TestTaskReports reports(只读)

该任务可能产生的报告。

RegularFileProperty runScriptFile

返回测试套件包或可执行文件位置

DirectoryProperty testInstallDirectory

测试套件包或可执行文件位置

DirectoryProperty workingDirectory

此测试的工作目录属性。

方法细节

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 闭包)

添加一个闭包,以便在测试套件执行后得到通知。 TestDescriptorTestResult 实例作为参数传递给闭包。

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

void afterTest (Closure 闭包)

添加一个闭包,以便在测试执行后得到通知。 TestDescriptorTestResult 实例作为参数传递给闭包。

void beforeSuite (Closure 闭包)

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

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

void beforeTest (Closure 闭包)

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

void onOutput (Closure 闭包)

添加一个闭包,以便在收到测试输出时得到通知。 TestDescriptorTestOutputEvent 实例作为参数传递给闭包。

@Inject
protected org.gradle.api.publish.maven.internal.dependencies.VersionRangeMapper getVersionRangeMapper()

void removeTestListener (TestListener 监听器)

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

void removeTestOutputListener (TestOutputListener 监听器)

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

TestTaskReports reports (Action<? super TestTaskReports> configureAction)

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

AbstractTestTask setTestNameIncludePatterns (List<String> testNamePattern)

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