章节目录:
概述
通过运行 Jtest 安装目录中的 jtestcli.exe
可启动 Jtest。在典型的工作流程中,该可执行文件通过支持的构建系统的专用插件运行,如 Maven、Ant 和 Gradle,但也可以通过命令行手动运行。
jtestcli.exe
基于构建系统插件自动生成的 jtest.data.json
数据文件运行。如果在命令行运行 jtestcli.exe
,使用 -data
选项指定将用于分析的 .json
数据文件。
使用构建系统插件
通常,jtestcli.ex
e 通过 Maven、Ant 或 Gradle 专用的 Jtest 插件启动。有关详细信息(包括插件配置和故障排查),请参阅与构建系统集成。
添加 $XTEST_ITX=714 环境变量可以显示传递给由插件执行的 jtestcli.exe 的参数。
通过命令行使用 jtestcli
通过命令行运行 jtestcli.exe
来启动 Jtest。您必须至少包括一个测试配置,并指定用于分析代码的数据文件位置。更多信息,请参阅配置测试配置和指定测试数据位置。
您的命令行可能与以下内容类似:
jtestcli.exe -settings settings.properties -config "builtin://Recommended Rules" -data demo.data.json -report report
指定测试数据位置
使用 -data
选项直接指向一个构建系统插件生成的 *.json
数据文件对象。自动生成的 *.json
数据文件以 Jtest 特有的格式提供与工作空间相同的信息:
-data file
构建系统插件会自动添加数据参数并包含它们生成的值,因此无需将其添加到插件配置中。
设置属性模式
数据文件的路径可以使用 .properties 文件中的 jtest.data
选项配置:
jtest.data=[path to file]
数据文件格式
数据文件(jtest.data.json
)是由 Jtest 构建系统插件自动生成并格式化的 json 对象流。它提供了与工作空间相同的有关测试项目的信息。文件中的每个对象描述一个项目。Jtest 目前支持 classpath_project 通用对象类型。相关示例,请参阅配置测试范围。
数据文件对象示例
{ "type": "classpath_project", "name": "project_name", "location" "/absolute/path/to/project", "compilations": [ { "sourcepath": [ "/absolute/path/to/srcdir1" ], "resourcepath": [ "/absolute/path/to/resources" ], "compiler_output_path": [ "/absolute/path/to/compiler/output/directory" ], "classpath_entries":[ { "path": "absolute/path/to/java/ajavalib.jar" "type": "JDK", "scope": { "compile": true, "runtime": true } }, { "path": "/absolute/path/to/classdir1", "type": "DIRECTORY", "scope": { "compile": true, "runtime": true } }, { "path": "/absolute/path/to/buildfile.jar" "type": "LIBRARY", "scope": { "compile": true, "runtime": true } } ], "test_compilation": true "encoding": "project_encoding_name", "sourcelevel" "project_source_level" },{ ... } ] } { ... }
显示详细的进度信息
使用 -showdetails
选项显示详细的进度信息:
-showdetails
或者,也可以将 console.verbosity
选项设置为 high
:
console.verbosity.level=high
Ant 和 Maven 模式
如果使用 Ant 或 Maven,应采用以下模式:
<showdetails>true</showdetails>
指定 Jtest 数据位置
运行分析需要有 .jtest 目录的写权限,Jtest 在分析过程中会将运行相关的特定数据存储在该目录中。默认情况下,该目录存储在当前工作目录或构建系统的输出目录中,如 Maven 中的目标目录。您可以使用 -workspace
命令行选项指定 .jtest 目录自定义位置的路径,例如:
-workspace /home/qa/jtestdata_project1