执行 Jtest 的 Gradle 任务。

属性

参数的详细信息

config

测试配置的名称。支持以下配置类型：

• 内建测试配置，例如 "builtin://Recommended Rules"
• dtp 测试配置，例如 "dtp://New Config"
• 用户自定义测试配置，例如 "user://Your Config"

用户自定义测试配置应作为 *.properties 文件存储在 [INSTALL_DIR]/configs/user 目录中。

dataUpdate

允许手动更新从构建中收集的编译数据。

• 支持的操作：prepend、append 和 set。
• 支持的数据类型：classpath、bootpath、sourcepath、resourcepath、binarypath、sourcecode（仅限 set）和 encoding（仅限 set）
• 范围：将更新收集的所有项目数据

更多信息，请参阅手动自定义编译数据和编译数据模型。

exclude

指定所选资源中的文件或包的子集并从分析中排除。可以提供限定名称。您可以使用 glob 模式来匹配更多的文件名。

示例 1：以下模式会排除 com.parasoft 包及其子包中的所有文件：/com/parasoft/**

示例 2：以下模式会排除 com.parasoft.jtest 包中的所有文件，但不排除其子包中的所有文件：/com/parasoft/jtest/*

示例 3：以下模式会排除指定目录及所有子目录中的所有文件：path:/home/user/project/src/test/java/**

include

指定所选资源中的文件或包的子集并包含在分析中。您可以使用 glob 模式来匹配更多的文件名。

示例 1：以下模式会包括 com.parasoft 包及其子包中的所有文件：/com/parasoft/**

示例 2：以下模式会包括 com.parasoft.jtest 包中的所有文件，但不排除其子包中的所有文件：/com/parasoft/jtest/*

示例 3：以下模式会包括指定目录和所有子目录中的所有文件：path:/home/user/project/src/test/java/**

resource

指定分析的输入范围。如果没有指定资源，Jtest 将分析每个构建项目中的资源。

使用以下模式指定路径: ${ProjectName}/my/src/dir/my/package/file.java"。您可以使用以下通配符：

• ? - 匹配一个字符
• * - 匹配零个或多个字符，不包括路径分隔符（/ 字符）
• ** - 匹配整个路径，包括路径分隔符（/ 字符）

settings

包含自定义配置设置的 *properties 文件的绝对或相对路径。

projectNameTemplate

项目名称模板。默认情况下，以下模式用于在 json 中创建项目名称："group:name"。该参数允许使用 [group]、[name]、[version]、[path] 和 [basedir] 选项配置模式，例如，使项目名称与 Eclipse 中的项目名称兼容。

参数类型的详细信息

以下示例假定 Gradle 的 Jtest 插件已经在 Gradle 构建脚本中正确配置和应用；请参阅配置 Gradle 的 Jtest 插件。

编译类型

• 属性：Compilation
• 嵌套对象

jtest {
    home = "path/to/jtest"
    compilation {
        id = "main"
        override = true
    }
}

列表类型

• 属性：resources
• 指定与构建期间收集的资源匹配的资源模式列表。

jtest {
        home = "path/to/jtest"
        resources = [
                "**.java",
                "myGradleProjectName/src/com/mycompany/models/**/*.properties"
        ]
}

字符串类型

• 属性：Exclude
• 指定所选资源中的文件或包的子集并从分析中排除。

jtest {
    home = "path/to/jtest"
    exclude = "com/mycompany/models/**/NotInteresting*.properties"
}

更多信息，请参阅编译数据模型。

使用 Jtest 收集覆盖率的 Gradle 任务。

参数

参数的详细信息

coverage

默认值为：

jtest { 
  /* other parameters  */ 
  coverage { 
    skip = false 
    includes = [ 'package/**' ] 
    excludes = [ ] 
    testIncludes = [ 'package/Test.class' ] 
    testExcludes = [ ] 
  } 
}

runtimeDataLocation

默认值为： ${basedir}/parasoft/jtest-instrument/runtimedata.data

metadataLocation

默认值为：${basedir}/parasoft/jtest-instrument/metadata.data

此任务扫描构建以生成 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 目录拷贝。

参数

参数的详细信息

exclude

指定所选资源中的文件或包的子集并从分析中排除。可以提供限定名称。您可以使用 glob 模式来匹配更多的文件名。

示例 1：以下模式会排除 com.parasoft 包及其子包中的所有文件：/com/parasoft/**

示例 2：以下模式会排除 com.parasoft.jtest 包中的所有文件，但不排除其子包中的所有文件：/com/parasoft/jtest/*

示例 3：以下模式会排除指定目录及所有子目录中的所有文件：path:/home/user/project/src/test/java/**

include

指定所选资源中的文件或包的子集并包含在分析中。您可以使用 glob 模式来匹配更多的文件名。

示例 1：以下模式会包括 com.parasoft 包及其子包中的所有文件：/com/parasoft/**

示例 2：以下模式会包括 com.parasoft.jtest 包中的所有文件，但不排除其子包中的所有文件：/com/parasoft/jtest/*

示例 3：以下模式会包括指定目录和所有子目录中的所有文件：path:/home/user/project/src/test/java/**

resource

指定分析的输入范围。如果没有指定资源，Jtest 将分析每个构建项目中的资源。

使用以下模式指定路径: ${ProjectName}/my/src/dir/my/package/file.java"。您可以使用以下通配符：

• ? - 匹配一个字符
• * - 匹配零个或多个字符，不包括路径分隔符（/ 字符）
• ** - 匹配整个路径，包括路径分隔符（/ 字符）

settings

包含自定义配置设置的 *properties 文件的绝对或相对路径。

projectNameTemplate

项目名称模板。默认情况下，以下模式用于在 json 中创建项目名称："group:name"。该参数允许使用 [group]、[name]、[version]、[path] 和 [basedir] 选项配置模式，例如，使项目名称与 Eclipse 中的项目名称兼容。

参数类型的详细信息

以下示例假定 Gradle 的 Jtest 插件已经在 Gradle 构建脚本中正确配置和应用；请参阅配置 Gradle 的 Jtest 插件。

编译类型

• 属性：Compilation
• 嵌套对象

jtest {
    home = "path/to/jtest"
    compilation {
        id = "main"
        override = true
    }
}

列表类型

• 属性：resources
• 指定与构建期间收集的资源匹配的资源模式列表。

jtest {
        home = "path/to/jtest"
        resources = [
                "**.java",
                "myGradleProjectName/src/com/mycompany/models/**/*.properties"
        ]
}

字符串类型

• 属性：Exclude
• 指定所选资源中的文件或包的子集并从分析中排除。

jtest {
    home = "path/to/jtest"
    exclude = "com/mycompany/models/**/NotInteresting*.properties"
}

更多信息，请参阅编译数据模型。

该目标由 Jtest 自带的测试影响分析插件提供，用于对项目执行基于变更的测试（请参阅测试影响分析）。

必需的参数

可选参数