Test (测试)

用于启动进程 JVM 的完整参数集。 这包括用于定义系统属性、最小/最大堆大小和引导类路径的参数。

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

用于进程的引导类路径。 当此 classpath 为空时，将使用 JVM 的默认引导类路径。

用于执行测试的类路径。

确定是否为测试进程启用调试。 启用时 — debug = true — 进程将在挂起状态下启动，监听端口 5005。 调试时应禁用并行测试执行，如果为 Test.getForkEvery() 使用非零值，则需要偶尔重新连接调试器。

自 Gradle 5.6 起，您可以通过 JavaForkOptions.debugOptions(org.gradle.api.Action) 配置端口和其他 Java 调试属性。

进程的 Java 调试线协议属性。 如果启用，则 -agentlib:jdwp=... 将附加到 JVM 参数，并使用来自参数的配置。

指示此任务是否将跳过单个测试执行。

对于 JUnit 4 和 5，这将报告本应作为跳过的测试。 对于 TestNG，这将报告本应作为通过的测试。

仅支持支持原生空运行的 TestNG 版本，即 TestNG 6.14 或更高版本。

如果为进程启用了断言，则返回 true。

用于进程的环境变量。 默认为此进程的环境。

测试执行的排除模式。

要使用的可执行文件的名称。

指示此任务是否在第一个失败的测试时失败

在 fork 的测试进程中执行的最大测试类数。 达到此限制时，将重新启动 fork 的测试进程。

默认情况下，Gradle 在执行测试时自动使用单独的 JVM。

由于停止和启动每个测试进程的成本，此属性可能对性能产生很大影响。 从默认值更改此属性是不寻常的。

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

测试执行的包含模式。

配置用于运行测试的 Java 可执行文件。

用于启动进程 JVM 的额外参数。 不包括系统属性和最小/最大堆大小。

用于 fork 的 java 进程的命令行参数提供器。

进程的最大堆大小（如果有）。

要并行启动的最大测试进程数。

默认情况下，Gradle 一次执行一个测试类。

此属性不能超过当前构建的最大 worker 数值。 Gradle 还会限制所有 Test 任务中启动的测试进程数。

进程的最小堆大小（如果有）。

此测试任务的模块路径处理。

返回测试框架特定的选项。 确保在使用此方法之前调用 Test.useJUnit()、Test.useJUnitPlatform() 或 Test.useTestNG()。

此任务可能生成的报告。

指定是否应检测测试类。 当 true 时，将扫描与包含和排除模式匹配的类以查找测试类，并执行找到的任何类。 当 false 时，将执行与包含和排除模式匹配的类。

将用于进程的系统属性。

编译后的测试源的目录。

允许设置与哪些测试事件记录到控制台以及记录的详细程度相关的选项。 例如，要显示有关异常的更多信息，请使用

apply plugin: 'java'

test.testLogging {
    exceptionFormat = "full"
}

有关更多信息，请参阅 TestLoggingContainer。

进程的工作目录。 默认为项目目录。

由 jacoco 插件添加的 JacocoTaskExtension。

向此任务注册一个测试监听器。 还可以考虑以下便捷方法，以便更快地挂钩到测试执行：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)。

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

添加一个闭包，以便在测试套件执行后收到通知。 TestDescriptor 和 TestResult 实例作为参数传递给闭包。

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

添加一个闭包，以便在测试执行后收到通知。 TestDescriptor 和 TestResult 实例作为参数传递给闭包。

添加一个闭包，以便在测试套件执行之前收到通知。 TestDescriptor 实例作为参数传递给闭包。

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

添加一个闭包，以便在测试执行之前收到通知。 TestDescriptor 实例作为参数传递给闭包。

将给定的值添加到进程的引导类路径的末尾。

将这些选项复制到给定的选项。

将这些选项复制到给定的目标选项。

配置进程的 Java 调试线协议属性。 如果启用了 JavaForkOptions.setDebug(boolean)，则 -agentlib:jdwp=... 将附加到 JVM 参数，并使用来自参数的配置。

向此进程的环境添加一个环境变量。

向此进程的环境添加一些环境变量。

添加一个排除规范。 可以多次调用此方法以附加新规范。 给定的闭包传递一个 FileTreeElement 作为其参数。 闭包应返回 true 或 false。 示例

copySpec {
  from 'source'
  into 'destination'
  //an example of excluding files from certain configuration:
  exclude { it.file in configurations.someConf.files }
}

If excludes are not provided, then no files will be excluded. If excludes are provided, then files must not match any exclude pattern to be processed.

为测试类目录中的文件添加排除模式（例如 '**/*Test.class'）。

为测试类目录中的文件添加排除模式（例如 '**/*Test.class'）。

添加一个排除规范。 可以多次调用此方法以附加新规范。 如果未提供排除项，则不会排除任何文件。 如果提供了排除项，则文件不得与任何要处理的排除模式匹配。

设置要使用的可执行文件的名称。

添加一个包含规范。 可以多次调用此方法以附加新规范。 给定的闭包传递一个 FileTreeElement 作为其参数。 如果未提供包含项，则将包含此容器中的所有文件。 如果提供了包含项，则文件必须与至少一个包含模式或规范匹配才能包含在内。

为测试类目录中的文件添加包含模式（例如 '**/*Test.class'）。

为测试类目录中的文件添加包含模式（例如 '**/*Test.class'）。

添加一个包含规范。 可以多次调用此方法以附加新规范。 如果未提供包含项，则将包含此容器中的所有文件。 如果提供了包含项，则文件必须与至少一个包含模式或规范匹配才能包含在内。

添加一些用于启动进程 JVM 的参数。

添加一些用于启动进程 JVM 的参数。

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

apply plugin: 'java'

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

配置测试框架特定的选项。

When a Test task is created outside of Test Suites, you should call Test.useJUnit(), Test.useJUnitPlatform() or Test.useTestNG() before using this method. If no test framework has been set, the task will assume JUnit4.

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

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

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

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

添加一些要用于进程的系统属性。

指定应使用 JUnit4 来发现和执行测试。

指定应使用 JUnit4 来发现和执行测试，并带有额外的配置。

The supplied action configures an instance of JUnitOptions.

指定应使用 JUnit4 来发现和执行测试，并带有额外的配置。

The supplied action configures an instance of JUnitOptions.

指定应使用 JUnit Platform 来发现和执行测试。

Use this option if your tests use JUnit Jupiter/JUnit5.

JUnit Platform supports multiple test engines, which allows other testing frameworks to be built on top of it. You may need to use this option even if you are not using JUnit directly.

指定应使用 JUnit Platform 来发现和执行测试，并带有额外的配置。

Use this option if your tests use JUnit Jupiter/JUnit5.

JUnit Platform supports multiple test engines, which allows other testing frameworks to be built on top of it. You may need to use this option even if you are not using JUnit directly.

The supplied action configures an instance of JUnitPlatformOptions.

指定应使用 TestNG 来发现和执行测试。

指定应使用 TestNG 来发现和执行测试，并带有额外的配置。

The supplied action configures an instance of TestNGOptions.

指定应使用 TestNG 来发现和执行测试，并带有额外的配置。

The supplied action configures an instance of TestNGOptions.

设置进程的工作目录。 提供的参数按照 Project.file(java.lang.Object) 进行评估。

配置测试框架特定的选项。

When a Test task is created outside of Test Suites, you should call Test.useJUnit(), Test.useJUnitPlatform() or Test.useTestNG() before using this method. If no test framework has been set, the task will assume JUnit4.

配置由 jacoco 插件添加的 JacocoTaskExtension。