本主题解释如何为任何想要与 Parasoft Test 集成的源代码控制系统构建自定义集成(比如,代码审查、范围筛选和作者身份检测,请查阅 About Parasoft Test’s Source Control Support 以获得更多详情)。
Parasoft Test 为大多数常见的版本控制/源代码控制系统提供内置支持(比如,SVN、CVS、Subversion、ClearCase 等等。),如 连接到源代码控制资源库中所述。此外,它还提供了一个开源控制 API,允许将其他源代码控制工具集成到 Parasoft Test 中。
本章包含:
添加自定义源代码控制实现
API Javadoc (仅适用于 Eclipse)
Parasoft Test 线上帮助系统提供了一个源代码控制 API 主题,其中包括必须实现的所有类和接口的 Javadoc 文档。
你还可以在 Parasoft 测试安装目录 [INSTALL_DIR\plugins\com.parasoft.xtest.sourcecontrol.eclipse.core\javadoc\openapi 中找到这个 Javadoc。
主接口
连接并创建所有所需实现的接口是 com.parasoft.xtest.sourcecontrol.openapi.IVersionControlFactory。
该工厂为以下接口提供了具体的实现:
- com.parasoft.xtest.sourcecontrol.openapi.IRepositoryDetector
- com.parasoft.xtest.sourcecontrol.openapi.IVersionControl
- com.parasoft.xtest.sourcecontrol.openapi.IVersionControlHelper
实现和编译
源代码控制 API 和所有相关的类都位于 [INSTALL_DIR]\plugins\com.parasoft.xtest.libs/Parasoft/sourcecontrol.jar 中。
在编译之前,你可能需要向类路径添加以下额外的 jar 文件:
- [INSTALL_DIR]\com.parasoft.xtest.libs/Parasoft/util.jar
- [INSTALL_DIR]\com.parasoft.xtest.libs/Parasoft/common.jar
- [INSTALL_DIR]\com.parasoft.xtest.libs/Parasoft/preference_api.jar
若要实现一个自定义集成:
- 请在任何位置创建一个项目。
- 将所需的 jars 添加到该项目的类路径上。
- 开始实现自定义版本控制支持。以 IVersionControlFactory 实现开始,并逐步添加所需的类。
部署和验证
完成实现后:
- 创建一个包含所有必需类的 jar 文件。没有关于 jar 文件名或包名等的特定规则。
- 将 jar 文件复制到 Parasoft 测试安装目录中,并重新启动 Parasoft 测试产品。安装目录为:
- Eclipse: [INSTALL_DIR]\plugins\com.parasoft.xtest.sourcecontrol.eclipse.core\ext
- Visual Studio: [INSTALL_DIR]\com.parasoft.xtest.libs.vstudio/ext
- 验证实现,如下所示:
- 选择 Parasoft> Preferences> Source Control。.
- 确保清除了 Use Concerto settings。
- 验证内建版本控件中是否出现带有你的实现名的复选框。
- 选择实现的复选框,单击 New,添加所需属性,然后单击 Apply。
- 跳转至 Preferences> Scope and Authorship 页面,并验证是否启用了 Use source controlto compute scope 。
- 打开由版本控制系统控制的文件,右键单击文件源代码中的任何位置,然后选择 Show author at line。你应该看到有效的版本控制作者信息。
示例实现
Parasoft Test 为源代码控制开放 API 提供了一个示例实现。压缩包位于 [INSTALL_DIR]\plugins\com.parasoft.xtest.sourcecontrol.eclipse.core\openapi\demo\中。
解压 open_api_demo.zip 文件后,应该创建以下目录结构:
- open_api_demo/demo.jar - 包含 Eclipse 演示源代码控制实现的编译版本。
- open_api_demo/demo.dll - 包含用于 Visual Studio 2005 或更高版本的演示源代码控制实现的编译版本。
- open_api_demo/src/* - 这是 Open API 演示实现的源代码。
- open_api_demo/local_repository/* - 这是一个用于演示的示例 Eclipse 项目。
演示使用 JDK 1.6.0_29 编译。
你可以使用上一节描述的过程来编译和部署它。
若要播放演示:
- 部署 demo.jar 文件。
- 将本地存储库解压到任何位置。
- 重新启动 Parasoft 测试产品。
- 将演示本地存储库项目导入工作区。
- 在 Parasoft> Preferences> Source Control下,启用演示实现。
- 打开文件,右键单击文件源代码中的任何位置,然后选择 Show author at line。你应该看到有效的版本控制作者信息。