本主题介绍如何构建自定义集成,以便将任何源码控制系统与 C/C++test 集成。章节目录:
说明
C/C++test 支持最常见的版本控制/源码控制系统,例如 SVN 或 Git;详细信息请参阅连接源码控制。此外,C/C++test 还提供了一个开放的源码控制 API,允许其他源码控制工具与 C/C++test 集成。
API Javadoc
C/C++test 提供了源码控制 API 文档,其中包括必须实现的所有类和接口的 Javadoc 文档。Javadoc 文档位于以下位置:
C/C++test 独立应用程序:<INSTALL_DIR>\ide\eclipse\plugins\com.parasoft.ptest.sourcecontrol.eclipse.core_<version>\openapi\open_api_javadoc.zip
C/C++test Eclipse 插件:<ECLIPSE_DIR>\plugins\com.parasoft.ptest.sourcecontrol.eclipse.core_<version>\openapiopen_api_javadoc.zip
主要接口
连接和创建所有必需实现的接口为 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 和所有相关类位于 jar 文件中[INSTALL_DIR]\plugins\com.parasoft.xtest.libs/Parasoft/sourcecontrol.jar.
在编译之前,您可能需要将以下额外的 jar 文件添加到 classpath 中:
- [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
实现自定义集成的步骤:
- 在任意位置创建项目。
- 将所需的 jar 添加到项目的 classpath 中。
- 开始实现自定义版本控制支持。从 IVersionControlFactory 实现开始,并逐步添加所需的类。
部署和验证
实现完成后:
- 创建一个包含所有所需类的 jar 文件。对于 jar 文件名或包名等没有特定的规则。
- 将您的 jar 文件复制到 Parasoft Test 安装目录中的以下位置:<INSTALL_DIR>\plugins\com.parasoft.xtest.sourcecontrol.eclipse.core\ext.
- 重新启动 C/C++test。
- 按以下步骤验证实现:
- 选择 Parasoft> 首选项> 源码控制。
- 确保清除使用 DTP 设置。
- 验证您的自定义实现的复选框是否出现在内建版本控制中。
- 选中自定义实现的复选框,点击新建,添加所需的属性,然后点击应用。
- 转到首选项> 范围和作者页面并验证是否启用了使用源码控制来计算范围。
- 打开由版本控制系统控制的文件,右键点击文件源代码中的任意位置,然后选择显示代码行的作者。将能看到有效的版本控制作者信息。
实现示例
C/C++test 为源码控制 Open 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 文件。
- 将本地资源库解压到任意位置。
- 重新启动 C/C++test。
- 将本地资源库演示项目导入您的工作空间。
- 在 Parasoft> 首选项> 源码控制下,启用演示实现。
- 点击新建并提供所需的属性; 然后点击检查连接以验证与服务器的连接。
- 打开一个文件,右键点击文件源代码中的任意位置,然后选择显示代码行的作者。将能看到有效的版本控制作者信息。