做C/C++test结果交付时,最常见的两件事就是把报告固定成PDF方便归档与评审,以及把报告里的任务数、覆盖率、作者分配这些字段解释清楚,避免只看一个总数就下结论。实际操作建议先把报告输出位置和格式固定下来,再按报告的导航结构从总览表一路下钻到具体文件与行号,这样既能导出,也能把字段含义讲明白。
一、C/C++test报告怎么导出成PDF格式
要导出PDF,核心是两步:先在报告设置里把格式选为PDF并指定一个不会被清理的目录,再在测试完成后用生成报告入口输出report.pdf。GUI和命令行都支持PDF,只是入口不同。
1、在Eclipse界面里先固定报告格式与输出目录
打开【Parasoft】→【Preferences】→【Reports】,在【File format】下拉里选择PDF,并在Custom locations里启用Reports目录设置,后续每次生成报告都会落到你指定的位置,不会默认写到临时目录。
2、在Visual Studio界面用同一条思路配置
打开【Parasoft】→【Options】→【Reports】,同样在文件格式里选择PDF并指定报告目录。官方说明里明确了报告格式与位置都在Reports设置页统一配置。
3、测试跑完后用【Generate Report】生成report.pdf
测试结束后,在Test Progress面板点击【Generate Report】,在弹出的【Report&Publish】对话框里确认Report location是你的归档目录,再点【OK】生成报告。文档给出了该流程,并列出了PDF输出文件名为report.pdf。
4、把【Delete on exit】关掉,避免生成后退出就消失
如果你发现报告生成后重启工具就找不到,优先检查【Report&Publish】里是否启用了【Delete on exit】,该选项会在退出时删除报告文件,交付场景建议关闭。
5、命令行批量出PDF时用report.format参数统一口径
需要在CI里批量生成PDF时,做法是用一个.properties配置文件写入report.format为pdf,并在执行时让cpptestcli读取该配置,同时用-report指定输出目录。官方文档明确了report.format可生成PDF。
6、需要多种格式同时产出时用同一次运行生成多份
如果你既要PDF归档又要HTML方便下钻,建议在.properties里配置report.format生成多格式,GUI文档也提示可用report.format在一次运行中生成不同格式报告。
二、C/C++test报告字段含义怎么看
理解字段最省力的方法是按报告的层级阅读:先看Header确认这是哪次运行,再看Overview与分布表掌握规模与风险,再用Task Details和Checked Files定位到具体文件与行号。不同配置会影响报告内容,但常见字段结构相对稳定。
1、先分清两类报告,管理视角与个人视角字段不一样
命令行可生成Manager综合报告与Developer聚焦报告,GUI生成的报告结构接近综合报告,并在需要时链接到开发者报告,解释字段时先确认你拿到的是哪一种。
2、Header和导航栏字段用来对齐版本与范围
导航栏会显示运行时间,并提供Metrics、Static Analysis、Test Generation、Test Execution等入口,评审时先确认时间与模块入口一致,避免把不同批次报告混在一起。
3、Static Analysis常见字段怎么读
Overview表会给出静态分析任务总数、检查的文件数、项目文件总数、检查的代码行数与总代码行数,以及静态分析耗时。Distribution of Total Tasks会按规则类别与规则展示任务分布,也支持按规则严重性排序,适合用来说明问题集中在哪些规则或类别。
4、Tasks per Author里三个高频字段的含义
Suppressed tasks表示被抑制的任务数量,delta total表示相对上一次运行任务总数的变化,recommended tasks是工具按团队配置挑出的当日建议优先处理子集。解释作者表时,建议同时说明这是按团队设定的每人最大任务数与任务分配规则计算出来的。
5、Task Details与Checked Files字段用来落到证据层
Task Details会列出每条任务的详细信息,Checked Files会按文件列出违规数与抑制数,并在存在违规时给出行号、规则名与规则ID。对外沟通时用Checked Files先定位文件,再用Task Details补充上下文会更清晰。
6、Test Execution与Coverage相关字段怎么解释
Test Execution的Overview会按类别统计任务数,并给出用例执行结果包含passed、failed、total test cases,同时说明Unverified Outcomes会被计入通过用例。Coverage Summary表用于呈现覆盖率统计,并支持用树形加号逐层下钻,点Coverage Summary链接还能打开带源码标注的逐行覆盖细节。
三、C/C++test报告交付时怎么把字段讲清楚
报告看懂之后,还要让别人也能快速复核,建议把导出与解读动作固化成固定节奏,减少口径争议。
1、先统一报告内容开关再导出
在【Reports】设置页把需要的章节勾选好再导出,避免同一项目不同人导出的报告章节不一致,导致字段缺失或顺序不同。
2、把总览表当作摘要,把下钻结果当作附件
对管理层先给Overview与Distribution,说明任务总量与集中点,对研发评审再附上Checked Files与Task Details截图或页码,形成可追溯链路。
3、解释任务数量时同时说明抑制与推荐口径
很多误解来自把total tasks当成全部需要立即修复的数量,交付时建议把suppressed与recommended同时写上,并说明recommended是按团队目标与分配规则筛出来的优先集。
4、覆盖率解读要说明指标来源与下钻层级
只报一个覆盖率百分比信息量不够,建议同时说明Coverage Summary下钻到模块或文件后的差异,必要时引用逐行覆盖报告作为证据。
5、归档PDF时把运行时间与配置一并保存
PDF文件名通常是report.pdf,建议在归档目录按日期或构建号分文件夹保存,并把本次运行使用的测试配置与报告设置一并留存,后续复盘更省时间。
总结
C/C++test报告怎么导出成PDF格式,关键是先在【Reports】里选PDF并指定固定目录,再在测试完成后用【Generate Report】生成report.pdf,同时关闭【Delete on exit】避免文件被清理。C/C++test报告字段含义怎么看,建议按导航结构从Overview与分布表掌握全局,再用Tasks per Author、Checked Files、Task Details与Coverage Summary逐层下钻,把total、suppressed、delta total、recommended与passed、failed、coverage这些字段放在同一口径下解释清楚。