本主题介绍了如何构建与要与 C/C++test 集成的任何源码控制系统的自定义集成。此章节:
说明
C/C++test 支持最常见的版本控制/源码控制系统,例如 SVN 或 Git; 详情请参阅连接到源码控制。此外,它还提供了一个开放的源码控制 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 文件添加到您的类路径中:
- [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 Test 安装目录中的以下位置:<INSTALL_DIR>\plugins\com.parasoft.xtest.sourcecontrol.eclipse.core\ext.
- 重新启动 C/C++test。
- 验证实现如下:
- 选择 Parasoft> 首选项> 源码控制。
- 确保清除使用 DTP 设置。
- 验证带有您的实现名称的复选框是否出现在内置版本控件中。
- 选中您的实现的复选框,单击 新建,添加所需的属性,然后单击 应用。
- 转到 首选项> 范围和作者页面并验证是否启用了使用源码控制来计算范围。
- 打开由版本控制系统控制的文件,右键单击文件源代码中的任意位置,然后选择 在行显示作者。您应该会看到有效的版本控制作者信息。
示例实现
C/C++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 文件。
- 将本地存储库解压到任何位置。
- 重新启动 C/C++test。
- 将演示本地存储库项目导入您的工作空间。
- 在 Parasoft> 首选项> 源码控制下,启用演示实现。
- 单击 新建 并提供所需的属性; 然后单击检查连接以验证与服务器的连接。
- 打开一个文件,右键单击文件源代码中的任意位置,然后选择 显示作者所在行。您应该会看到有效的版本控制作者信息。