本主题介绍如何构建与任何源码控制系统的自定义集成。
章节目录：
前言
SOAtest 内置支持 SVN 和 Git 等常见的版本控制/源码控制系统。详情请参阅连接到源码控制资源库。此外，SOAtest 还提供了一个开源控制 API，允许将其他源码控制工具集成到 SOAtest 中。
API Javadoc
该源码控制 API 包含一个 open_api_javadoc.zip 文件，其中包含必须实现的所有类和接口的 Javadoc 文档。Javadoc 存档文件位于 <INSTALL>/plugins/com.parasoft.ptest.sourcecontrol.eclipse.core/openapi/ 目录中。
主接口
com.parasoft.ptest.sourcecontrol.openapi.IVersionControlFactory 是连接并创建所有所需实现的接口。
该工厂为以下接口提供了具体的实现：
- com.parasoft.ptest.sourcecontrol.openapi.IRepositoryDetector
- com.parasoft.ptest.sourcecontrol.openapi.IVersionControl
- com.parasoft.ptest.sourcecontrol.openapi.IVersionControlHelper
实现和编译
源码控制 API 和所有相关的类都位于 <INSTALL>/plugins/com.parasoft.ptest.libs_<VERSION>/Parasoft 目录下的 sourcecontrol.jar 文件中。
在编译之前，您可能需要向 classpath 添加以下额外的 jar 文件：
- util.jar
- common.jar
- preference_api.jar
所有 JAR 文件都位于 <INSTALL>/plugins/com.parasoft.ptest.libs_<VERSION> 目录中。
若要实现一个自定义集成：
- 请在任何位置创建一个项目。
- 将所需的 jars 添加到该项目的 classpath 上。
- 开始实现自定义版本控制支持。以 IVersionControlFactory 实现开始，并逐步添加所需的类。
部署和验证
完成实现后：
- 创建一个包含所有必需类的 jar 文件。没有关于 jar 文件名或包名等的特定规则。
- 将 jar 文件复制到 <INSTALL>/plugins/com.parasoft.ptest.sourcecontrol.eclipse.core/ext 目录，然后重启 SOAtest。
- 验证实现，如下所示：
- 选择 Parasoft> 首选项> 源码控制并禁用 使用 DTP 设置选项。
- 查看内建版本控件中是否出现带有您的实现名的选项。
- 启用相应的实现选项，然后点击新建。
- 添加必要的属性，然后点击应用。
- 选择首选项> 范围和作者并验证是否已启用使用源码控制计算范围。
- 打开由版本控制系统控制的文件和右键点击文件源代码中的任何位置
- 选择在行中显示作者。您应该看到有效的版本控制作者信息。
示例实现
SOAtest 自带源码控制开放 API 的示例实现。压缩包位于 <INSTALL>/plugins/com.parasoft.ptest.sourcecontrol.eclipse.core_<VERSION>/openapi/demo 目录中。
解压 open_api_demo.zip 文件后，创建以下目录结构：
- open_api_demo/demo.jar - 包含 Eclipse 演示源码控制实现的编译版本。
- open_api_demo/src/* - 这是 Open API 演示实现的源代码。
- open_api_demo/local_repository/* - 这是一个用于演示的示例 Eclipse 项目。
演示使用 JDK 1.6.0_29 编译。
您可以使用上一节描述的过程来编译和部署它。
与演示内容进行交互:
- 部署 demo.jar 文件。
- 将本地资源库解压到任何位置。
- 重新启动 Parasoft 测试产品。
- 将演示本地资源库项目导入工作空间。
- 在 Parasoft> 首选项> 源码控制选项下，启用演示实现。
- 打开文件，右键点击文件源码中的任何位置，然后选择在行中显示作者。您应该看到有效的版本控制作者信息。
