接手一个停了几个月的QAC项目,源码、项目目录和上次交付的报告都在,打开项目时却提示缺少组件。这时先别用新建项目的默认配置把旧设置盖掉。旧项目可能引用了一个新版安装中没有的分析器,也可能还连着原电脑上的自定义规则文件。两种问题的处理方法不同。以下以Perforce QAC 2026.3为例,假设这次的任务是把项目迁到新版继续维护,同时保留追查旧报告的依据。
一、QAC旧项目怎么升级
可以先在项目副本上运行升级命令。QAC会更新旧项目的分析组件引用,并转换需要升级的配置文件。操作前先弄清项目用的是哪套配置,特别是调试版和发布版分别分析的项目。
1、把项目目录之外的文件也备齐
①在旧环境中打开【Project Properties】,记下当前使用的【ACF】、【RCF】和【CCT】。
②复制【旧项目目录】,再检查配置文件的保存位置。若某个自定义【RCF】放在团队共享目录,也把实际使用的那一版文件备份下来。
③将上次的【分析报告】与它对应的代码提交、构建配置和工具版本放在一起归档。
有些项目看起来只有一个目录,规则文件却是几个项目共用的。迁移副本如果还指向共享文件,编辑前可以先把引用改到副本专用的位置,避免试迁移时影响其他项目。
2、在新版环境中执行升级
如果一台机器装了两版QAC,终端里输入的命令可能仍指向旧版。升级前先确认命令实际来自哪套安装。
①运行【qacli--version】查看版本。如显示的版本与预期不符,改用新版程序的完整路径调用。
②执行【qacli project upgrade-P"D:QACLegacy_Copy"】,把示例路径换成实际的项目副本目录。
③需要选定某套项目配置时,用【-K】传入配置名。项目有多套配置的,分别核对这次打算迁移的配置。
④命令结束后打开项目副本,到【Project Properties】核对分析配置和规则配置,再选几份有代表性的源文件试跑。
二、QAC旧项目升级时缺少组件怎么处理
缺的是哪一个组件,比看到“缺少组件”几个字更有用。比如只在发布配置下提示缺失,可以从这套配置引用的分析工具链查起。
1、后续统一用新版分析
①在【Project Warning Dialog】中记下缺少的组件名称和版本,并记下触发提示的项目配置。
②在项目副本中更新分析工具链,再到【Project Properties】检查【ACF】是否引用了当前安装中可用的组件。
③对照旧项目的【RCF】,核对团队增补的编码规则及诊断映射,然后重新分析受影响的源码。
2、还要复现旧报告时,保留对应的组件版本
①查阅【旧版安装记录】与【分析配置】,确认报告使用的组件版本,并核对它是否与准备运行的环境兼容。
②若有适用的安装包,安装对应的【分析组件】后重新打开项目。若旧组件无法配合新版使用,切回留存的【旧版QAC环境】进行历史复跑。
③使用原报告对应的【源码提交】和【构建配置】执行分析,并核对原有规则设置。
例如,客户问去年报告里的某条诊断能否复现。即使补装了当时的分析器,拿今年的规则配置去跑,结果仍可能对不上。有条件的话,把旧组件、配置和报告按交付批次放在一起,省得事后猜版本。
3、组件警告消失后,按新报错查配置
若提示已经变成“找不到头文件”,排查的重点就转到了编译输入。比如头文件是构建时生成的,新机器只同步了仓库,分析时自然读不到。
①在【Project Properties】中检查【ACF】和【RCF】引用的文件是否存在,尤其留意迁移前使用的绝对路径。
②打开【Compiler Selection】,核对【CCT】是否匹配实际编译器。项目分别使用C和C++编译器时,两边都要核对。
③从【分析日志】找到首个失败文件,核对它所用的包含路径、宏定义和生成文件,再按当前构建方式重新同步项目。
三、QAC项目升级后怎么确认分析范围没变
试跑通过以后,可以挑一份熟悉的旧报告来验收。先看原来参与分析的文件是否还在,再看规则和诊断有何变化。这样即使报告少了几十条,也能找到可查的起点。
1、从一条消失的告警查起
①用旧报告对应的【代码提交】和【构建配置】运行新版分析。
②在【旧版报告】中挑一条新版没有出现的诊断,按文件路径回查新版【分析日志】,确认该文件成功完成分析。
③若文件已完成分析,继续比对两边的【RCF】和分析组件版本。把查到的原因记在【迁移记录】里,方便复查同类差异。
比如旧报告中的告警来自构建时生成的源码,迁移后这批文件可能根本没加入项目。此时即便两个版本的告警总数只差一两条,也要把缺失文件补进分析范围,再比对结果。
2、让新报告有一个明确的起点
团队如果同时在做代码整改,可以用尚未修改代码的提交留一份新版报告,以后每轮整改就有同口径的结果可比。
①将验收通过的【新版基线报告】与源码提交、组件版本和对应的项目配置一起归档。
②若日常开发与旧产品维护分别使用不同环境,在【报告名称】或归档目录中标明使用的QAC版本和配置。
总结
判断一次迁移做得怎么样,可以试着回答同事的一个问题:“旧报告里这条告警,新版为什么没有了?”如果能查到那份源码有没有参与分析、对应规则有没有启用,差异就有了解释。需要复跑历史报告的项目,旧环境仍有价值。已经转入新版维护的项目,可以把验收过的报告作为后续整改的起点,免得把升级带来的数字变化记到代码整改头上。