本节提供有关 Maven 的 Jtest 目标及其参数的信息。提供以下目标：
jtest:jtest
完整名称：com.parasoft.jtest:jtest-maven-plugin:2020.1.0:jtest
这个目标应用作 Maven 报告，用于收集构建数据并使用配置的参数执行 Jtest（请参阅配置 Maven 的 Jtest 插件）。它在构建会话结束时调用，并收集每个项目的汇总数据。该目标作为聚合器运行，这意味着它并不受限于构建生命周期的任何阶段。
属性
- 需要执行 Maven 项目。
- 作为聚合器插件执行。
- 需要解析的依赖项作用域：compile。
- 始于版本：1.0.0
参数
| 名称 | 接受的值 / 数据类型 | 始于 | 说明 |
|---|---|---|---|
| compilation | PlexusConfiguration | 1.0.4 | 手动配置数据的说明（请参阅手动自定义编译数据） |
| compilations | PlexusConfiguration | 1.0.4 | 手动配置数据的说明列表（请参阅手动自定义编译数据） |
| config | 字符串 | 1.0.0 | 内建、DTP 或用户自定义测试配置的名称。 用户属性为： |
| dataUpdate | 字符串 | 1.2.9 | 允许手动更新从构建中收集的编译数据。 用户属性为： |
| exclude | 字符串 | 1.0.0 | 指定所选资源中的文件或包的子集并从分析中排除。您可以提供限定名称或使用 Ant glob 匹配更多文件名。 用户属性为： |
| excludes | 1.1.0 | exclude 参数列表。 用户属性为： | |
| fail | true | false | 1.0.0 | 报告任何违规时，构建失败。 默认值为： 用户属性为： |
| forceTestReportsImport | true | false | 1.0.0 | 如果 Jtest 插件无法识别 Maven 环境中现有的测试插件（例如 Surefire），应确保测试结果从默认位置导入。 默认值为： 用户属性为： |
| home | 路径 | 1.1.0 | 指定 Jtest 安装目录。 用户属性为： |
| ignoredIds | 1.0.4 | 忽略的 compilation ID 列表。 用户属性为： | |
| include | 字符串 | 1.0.0 | 指定所选资源中的文件或包的子集并包含在分析中。 用户属性为： |
| includes | 1.1.0 | include 参数列表。 用户属性为： | |
| projectNameTemplate | 字符串 | 1.0.0 | 项目名称模板。此参数允许使用选项 [groupId]、[artifactId]、[version] 和 [basedir] 配置模式。 用户属性为： |
| publish | true | false | 1.0.0 | 启用将本地分析的结果发送到 DTP 服务器。 用户属性为： |
| report | 路径 | 1.0.0 | 指定创建报告的目录。 用户属性为： |
| resource | 字符串 | 1.0.0 | 指定分析的输入范围。如果没有指定资源，Jtest 将分析每个构建项目中的资源。 用户属性为： |
| resources | 1.1.0 | resource 参数列表。 用户属性为： | |
| settings | 路径 | 1.0.0 | 包含自定义配置设置的 *properties 文件的绝对或相对路径。 用户属性为：jtest.settings |
| settingsList | 1.0.0 | settings 参数列表。 用户属性为： | |
| showDetails | true | false | 1.0.0 | 显示详细的进度信息。 用户属性为：jtest.showdetails |
| showSettings | true | false | 1.0.0 | 打印当前设置和自定义配置。 用户属性为：jtest.showsettings |
| skip | true | false | 1.1.0 | 允许跳过 Jtest 执行阶段。如果设置为 默认值为：false 用户属性为：jtest.skip |
参数的详细信息
compilation
手动配置数据的说明（请参阅手动自定义编译数据）。
- 类型：org.codehaus.plexus.configuration.PlexusConfiguration
- 始于：1.0.4
- 是否必需：否
compilations
手动配置数据的说明列表（请参阅手动自定义编译数据）
- 类型：org.codehaus.plexus.configuration.PlexusConfiguration
- 始于：1.0.4
- 是否必需：否
config
测试配置的名称。支持以下配置类型：
- 内建测试配置，例如
"builtin://Recommended Rules" - dtp 测试配置，例如
"dtp://New Config" - 用户自定义测试配置，例如
"user://Your Config"
用户自定义测试配置应作为 *.properties 文件存储在 [INSTALL_DIR]/configs/user 目录中。
- 类型：java.lang.String
- 始于：1.0.0
- 是否必需：否
- 用户属性：
jtest.config
dataUpdate
允许手动更新从构建中收集的编译数据。
- 支持的操作：prepend、append 和 set。
- 支持的数据类型：classpath、bootpath、sourcepath、resourcepath、binarypath、sourcecode（仅限 set）和 encoding（仅限 set）
- 范围：将更新收集的所有项目数据
- 类型：java.lang.String
- 始于：1.2.9
- 是否必需：否
- 用户属性：
jtest.dataUpdate
详细信息，请参阅手动自定义编译数据和编译数据模型。
exclude
指定所选资源中的文件或包的子集并从分析中排除。可以提供限定名称。您可以使用 glob 模式来匹配更多的文件名。
示例 1：以下模式会排除 com.parasoft 包及其子包中的所有文件：/com/parasoft/**
示例 2：以下模式会排除 com.parasoft.jtest 包中的所有文件，但不排除其子包中的所有文件：/com/parasoft/jtest/*
示例 3：以下模式会排除指定目录及所有子目录中的所有文件：path:/home/user/project/src/test/java/**
- 类型：java.lang.String
- 始于：1.0.0
- 是否必需：否
- 用户属性：
jtest.exclude
excludes
exclude 参数列表。自 Maven 3.0.3 起可通过属性进行配置。
- 类型：java.lang.String[]
- 始于：1.1.0
- 是否必需：否
- 用户属性：
jtest.excludes
fail
报告任何违规时，构建失败。
- 类型：java.lang.String
- 始于：1.0.0
- 是否必需：否
- 默认：false
- 用户属性：
jtest.fail
forceTestReportsImport
如果 Jtest 插件无法识别 Maven 环境中现有的测试插件（例如 Surefire），应确保测试结果从默认位置导入。
- 类型：java.lang.Boolean
- 始于：1.0.0
- 是否必需：否
- 默认：false
- 用户属性：
jtest.forceTestReportsImport
home
Jtest 安装目录。
- 类型：java.io.File
- 始于：1.1.0
- 是否必需：否
- 用户属性：
jtest.home
ignoredIds
忽略的 compilation ID 列表。从 Maven 3.0.3 开始支持。
- 类型：java.lang.String[]
- 始于：1.0.4
- 是否必需：否
- 用户属性：
jtest.ignoredids
include
指定所选资源中的文件或包的子集并包含在分析中。您可以使用 glob 模式来匹配更多的文件名。
示例 1：以下模式会包括 com.parasoft 包及其子包中的所有文件：/com/parasoft/**
示例 2：以下模式会包括 com.parasoft.jtest 包中的所有文件，但不排除其子包中的所有文件：/com/parasoft/jtest/*
示例 3：以下模式会包括指定目录和所有子目录中的所有文件：path:/home/user/project/src/test/java/**
- 类型：java.lang.String
- 始于：1.0.0
- 是否必需：否
- 用户属性：
jtest.include
includes
include 参数列表。自 Maven 3.0.3 起可通过属性进行配置。
- 类型：java.lang.String[]
- 始于：1.1.0
- 是否必需：否
- 用户属性：
jtest.includes
projectNameTemplate
项目名称模板。默认情况下，以下模式用于在 json 中创建项目名称：:"groupId:artifactId "。该参数允许使用 [groupId]、[artifactId]、[version] 和 [basedir] 选项配置模式，例如，使项目名称与 Eclipse 中的项目名称兼容。
- 类型：java.lang.String
- 始于：1.0.0
- 是否必需：否
- 用户属性：
jtest.projectNameTemplate
publish
启用将本地分析的结果发送到 DTP 服务器。
- 类型：java.lang.String
- 始于：1.0.0
- 是否必需：否
- 用户属性：
jtest.publish
report
指定创建报告的目录。默认情况下为 ${project.build.directory}/jtest。
- 类型：java.io.File
- 始于：1.0.0
- 是否必需：否
- 用户属性：
jtest.report
resource
指定分析的输入范围。如果没有指定资源，Jtest 将分析每个构建项目中的资源。
使用以下模式指定路径: ${ProjectName}/my/src/dir/my/package/file.java"。您可以使用以下通配符：
- ? - 匹配一个字符
- * - 匹配零个或多个字符，不包括路径分隔符（/ 字符）
- ** - 匹配整个路径，包括路径分隔符（/ 字符）
Maven 的 Jtest 插件将 ${ProjectName} 解析为 ${artifactId}:${groupId}。
- 类型：java.lang.String
- 始于：1.0.0
- 是否必需：否
- 用户属性：
jtest.resource
resources
resource 参数列表。自 Maven 3.0.3 起可通过属性进行配置。
- 类型：java.lang.String[]
- 始于：1.1.0
- 是否必需：否
- 用户属性：
jtest.resources
settings
包含自定义配置设置的 *properties 文件的绝对或相对路径。
- 类型：java.io.File
- 始于：1.0.0
- 是否必需：否
- 用户属性：
jtest.settings
settingsList
settings 参数列表。从 Maven 3.0.3 开始支持。自 Maven 3.0.3 起可通过属性进行配置。
- 类型：java.io.File[]
- 始于：1.0.0
- 是否必需：否
- 用户属性：
jtest.settingsList
showDetails
显示详细的进度信息。
- 类型：java.lang.String
- 始于：1.0.0
- 是否必需：否
- 用户属性：jtest.showdetails
showSettings
打印当前设置和自定义设置，以及每个设置和自定义设置的位置信息（例如，在 jtest.properties 文件中）。
- 类型：java.lang.String
- 始于：1.0.0
- 是否必需：否
- 用户属性：
jtest.showsettings
skip
允许跳过 Jtest 执行阶段。如果设置为 true，则只生成 jtest.data.json 数据文件。
- 类型：java.lang.String
- 始于：1.1.0
- 是否必需：否
- 默认：false
- 用户属性：
jtest.skip
jtest:agent
完整名称：com.parasoft.jtest:jtest-maven-plugin:2020.1.0:agent
该目标基于构建模块生成 Jtest 代理设置，并将 javaagent 虚拟机参数设置到由 agentPropertyNames 参数指定的属性中。
默认情况下，它会尝试通过特定的属性将 javaagent VmArg 注入 maven-surefire-plugin 和 eclipse-test-plugin。
属性
- 需要执行 Maven 项目。
- 需要解析的依赖项作用域：compile。
- 始于版本：1.2.4
- 默认绑定的生命周期阶段：process-test-classes
必需的参数
| 名称 | 接受的值 / 数据类型 | 始于 | 说明 |
|---|---|---|---|
| autostartAgent | true | false | 1.0.7 | 用于自动启用覆盖率收集的选项。 默认值为： 用户属性为： |
| home | 路径 | 1.1.0 | Jtest 安装目录。运行 用户属性为： |
可选参数
| 名称 | 接受的值 / 数据类型 | 始于 | 说明 |
|---|---|---|---|
| agentPropertyNames | 字符串 | 1.2.4 | 传递 Jtest 代理 JVM 参数的逗号分隔的属性列表。 默认值为：argLine,tycho.testArgLine 用户属性为：jtest.agentPropertyNames |
| agentServerEnabled | true | false | 1.2.4 | 用于启用代理服务器。 默认值为：false 用户属性为：jtest.agentServerEnabled |
| agentSettings | 路径 | 1.2.2 | 代理设置生成位置的路径。 默认值为： ${project.build.directory}/jtest/agent.properties 用户属性为：jtest.agentSettings |
| coverage | 1.2.4 | 用于配置覆盖率收集的参数集。
| |
| enableJacoco | true | false | 2021.1.0 | 用于启用或禁用通过 Jacoco 引擎收集行覆盖率的功能。 默认值为：false 用户属性为：jtest.enableJacoco |
| ignoredIds | 1.0.4 | 忽略的 compilation ID 列表。 用户属性为：jtest.ignoredids | |
| projectNameTemplate | 字符串 | 1.2.4 | 项目名称模板。 用户属性为：jtest.projectNameTemplate。 |
参数的详细信息
agentPropertyNames
传递 Jtest 代理 JVM 参数的逗号分隔的属性列表。
- 类型：java.lang.String
- 始于：1.2.4
- 是否必需：否
- 用户属性：jtest.agentPropertyNames
- 默认：argLine,tycho.testArgLine
agentServerEnabled
用于启用代理服务器的选项。
- 类型：boolean
- 始于：1.2.4
- 是否必需：否
- 用户属性：jtest.agentServerEnabled
- 默认：false
agentSettings
代理设置生成位置的路径。您可以提供绝对路径，也可以提供 ${project.build.directory}/jtest 目录的相对路径。默认位置为 ${project.build.directory}/jtest/agent.properties。如果提供一个已有文件的路径，该文件将被覆盖。
- 类型：java.lang.String
- 始于：1.2.2
- 是否必需：否
- 用户属性：jtest.agentSettings
- 默认：agent.properties
autostartAgent
用于自动启用覆盖率收集的选项。
- 类型：boolean
- 始于：1.0.7
- 是否必需：是
- 用户属性：jtest.autostartAgent
- 默认：true
coverage
用于配置覆盖率收集的参数集。
- jtest.coverage.skip - 禁用覆盖率收集。
以下参数指定要插桩的类（仅针对插桩的类收集覆盖率）：
- jtest.coverage.includes - 用于包含类的 <Glob> 模式。将收集覆盖率信息。
- jtest.coverage.excludes - 用于排除类的 <Glob> 模式。不收集覆盖率信息。
以下参数指定要插桩的测试类（将为每个插桩的测试用例分配覆盖率信息）：
- jtest.coverage.testIncludes - 用于包含测试类的 <Glob> 模式。测试用例会被分配覆盖率。
- jtest.coverage.testExcludes - 用于排除测试类的 <Glob> 模式。测试用例不会被分配覆盖率。
- 类型：com.parasoft.jtest.plugin.CoverageConfig
- 始于：1.2.4
- 是否必需：否
enableJacoco
- 类型：boolean
- 始于：2021.1.0
- 是否必需：否
- 默认：false
- 用户属性：jtest.enableJacoco
home
Jtest 安装目录。运行 jtestcli 和访问 Jtest 代理库时需配置此参数。
- 类型：java.io.File
- 始于：1.1.0
- 是否必需：是
- 用户属性：jtest.home
ignoredIds
忽略的 compilation ID 列表。
- 类型：java.lang.String[]
- 始于：1.0.4
- 是否必需：否
- 用户属性：jtest.ignoredids
projectNameTemplate
项目名称模板。您可以创建自己的模板，用于在 json 中创建项目名称。可选择以下选项：[groupId]、[artifactId]、[version]、[basedir]。
- 类型：java.lang.String
- 始于：1.2.4
- 是否必需：否
- 用户属性：jtest.projectNameTemplate
jtest:monitor
完整名称：com.parasoft.jtest:jtest-maven-plugin:2020.1.0:monitor
这个目标应用作 Maven 报告，扫描构建以生成 Jtest Java 代理的设置，并在使用 monitorLocation 参数指定的位置中创建一个 monitor 包。
monitor 包中包含以下文件：
- static_coverage.xml - 包含静态覆盖率信息的文件
- agent.jar - Jtest Java 覆盖率代理 jar 包
- agent.properties - 包含构建过程中生成的范围参数和其他属性的代理设置文件
- agent.sh/agent.bat - 生成应用程序监控所需的 Jtest Java 代理 VM 参数的脚本
- opentelemetry-javaagent.jar 和 jtest-otel-ext.jar - 在多用户覆盖率模式中使用的文件：原始 OpenTelemetry Java 代理及其 Jtest 扩展。此扩展用于收集将收集到的覆盖率数据分配给特定用户所需的信息。这些文件从
<INSTALL_DIR>/integration/coverage目录拷贝。
属性
- 需要执行 Maven 项目。
- 作为聚合器插件执行。
- 需要解析的依赖项作用域：compile。
- 始于版本：1.2.4
可选参数
| 名称 | 接受的值 / 数据类型 | 始于 | 说明 |
|---|---|---|---|
| agentServerEnabled | true | false | 1.2.4 | 用于启用代理服务器的选项。 默认值为：true 用户属性为：jtest.agentServerEnabled |
| autostartAgent | true | false | 1.0.7 | 用于自动启用覆盖率收集的选项。 默认值为：true 用户属性为：jtest.autostartAgent |
| compilation | PlexusConfiguration | 1.0.4 | 手动配置数据的说明（请参阅手动自定义编译数据） |
| compilations | PlexusConfiguration | 1.0.4 | 手动配置数据的说明列表（请参阅手动自定义编译数据） |
| coverage | 1.2.4 | 覆盖率配置块。您可以嵌套以下参数：
Glob 模式会与 classpath 中 | |
| dataUpdate | 字符串 | 1.2.9 | 允许手动更新从构建中收集的编译数据。 用户属性为： |
| enableJacoco | true | false | 用于启用或禁用通过 Jacoco 引擎收集行覆盖率的功能。 默认值为：false 用户属性为：jtest.enableJacoco | |
| exclude | 字符串 | 1.0.0 | 指定所选资源中的文件或包的子集并从分析中排除。您可以提供限定名称或使用 Ant glob 匹配更多文件名。 用户属性为： |
| 1.1.0 | exclude 参数列表。 用户属性为： | ||
| home | 路径 | 1.1.0 | 指定 Jtest 安装目录。 用户属性为： |
| ignoredIds | 1.0.4 | 忽略的 compilation ID 列表。 用户属性为： | |
| include | 字符串 | 1.0.0 | 指定所选资源中的文件或包的子集并包含在分析中。 用户属性为： |
| includes | 1.1.0 | include 参数列表。 用户属性为： | |
| monitorLocation | 路径 | 1.2.4 | monitor 包创建位置的路径。 默认值为：${project.build.directory}/jtest/monitor/monitor.zip 用户属性为：jtest.monitorLocation |
| projectNameTemplate | 字符串 | 1.2.4 | 项目名称模板。 用户属性为： |
| publish | true | false | 1.0.0 | 启用将本地分析的结果发送到 DTP 服务器。 用户属性为： |
| resource | 字符串 | 1.0.0 | 指定分析的输入范围。如果没有指定资源，Jtest 将分析每个构建项目中的资源。 用户属性为： |
| resources | 1.1.0 | resource 参数列表。 用户属性为： | |
| settings | 路径 | 1.0.0 | 包含自定义配置设置的 *properties 文件的绝对或相对路径。 用户属性为： |
| settingsList | 1.0.0 | settings 参数列表。 用户属性为： | |
| showDetails | true | false | 1.0.0 | 显示详细的进度信息。 用户属性为： |
| showSettings | true | false | 1.0.0 | 打印当前设置和自定义配置。 用户属性为：j |
| skip | true | false | 1.1.0 | 允许跳过 Jtest 执行阶段。如果设置为 默认值为：false 用户属性为：jtest.skip |
参数的详细信息
agentServerEnabled
用于启用代理服务器的选项。
- 类型：boolean
- 始于：1.2.4
- 是否必需：否
- 用户属性：jtest.agentServerEnabled
- 默认：true
autostartAgent
用于自动启用覆盖率收集的选项。
- 类型：boolean
- 始于：1.0.7
- 是否必需：是
- 用户属性：jtest.autostartAgent
- 默认：true
compilation
手动配置数据的说明（请参阅手动自定义编译数据）。
- 类型：org.codehaus.plexus.configuration.PlexusConfiguration
- 始于：1.0.4
- 是否必需：否
compilations
手动配置数据的说明列表（请参阅手动自定义编译数据）
- 类型：org.codehaus.plexus.configuration.PlexusConfiguration
- 始于：1.0.4
- 是否必需：否
coverage
- jtest.coverage.skip - 禁用覆盖率收集。
以下参数指定要插桩的类（仅针对插桩的类收集覆盖率）：
- jtest.coverage.includes - 用于包含类的 <Glob> 模式。将收集覆盖率信息。
- jtest.coverage.excludes - 用于排除类的 <Glob> 模式。不收集覆盖率信息。
Glob 模式会与 classpath 中 *.class 文件的相对路径匹配（路径分隔符：/）
- 类型：com.parasoft.jtest.plugin.CoverageConfig
- 始于：1.2.4
- 是否必需：否
dataUpdate
允许手动更新从构建中收集的编译数据。
- 支持的操作：prepend、append 和 set。
- 支持的数据类型：classpath、bootpath、sourcepath、resourcepath、binarypath、sourcecode（仅限 set）和 encoding（仅限 set）
- 范围：将更新收集的所有项目数据
- 类型：java.lang.String
- 始于：1.2.9
- 是否必需：否
- 用户属性：
jtest.dataUpdate
enableJacoco
- 类型：boolean
- 始于：2021.1.0
- 是否必需：否
- 默认：false
- 用户属性：jtest.enableJacoco
exclude
指定所选资源中的文件或包的子集并从分析中排除。可以提供限定名称。您可以使用 glob 模式来匹配更多的文件名。
示例 1：以下模式会排除 com.parasoft 包及其子包中的所有文件：/com/parasoft/**
示例 2：以下模式会排除 com.parasoft.jtest 包中的所有文件，但不排除其子包中的所有文件：/com/parasoft/jtest/*
示例 3：以下模式会排除指定目录及所有子目录中的所有文件：path:/home/user/project/src/test/java/**
- 类型：java.lang.String
- 始于：1.0.0
- 是否必需：否
- 用户属性：
jtest.exclude
excludes
exclude 参数列表。自 Maven 3.0.3 起可通过属性进行配置。
- 类型：java.lang.String[]
- 始于：1.1.0
- 是否必需：否
- 用户属性：
jtest.excludes
home
Jtest 安装目录。
- 类型：java.io.File
- 始于：1.1.0
- 是否必需：否
- 用户属性：
jtest.home
ignoredIds
忽略的 compilation ID 列表。从 Maven 3.0.3 开始支持。
- 类型：java.lang.String[]
- 始于：1.0.4
- 是否必需：否
- 用户属性：
jtest.ignoredids
include
指定所选资源中的文件或包的子集并包含在分析中。您可以使用 glob 模式来匹配更多的文件名。
示例 1：以下模式会包括 com.parasoft 包及其子包中的所有文件：/com/parasoft/**
示例 2：以下模式会包括 com.parasoft.jtest 包中的所有文件，但不排除其子包中的所有文件：/com/parasoft/jtest/*
示例 3：以下模式会包括指定目录和所有子目录中的所有文件：path:/home/user/project/src/test/java/**
- 类型：java.lang.String
- 始于：1.0.0
- 是否必需：否
- 用户属性：
jtest.include
includes
include 参数列表。自 Maven 3.0.3 起可通过属性进行配置。
- 类型：java.lang.String[]
- 始于：1.1.0
- 是否必需：否
- 用户属性：
jtest.includes
monitorLocation
monitor 包创建位置的路径。
- 类型：java.io.File
- 始于：1.2.4
- 是否必需：否
- 用户属性：
jtest.monitorLocation - 默认：
${project.build.directory}/jtest/monitor/monitor.zip
projectNameTemplate
项目名称模板。默认情况下，以下模式用于在 json 中创建项目名称：:"groupId:artifactId "。该参数允许使用 [groupId]、[artifactId]、[version] 和 [basedir] 选项配置模式，例如，使项目名称与 Eclipse 中的项目名称兼容。
- 类型：java.lang.String
- 始于：1.2.4
- 是否必需：否
- 用户属性：jtest.projectNameTemplate
publish
启用将本地分析的结果发送到 DTP 服务器。
- 类型：java.lang.String
- 始于：1.0.0
- 是否必需：否
- 用户属性：
jtest.publish
resource
指定分析的输入范围。如果没有指定资源，Jtest 将分析每个构建项目中的资源。
使用以下模式指定路径: ${ProjectName}/my/src/dir/my/package/file.java"。您可以使用以下通配符：
- ? - 匹配一个字符
- * - 匹配零个或多个字符，不包括路径分隔符（/ 字符）
- ** - 匹配整个路径，包括路径分隔符（/ 字符）
Maven 的 Jtest 插件将 ${ProjectName} 解析为 ${artifactId}:${groupId}。
- 类型：java.lang.String
- 始于：1.0.0
- 是否必需：否
- 用户属性：
jtest.resource
resources
resource 参数列表。自 Maven 3.0.3 起可通过属性进行配置。
- 类型：java.lang.String[]
- 始于：1.1.0
- 是否必需：否
- 用户属性：
jtest.resources
settings
包含自定义配置设置的 *properties 文件的绝对或相对路径。
- 类型：java.io.File
- 始于：1.0.0
- 是否必需：否
- 用户属性：
jtest.settings
settingsList
settings 参数列表。从 Maven 3.0.3 开始支持。自 Maven 3.0.3 起可通过属性进行配置。
- 类型：java.io.File[]
- 始于：1.0.0
- 是否必需：否
- 用户属性：
jtest.settingsList
showDetails
显示详细的进度信息。
- 类型：java.lang.String
- 始于：1.0.0
- 是否必需：否
- 用户属性：jtest.showdetails
showSettings
打印当前设置和自定义设置，以及每个设置和自定义设置的位置信息（例如，在 jtest.properties 文件中）。
- 类型：java.lang.String
- 始于：1.0.0
- 是否必需：否
- 用户属性：
jtest.showsettings
skip
允许跳过 Jtest 执行阶段。如果设置为 true，则只生成 jtest.data.json 数据文件。
- 类型：java.lang.String
- 始于：1.1.0
- 是否必需：否
- 默认：false
- 用户属性：
jtest.skip
tia:affected-tests
该目标由 Jtest 自带的测试影响分析插件提供，用于对项目执行测试影响分析（请参阅测试影响分析）。
必需的参数
| 名称 | 用户属性 | 接受的值 / 数据类型 | 说明 |
|---|---|---|---|
| referenceCoverageFile | jtest.referenceCoverageFile | 路径 | URL | Jtest 在分析过程中生成的 coverage.xml 文件的路径。该文件包含运行期间收集的覆盖率数据。 如果指定了 URL，该文件将被下载到 Jtest 执行目录，并在使用 默认为： |
referenceReportFile | jtest.referenceReportFile | 路径 | URL | Jtest 在分析过程中生成的 report.xml 文件的路径。该文件包含有关在运行期间执行的单元测试的信息。 如果指定了 URL，该文件将被下载到 Jtest 执行目录，并在使用 默认为： |
| jtestHome | jtest.home | 路径 | Jtest 安装目录的路径。Jtest 安装目录已经使用 Maven 设置或 JTEST_HOME 环境变量进行配置的情况下则不需要指定。 |
可选参数
| 名称 | 用户属性 | 接受的值 / 数据类型 | 说明 |
|---|---|---|---|
referenceStore | jtest.referenceStore | 路径 | 缓存目录的路径，用于存储通过 这些缓存文件将用作测试影响分析的基准，直到从指定目录中删除为止。删除后会通过 URL 重新下载。 |
| runFailedTests | jtest.runFailedTests | true | false | 用于在当前测试运行中包括上一次运行中的所有失败测试，即使它们没有受到变更的影响。 默认为： |
| runModifiedTests | jtest.runModifiedTests | true | false | 用于在测试运行中包括新增的测试和修改的测试（即使它们没有受到生产代码变更的影响）。 默认为： |
| settings | jtest.settings | 路径 | 包含自定义配置设置的 *properties 文件的路径。 |
| settingsList | jtest.settingsList |
Jtest 安装目录下 jtest.properties 文件中配置的设置会自动包括在内。 | |
| testFilter | jtest.testFilter | 模式 | 指定要包括或排除的其他测试。您可以使用 glob 模式来匹配更多的文件名。 在下面的命令行示例中，Jtest 将重新运行所有匹配
请参阅手动过滤要重新运行的测试。 |
