Eclipse 的 DTP 插件自带 Parasoft Runner，这是一个用于设置 Eclipse 工作空间和执行静态分析的应用程序。您可以在一个简单的脚本中指定想让该运行器执行的作业并传递给运行器。使用运行器可以导入、签出、刷新和构建 Eclipse 工作空间中的项目。Parasoft Runner 目前仅支持运行静态分析。
前提条件
- Eclipse 4.2 或更高版本
- Eclipse SCM 插件，如 Subversive、Subclipse、CVS、EGit 等（签出操作可选）
安装
Parasoft Runner 是 Eclipse DTP 插件的一部分，不需要进行额外的安装操作。如果您通过 Jtest 的 integration 目录安装 DTP 插件，那么 Eclipse 目录中将额外安装一个脚本。该脚本（jtestcli.sh/jtestcli.bat）包装了执行所需的命令行参数，简化了使用方法（请参阅下面的“使用方法”部分）。
使用方法
下面的命令展示了如何启动 Parasoft Runner 以及如何使用支持的参数：
eclipsec -nosplash -application com.parasoft.xtest.runner.eclipse.ParasoftRunner -data {workspace_location} -script {file_path}-settings {file_path} -config {test_configuration_url} |
如果使用 Jtest 执行分析，则可以运行在安装 DTP 插件时添加到 Eclipse 目录中的 jtestcli.sh 或 jtestcli.bat 脚本，代替输入命令行参数。
参数
安装时添加到 Eclipse 目录中的 jtestcli 脚本也支持主目录中的 jtestcli 二进制可执行文件支持的所有参数。
| 参数 | 说明 |
|---|---|
-nosplash | 确保 Eclipse 启动时不显示启动界面的 Eclipse 参数。 |
-data | 指向工作空间位置的 Eclipse 参数。 |
-script | 指向运行脚本的 Parasoft Runner 可选参数。您可以使用多个 -script 参数来执行多个脚本。执行顺序遵循在控制台中指定的顺序。如果未指定 -script 选项，Parasoft Runner 仅使用 -run 脚本命令执行分析。 |
-settings | 指向运行 Jtest 的属性文件（许可证首选项、DTP 首选项等）的 Parasoft Runner 可选参数。 |
-config | 指定分析期间使用的测试配置（运行脚本命令）的 Parasoft Runner 可选参数。如果在 .properties 文件中未设置或不存在此选项，则仅使用 UI 中设置的活动测试配置（请参阅设置有效测试配置）。 |
脚本
Parasoft Runner 使用非常简单的脚本语言来定义执行的命令。每行输入一个命令。行首或行尾的空白会被删除。空行将被忽略。以 # 注释符号开头的行中所有内容都将被忽略。命令由一个命令名以及一个或多个参数组成。
${key}（花括号）形式的子字符串会作为环境变量展开。$(key)（圆括号）形式的子字符串会在参数中作为宏递归展开。系统会先解析环境变量，再解析宏。
命令
| 命令 | 说明 |
|---|---|
var <name> <value> | 定义将在宏展开中使用的变量。 |
co </path/to/file.psf> | 签出 Eclipse 团队项目集文件中指定的项目。相对路径基于当前脚本文件进行解析（对于被包含的文件尤为重要）。 |
build [project1 [project2 [...]]] | 构建参数中指定的项目。如果未提供参数，则会构建工作空间中的所有项目。如果第一个参数是连字符（-），则会构建工作空间中除列出的项目之外的所有项目。 |
include </path/to/script> | 指向要运行的脚本文件。相对路径基于当前脚本文件进行解析（对于递归调用的 include 命令尤为重要）。 |
ant </path/to/build.xml> [target1 [target2 [...]]] | 指向要运行的指定 ant 构建文件中的目标。如果未指定一个或多个目标，则会运行默认目标。相对路径基于当前脚本文件进行解析。ant 构建文件运行后将刷新整个工作空间。 |
refresh | 对整个工作空间执行 Eclipse 刷新。 |
import </path/to/projects/directory> | 导入在指定目录中找到的 Eclipse 现有项目。如果第一个参数是 string -R，那么将递归遍历目录以搜索要导入的项目。 |
run | 对当前工作空间执行分析运行。 |
示例
以下命令将对 <eclipse_workspace_dir_location> 的 Eclipse 工作空间运行静态分析。分析范围限制于 Simple.java 文件，并且将在 <report_dir> 目录创建报告。配置和设置将从 UI 配置中获取：
jtestcli.bat -data eclipse_workspace_dir_location -include **/Simple -reports report_dir |
