QAC Dashboard 源代码存储库集成详解

QAC Dashboard 源代码存储库集成

访问不同版本的源代码是管理Helix QAC dashboard项目的关键要求。

• 对于每个源文件或头文件,项目可以连接到源存储库或上传该源文件的副本(快照)。

• 各种显示和操作需要源代码和源版本之间的行差异。

• 有两种可供选择的方法来获取源代码：
  1）连接到源存储库或版本控制系统(VCS)以获取源文件和头文件的版本。
  2）上传源代码以及每个快照版本

  **提示）**即使在上传源代码时捕获VCS文件实体、版本标记和作者信息也很有用
  **注意)**这两种方法可以结合起来:获取从VCS检出的文件的VCS信息,且上传其他源代码到QAC dashboard server (如编译产生的不在VCS中的文件)

• QAC dashboard中的每个项目都可以配置为不同的VCS系统，如一个项目使用SVN，一个项目使用Git。

1. Repository Communication （存储库通信）
   

• Helix QAC Dashboard有两个操作区域,与版本控制系统(VCS)进行通信:
  1)在导入阶段,捕获VCS源文件信息:
  a)在快照导入操作期间从VCS获取文件实体详细信息,这是将快照上传到Helix QAC Dashboard项目的一部分。针对快照中的每个源代码或头文件实体查询VCS.以获取完全限定的文件名、版本、作者和检入的时间戳。
  2）在服务器操作时，要检索源代码和版本的差异：
  b) API调用由Helix QAC Dashboard服务器进行,以响应Web用户项目视图并执行各种后台任务;对每个文件实体的两个主要调用是检索源代码,以及获取两个代码版本之间的代码行差异。
  **提示）**与VCS的交互主要由 prgavcs 命令行程序，配置由 VCS configuration 文件控制。

2. Repository API Calls (存储库API调用)
   

与VCS的交互主要由 prqavcs命令行程序，配置由 VCS configuration 文件控制。

• 由prqavcs进行的API调用由两个集合组成。
  1)一个集合用于在snapshot上传的导入阶段询问每个源文件和头文件
  Import Phase API Calls:
  This collection of API calls are used in snapshot import operations, operating on locally checked out source files and associated header files.
  

提示)快照导入阶段要求直接或通过执行重定向的替换部分访问VCS检出的源文件和头文件。

2)另一个集合用于从VCS获取源代码和代码行差异。

• Server API Calls:
  

3. VCS Configuration XML File (VCS配置XML文件)

每一个prqavcs API 调用都引用一个XML配置文件，其中包含完成VCS或脚本操作所需的详细信息。
VCS配置XML文件中的全部属性集，以及API适用于，解释如下：