addModelCoverage

为 Simulink 测试启用模型覆盖率收集

自 R2021a 起

语法

addModelCoverage(runner) addModelCoverage(runner,covformat,location) addModelCoverage(___,Name,Value)

说明

addModelCoverage(runner) 使指定的测试运行器能够为基于 MATLAB 的 Simulink 测试添加模型覆盖率并生成覆盖率报告。覆盖率格式默认为 html-report。此方法将 sltest.plugins.ModelCoveragePlugin 添加到测试运行器。addModelCoverage 是 matlab.unittest.TestRunner 类的方法。

addModelCoverage(runner,covformat,location) 使用指定的覆盖率格式启用模型覆盖率收集，并将报告保存在指定位置。

addModelCoverage(___,Name,Value) 启用模型覆盖率收集，并通过一个或多个 Name,Value 对参量指定附加选项。

输入参数

全部展开

`runner` — 测试运行器
`matlab.unittest.TestRunner` 对象

测试运行器，指定为 matlab.unittest.TestRunner 对象。

`covformat` — 覆盖率报告格式
`"html-report"` (默认) | `"cobertura"`

覆盖率报告格式，指定为 "cobertura" 或 "html-report"。如果指定覆盖率格式，则还必须指定位置。

`location` — 覆盖率报告文件夹
细绳

覆盖率报告文件夹，指定为字符串。如果指定覆盖率格式，则必须指定位置。

示例: "html-report","mytests/coverage/"

名称-值参数

将可选参数对参量为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是相应的值。名称-值参量必须出现在其他参量之后，但对的顺序无关紧要。

在 R2021a 之前，使用逗号分隔每个名称和值，并将 Name 括在引号中。

示例: 'CollectMetrics',["MCDC","Decision"]

`IncludeModelReference` — 收集模型引用的覆盖率
`false` (默认) | `true`

收集模型引用的覆盖率，指定为逻辑 true 或 false。如果 IncludeModelReference 是 true，则运行器会收集主模型和所有引用模型的覆盖率。

示例: 'IncludeModelReference',true

`CollectMetrics` — 收集度量覆盖率
字符串数组 | 元胞数组

收集度量的覆盖率，指定为字符串数组或字符向量元胞数组。对于支持的覆盖率度量，请参阅 sltest.plugins.coverage.CoverageMetrics 属性。

示例: 'CollectMetrics',["MCDC","Decision"] 或 'CollectMetrics',{'MCDC','Decision'}

示例

全部展开

启用模型覆盖率收集

此示例展示了如何在使用测试运行器时启用收集模型覆盖率并指定度量。

在运行此示例之前，创建一个名为 myTests.m 的测试文件。该示例为文件创建一个测试套件，然后创建一个带有 'textoutput' 选项的测试运行器，以将状态和诊断信息输出到命令行。将 addModelCoverage 添加到测试运行器中，以便收集使用 MCDC 和条件度量的模型覆盖率，指定 HTML 报告的文件夹名称，并包括引用的模型。另外，将 addSimulinkTestResults 添加到测试运行器，以便在测试管理器中推送结果并将测试结果导出到名为 testmgr_results.mldatx 的文件中

suite = testsuite('myTests');
runner = testrunner('textoutput');
addModelCoverage(runner,...
   "CollectMetrics",["MCDC","Condition"],...
   "html-report","tests/cov/",
   "IncludeModelReference",true);
addSimulinkTestResults(runner,"ExportToFile","testmgr_results.mldatx");
run(runner,suite);