API 文档 | XCTest |
---|
执行 XCTest 测试。测试始终在单个执行中运行。
属性 | 描述 |
binaryResultsDirectory | 内部二进制格式测试结果的根目录属性。 |
failOnNoDiscoveredTests | 如果存在测试源,但在测试执行期间未发现任何测试,任务是否应该失败。默认为 true。 |
ignoreFailures | 指定此任务执行的验证失败时是否应中断构建。 |
reports | 此任务可能生成的报告。 |
runScriptFile | 返回测试套件包或可执行文件位置 |
testInstallDirectory | 测试套件包或可执行文件位置 |
workingDirectory | 此测试的工作目录属性。 |
DirectoryProperty
binaryResultsDirectory
内部二进制格式测试结果的根目录属性。
- 默认值
project.testResultsDir
/binary/task.name
TestTaskReports
reports
(只读)
此任务可能生成的报告。
RegularFileProperty
runScriptFile
返回测试套件包或可执行文件位置
DirectoryProperty
testInstallDirectory
测试套件包或可执行文件位置
DirectoryProperty
workingDirectory
此测试的工作目录属性。
void
addTestListener
(TestListener
listener)
向此任务注册一个测试监听器。还可以考虑以下便捷方法,以便更快地挂接到测试执行中: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
listener)
向此任务注册一个输出监听器。挂接输出事件的更快方法是使用AbstractTestTask.onOutput(groovy.lang.Closure)
方法。
void
afterSuite
(Closure
closure)
添加一个闭包,以便在测试套件执行后得到通知。一个TestDescriptor
和TestResult
实例作为参数传递给闭包。
此方法也在所有测试套件执行后调用。提供的描述符将具有一个空父套件。
void
afterTest
(Closure
closure)
添加一个闭包,以便在测试执行后得到通知。一个TestDescriptor
和TestResult
实例作为参数传递给闭包。
void
beforeSuite
(Closure
closure)
添加一个闭包,以便在测试套件执行前得到通知。一个TestDescriptor
实例作为参数传递给闭包。
此方法也在任何测试套件执行前调用。提供的描述符将具有一个空父套件。
void
beforeTest
(Closure
closure)
添加一个闭包,在测试执行前得到通知。TestDescriptor
实例作为参数传递给闭包。
void
onOutput
(Closure
closure)
添加一个闭包,以便在接收到测试输出时得到通知。一个TestDescriptor
和TestOutputEvent
实例作为参数传递给闭包。
apply plugin: 'java' test { onOutput { descriptor, event -> if (event.destination == TestOutputEvent.Destination.StdErr) { logger.error("Test: " + descriptor + ", error: " + event.message) } } }
void
removeTestListener
(TestListener
listener)
从此任务注销一个测试监听器。此方法只会移除通过调用此任务上的AbstractTestTask.addTestListener(org.gradle.api.tasks.testing.TestListener)
添加的监听器。如果监听器是使用Gradle.addListener(java.lang.Object)
向 Gradle 注册的,则此方法将不执行任何操作。而是使用Gradle.removeListener(java.lang.Object)
。
void
removeTestOutputListener
(TestOutputListener
listener)
从此任务注销一个测试输出监听器。此方法只会移除通过调用此任务上的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)
Action
<? super TestTaskReports
>配置此任务可能生成的报告。
AbstractTestTask
setTestNameIncludePatterns
(List
<String
>
testNamePattern)
List
<String
>设置要包含在执行中的测试名称模式。支持类或方法名称,支持通配符 '*'。有关更多信息,请参阅测试用户指南章节。有关支持模式的更多信息,请参阅TestFilter