QAC中文网站 > 热门推荐 > QAC项目模板怎么创建 QAC项目模板能跨电脑复用吗
教程中心分类
QAC项目模板怎么创建 QAC项目模板能跨电脑复用吗
发布时间:2026/11/17 15:55:37

  团队里两个人用QAC检查同一份嵌入式代码,一台电脑可以跑完,另一台却提示找不到头文件。即使把规则文件发过去,问题也可能还在,因为规则、编译器配置和本机的构建路径各管一件事。QAC的项目模板可以用一组可复用的配置文件来组织。换电脑时,共用的分析设置可以带过去,源码和工具链的位置则要在新环境中重新确认。

  一、QAC项目模板怎么创建

 

  以Perforce QAC 2026.3为例,可以用ACF、RCF和CCT组成一套建项目用的配置。ACF管理分析组件及其配置,RCF保存规则配置,CCT描述分析器需要模拟的编译器环境。三份文件用途不同,整理时可以先从一个已验证过的项目着手。

 

  1、从现有项目提取共用设置

 

  ①打开已经能正常分析的【QAC项目】。项目有多套配置时,先确认要复用的是哪一套,例如量产配置或日常检查配置。

 

  ②在【Analysis Configuration File(ACF)】区域点击【Export】,把现有分析配置保存到团队约定的目录。可以用目标平台或用途命名,方便与其他配置区分。

 

  ③用【qacli project config-file-L-P<项目目录>】查看项目实际使用的配置文件。多配置项目可以加上【-K<配置名>】,核对该配置对应的RCF和CCT,再将需要复用的文件一起归档。

 

  同一套规则可以用于几个产品,但它们未必使用同一种编译器。比如两个项目都做MISRA C检查,一个用目标板工具链,另一个用主机编译器。RCF可以按团队约定共用,CCT要按实际编译器选。

 

  2、用这套配置新建一个项目验证

 

  模板第一次整理好,可以用一份有代表性的代码验证。选一个会包含项目头文件、也会用到条件编译的源文件,更容易发现配置漏项。

 

  ①在【QA·GUI】中打开【Project】→【New Project】,指定新项目的位置。使用命令行时,也可通过【qacli project create】创建。

 

  ②用【--acf】、【--rcf】和【--cct】指定准备好的配置文件,通过【--qaf-project】指定新项目目录。目录中已有QAC项目时,另选一个目录用于验证。

 

  ③将该代码的文件和编译信息同步到【新项目】,运行分析。核对使用的规则配置,并检查代表性源文件能否读取头文件、识别宏和进入预期的条件编译分支。

 

  二、QAC项目模板能跨电脑复用吗

 

  可以。前提是目标电脑具备这套配置依赖的QAC组件、规则包和编译环境。换电脑时尤其要留意编译数据库,它里面的工作目录、编译器命令和头文件路径可能来自原机器。

 

  1、在新电脑上核对工具和配置文件

 

  ①在目标电脑检查【QAC版本】、分析组件和规则包,确认能加载准备复用的【ACF】和【RCF】。两台电脑版本有差别时,先做一次小范围验证。

 

  ②核对【CCT】对应的编译器、语言和目标环境。目标电脑换了工具链时,按实际构建环境选用或生成对应的CCT。

 

  ③把共享配置放进新电脑可访问的目录,再按本机的【项目目录】建项目。脚本或命令中引用的配置文件位置,也换成本机可访问的路径。

  2、用新电脑的构建信息同步项目

 

  旧电脑生成的编译数据库可能还指着原用户目录。即使新电脑上的代码目录结构相同,只要仓库放到了别处,库里记录的绝对路径就可能失效。

 

  ①在目标电脑检出要分析的代码版本,使用该电脑的构建环境重新生成【compile_commands.json】,并抽查其中的【directory】、【file】和编译参数。

 

  ②用【qacli sync-t JSON-P<项目目录>compile_commands.json】将编译数据库同步到QAC项目,再检查源文件列表中是否有预期的模块。

 

  3、用同一份代码判断复用是否成功

 

  ①让两台电脑分析同一源码提交和同一构建配置。对照【分析结果】中的文件数量、解析错误及抽查文件的诊断。

 

  ②如果诊断不同,先检查【头文件搜索路径】和【预处理宏】,再核对实际加载的规则与组件版本。定位到具体文件后,确认两边是否编译了同一段代码。

 

  项目能打开,只说明配置文件可以被读取。比如调试版定义了某个宏,量产版没有,两台电脑就可能分析同一源文件里的不同分支。比对结果时,先把构建配置对齐,诊断差异才有可比性。

 

  三、QAC项目模板复用失败怎么排查

 

  迁移后如果报错,先看问题是在加载配置时出现,还是已经开始分析代码才出现。前一种多半要查文件或组件,后一种可以顺着具体源文件检查构建参数。

 

  1、项目能打开,但分析规则对不上

 

  ①用【qacli project config-file-L】查看当前配置关联的文件,确认实际使用的【ACF】和【RCF】与共享目录中的版本一致。

 

  ②检查【项目配置名】和运行分析时选中的配置。如果项目同时有日常规则和发布规则,切到计划使用的那套,再挑一个有代表性的源文件复查。

 

  两份规则文件可能同名,内容却来自不同修订。团队维护模板时,可以把配置和修订记录一起管理。以后看到告警数量变了,也有依据判断是哪套规则生效。

 

  2、头文件找不到,或有些源码没进入分析

 

  出现这类问题时,可以先追一份具体源文件。报错文件和根本没被导入的文件,排查入口也不一样。

 

  ①从【分析日志】找到首个头文件找不到的报错,对照这份源文件的【编译命令】,核对包含目录是否存在。涉及构建生成的头文件时,检查本机是否已经完成对应的生成步骤。

 

  ②如果某个源文件根本没出现在项目里,先查【compile_commands.json】里有没有该条目。缺条目就回查生成数据库时选择的构建目标,有条目则检查路径和同步结果。

 

  ③处理完后重新运行【qacli sync】,再分析受影响的文件。确认解析恢复、规则也按预期加载后,再运行全项目分析。

  总结

 

  QAC项目模板适合固化团队已经商定的分析组件和规则。工具链安装在哪里、这次编了哪些文件、用了哪些宏,则由每台电脑的实际构建环境决定。交接时可以留一个小模块作为验收样例,注明它使用的构建配置和几条可核对的诊断。新同事换电脑或团队升级工具链时,有了这份参照,就能判断问题出在配置文件,还是出在本机的构建信息。

176 5129 0128