章节目录:

概述

通过运行 Jtest 安装目录中的 jtestcli.exe 可启动 Jtest。在典型的工作流程中,该可执行文件通过支持的构建系统的专用插件运行,如 Maven、Ant 和 Gradle,但也可以通过命令行手动运行。

jtestcli.exe 基于构建系统插件自动生成的 jtest.data.json 数据文件运行。如果在命令行运行 jtestcli.exe,使用 -data 选项指定将用于分析的 .json 数据文件。

使用构建系统插件

通常,jtestcli.exe 通过 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

  • No labels