本页提供 jtestcli 的命令行选项列表。

配置测试配置

-config <config_url>

此选项指定将用于分析的测试配置。选项后面必须是内建、用户自定义或 DTP 托管的测试配置的名称。

示例：

  • jtestcli -config "builtin://Critical Rules"
  • jtestcli -config "user://My_Config"
  • jtestcli -config "dtp://New_Rules"

-listconfigs

此选项打印可使用的测试配置的列表，并且可用于获取能够通过 -config 选项传递的有效测试配置名称。

您可以通过指定模式来过滤可用的配置。

示例：

  • -listconfigs builtin（打印所有内建测试配置）
  • -listconfigs builtin*Top*（打印所有名称包含“Top”的内建配置）

 详细信息，请参阅配置测试配置。

配置输入范围

 -data <path>

此选项指定自定义 json 数据文件的位置。请参阅创建自定义 .json 数据文件。


-resource <path relative to the project>

此选项缩小了 JSON 数据文件中定义的主要测试范围。您可以使用 Ant 风格的通配符进行指定。

示例：

  • -resource ProjectName/src（分析所选目录及其子目录中的每个文件）

  • -resource ProjectName/**/*.java（分析所选项目中的每个 Java 文件）

  • -resource **/src/main/java/my/company/*.java（分析当前构建中每个项目指定子目录中的每个 Java 文件）

  • -resource c:/resource.lst（分析 resource.lst 文件；每行指定一个项目名称）

您可以在同一命令行中多次使用此选项来指定多个资源。

-include <absolute path> and -exclude <absolute path>

这些选项缩小了 JSON 数据文件中定义的主要测试范围。  可以用于指定测试过程中需要包含或排除的文件和包。您可以使用 Ant 风格的通配符指定资源。

您可以提供以下范围之一：

  • 资源的完全限定名
  • 磁盘中带“path:”前缀的绝对路径

示例：

  • include com/**（测试限定名以“com”开头的包中所有文件）
  • include **/*Account（测试限定名以“Account”结尾的文件）
  • include path:**/Bank.java（仅测试 Bank.java 文件）
  • include path:C:/Project/src/**（测试 C:/Project/src/ 中的所有子目录和文件）
  • include path:C:/Project/src/examples/runtime/*（测试 C:/Project/src/examples/runtime 中的所有文件，但不包含子目录）
  • include c:/include.lst（测试 include.lst 文件中列出的所有文件；每一行都被视为一个单独的模式）
  • exclude **/internal/**（测试主要测试范围中的所有内容，包名中包含“internal”的文件除外）
  • exclude path:**/tests/**（测试主要测试范围中的所有内容，“tests”文件夹中的文件除外）
或者，您也可以在 .lst 文件中指定一个模式列表，并使用 -include 或者 -exclude 选项传递该文件。文件中的每一行都被视为一个单独的条目。

-data.update <pattern>

此选项指定要在 JSON 数据文件中添加或覆盖的项目编译数据。您可以通过以下指令之一配置 classpath、bootpath、sourcepath、resourcepath、binarypath、encoding 和 sourcelevel 来手动修改 JSON 文件：

  • prepend <文件路径>- 在列表的开头添加一个或多个条目。可以使用逗号分隔的列表来指定多个文件路径。
  • append <文件路径>- 在列表末尾添加一个或多个条目。可以使用逗号分隔的列表来指定多个文件路径。
  • set <值>- 覆盖当前值。

可接受的模式：

  • compilations.classpath.append=<路径>
  • compilations.classpath.prepend=<路径>
  • compilations.bootpath.append=<路径>
  • compilations.bootpath.prepend=<路径>
  • compilations.sourcepath.append=<路径>
  • compilations.sourcepath.prepend=<路径>
  • compilations.resourcepath.append=<路径>
  • compilations.resourcepath.prepend=<路径>
  • compilations.binarypath.append=<路径>
  • compilations.binarypath.prepend=<路径>
  • compilations.encoding.set=<字符编码>
  • compilations.sourcelevel.set=<项目源级>

示例：

  • -data.update compilations.classpath.append="/tmp/last1.jar","/tmp/last2.jar"
  • -data.update compilations.encoding.set="UTF-8"
  • -data.update compilations.bootpath.prepend="/tmp/first.jar";compilations.sourcelevel.set="1.8"

详细信息，请参阅编译数据模型。

有关配置测试范围的详细信息，请参阅配置测试范围。

创建自定义 JSON

描述的选项可以包含在 .properties 文件中并通过“-settings”参数传递。这要求每个属性都以“jtest.”作为前缀，而不是“-”，并且每个属性都应该在单独的一行中。

示例：

jtest.project.location=C:/ExampleProject
jtest.project.jsonpath=C:/project1/test/project1.json
jtest.project.name=ExampleProject
jtest.project.encoding=UTF-8
jtest.project.sourcepath=C:/ExampleProject/src/main
jtest.project.resourcepath=C:/ExampleProject/src/resources
jtest.project.sourcelevel=1.8
jtest.project.classpath=C:/ExampleProject/lib/test.jar;C:/ExampleProject/lib/test2.jar
jtest.project.javahome=C:/Program\ Files/Java/jdk1.8

-project.location

(info) 必需。

此选项允许通过指定项目的根目录来生成 .json 文件。提供一个现有目录的绝对路径。

默认情况下，example.data.json 文件在使用此选项配置的项目的根目录中创建，但是也可以使用 -project.jsonpath 自定义 .json 文件的位置和名称.

所有在分析后生成的 Jtest 报告中包含的路径，都会相对于使用此选项配置的项目根目录。

-project.jsonpath

此选项指定要创建的 .json 文件的自定义位置和名称。确保提供一个现有目录的路径。

-project.name

(info) 必需。

此选项指定项目的名称。

-project.encoding

(info) 必需。

此选项指定项目的编码。

-project.sourcepath

此选项指定项目的源文件夹。您可以通过多次使用此选项来指定多个源文件夹。

-project.resourcepath

此选项指定项目资源文件夹的路径。您可以通过多次使用此选项来指定多个源文件夹。

-project.sourcelevel

此选项指定 Java 编译器的兼容性级别。

-project.classpath

此选项指定 classpath。

-project.javahome

(info) 必需。

该选项指定 JDK 安装目录的路径。

-project.classpath.jars.dir

此选项指定要附加到项目 classpath 的 JAR 文件的目录路径。

(warning) 您必须在创建 JSON 文件后查看文件，以验证 JAR 的顺序并确保满足您的项目需求。

-project.junit.outcomes

此选项指定将用于生成报告的包含 JUnit 测试结果的 XML 文件的路径。您可以通过多次使用此选项来指定多个报告文件。

-project.compilation.classes

此选项指定编译后项目类的路径，这些类将用于生成执行“Calculate Application Coverage”配置所需的元数据。

示例：

-project.location C:/ExampleProject
-project.jsonpath C:/project1/test/project1.json
-project.name ExampleProject
-project.encoding UTF-8
-project.sourcepath C:/ExampleProject/src/main
-project.resourcepath C:/ExampleProject/src/resources
-project.sourcelevel 1.8
-project.classpath C:/ExampleProject/lib/test.jar;C:/ExampleProject/lib/test2.jar
-project.javahome C:/Program Files/Java/jdk1.8

报告

-report <path>

此选项指定创建报告的目录的路径。

-publish

此选项将结果发送到 DTP。请参阅向 DTP 发送结果和发布源代码。

自定义配置

-settings <path>

此选项指定包含以下格式的自定义设置的自定义 .properties 文件的路径：key=value（例如，report.format=pdf）。您可以通过多次使用此选项来指定多个 .properties 文件。拥有相同键的条目将被覆盖。

示例：

  • -settings Project1Config.properties

-property <key>=<value>

此选项用于直接在命令行中配置单个设置。使用以下格式：key=value。

您可以通过多次使用该选项在同一命令行中配置多个设置。拥有相同键的旧条目将被覆盖。

示例：

  • -property session.tag=sa_linux -property report.dtp.publish=true -property techsupport.create.on.exit=true

-showsettings

此选项打印当前设置和自定义配置。

有关可配置的设置列表，请参阅配置设置。

收集覆盖率

- staticcoverage

此选项指定包含静态覆盖率数据的 coverage.xml 文件的路径。

- runtimecoverage

此选项指定运行时覆盖率数据文件的路径，该文件包含从使用覆盖率代理执行的测试中收集的覆盖率。或者，您可以提供一个包含多个测试会话的运行时覆盖率数据文件的文件夹路径。

详细信息，请参阅应用程序覆盖率。

其他选项

-machineId

此选项打印您的机器 ID。

-encodepass <your password>

此选项使用 AES 256 位加密生成一个加密密码，该密码可在 .properties 配置文件中使用。 

-workspace <path>

此选项指定 .jtest 目录的自定义位置的路径，针对运行特定的数据在分析期间存储在该目录中。

-showdetails

此选项增加控制台输出详细级别，以显示进度详情。

-quiet

此选项减少控制台输出详细级别，仅显示基本信息。

-autoconfig <project name@server_name:port>

此选项指定存储在 DTP 中包含配置设置的项目。启用此选项后，Jtest 将自动使用存储在指定 DTP 项目中的设置进行配置，而无需在本地存储的 .properties 文件中进行配置。

(info) 使用 -property 选项提供在 DTP 进行身份验证所需的凭据。

示例：

-autoconfig [email protected]:8443 -property dtp.user=user1 -property dtp.password=myPassword1

-fail

如果报告违规或设置问题，此选项通过返回非零退出码来使命令失败（有关进程失败时返回退出码的详细信息，请参阅命令行退出码）。

-version

此选项打印有关您使用的 Parasoft 工具版本的信息。

-help

此选项打印命令行帮助信息。

  • No labels

Need assistance? Visit our support page