本主题介绍了如何构建与要与 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

要实现自定义集成:

  1. 在任何位置创建项目。
  2. 将所需的 jars 添加到项目的类路径中。
  3. 开始实施自定义版本控制支持。从 IVersionControlFactory 实现开始,逐步添加所需的类。

部署和验证

实施完成后:

  1. 创建包含所有必需类的单个 jar 文件。关于 jar 文件名或包名等没有特定的规则。
  2. 将您的 jar 文件复制到 Parasoft Test 安装目录中的以下位置:<INSTALL_DIR>\plugins\com.parasoft.xtest.sourcecontrol.eclipse.core\ext.
  3. 重新启动 C/C++test。
  4. 验证实现如下:
    1. 选择 Parasoft> 首选项> 源码控制
    2. 确保清除使用 DTP 设置。
    3. 验证带有您的实现名称的复选框是否出现在内置版本控件中。
    4. 选中您的实现的复选框,单击 新建,添加所需的属性,然后单击 应用
    5. 转到 首选项> 范围和作者页面并验证是否启用了使用源码控制来计算范围。
    6. 打开由版本控制系统控制的文件,右键单击文件源代码中的任意位置,然后选择 在行显示作者。您应该会看到有效的版本控制作者信息。

示例实现

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 编译的。

您可以使用上一节中描述的过程编译和部署它。

要操作演示:

  1. 部署 demo.jar 文件。
  2. 将本地存储库解压到任何位置。
  3. 重新启动 C/C++test。
  4. 将演示本地存储库项目导入您的工作空间。
  5. Parasoft> 首选项> 源码控制下,启用演示实现。



  6. 单击 新建 并提供所需的属性; 然后单击检查连接以验证与服务器的连接。
  7. 打开一个文件,右键单击文件源代码中的任意位置,然后选择 显示作者所在行。您应该会看到有效的版本控制作者信息。


  • No labels