runtests

运行一组测试

全页折叠

语法

results = runtests

results = runtests(tests)

results = runtests(___,Name,Value)

说明

results = runtests 运行当前文件夹中的所有测试，并以 TestResult 数组形式返回结果。

示例

results = runtests(tests) 运行一组指定的测试。

示例

results = runtests(___,Name,Value) 通过由一个或多个名称-值参数指定的附加选项运行一组测试。

示例

全部折叠

运行工作文件夹中的测试

打开脚本

在当前工作文件夹中创建一个文件夹 myExample，并进入该文件夹。

在 myExample 文件夹中，创建一个测试脚本 typeTest.m。

%% Test double class
exp = 'double';
act = ones;
assert(isa(act,exp))

%% Test single class
exp = 'single';
act = ones('single');
assert(isa(act,exp))

%% Test uint16 class
exp = 'uint16';
act = ones('uint16');
assert(isa(act,exp))

在 myExample 文件夹中，创建一个测试脚本 sizeValueTest.m。

%% Test size
exp = [7 13];
act = ones([7 13]);
assert(isequal(size(act),exp))

%% Test values
act = ones(42);
assert(unique(act) == 1)

运行当前文件夹中的所有测试。

runtests

Running sizeValueTest
..
Done sizeValueTest
__________

Running typeTest
...
Done typeTest
__________


ans = 

  1x5 TestResult array with properties:

    Name
    Passed
    Failed
    Incomplete
    Duration
    Details

Totals:
   5 Passed, 0 Failed, 0 Incomplete.
   0.038077 seconds testing time.

MATLAB® 运行了 5 个测试。2 个测试通过 sizeValueTest，3 个测试通过 typeTest。

使用文件名运行测试

打开脚本

创建如下所示的测试文件，并将其保存为 MATLAB 路径上的 runtestsExampleTest.m。

function tests = runtestsExampleTest
tests = functiontests(localfunctions);

function testFunctionOne(testCase)

运行测试。

results = runtests('runtestsExampleTest.m');

Running runtestsExampleTest
.
Done runtestsExampleTest
__________

运行子文件夹中的测试

如果尚不存在测试文件，请在上面的示例中创建测试文件 runtestsExampleTest.m。

创建一个子文件夹 tmpTest 并在该文件夹中创建以下 runtestsExampleSubFolderTest.m 文件。

function tests = runtestsExampleSubFolderTest
tests = functiontests(localfunctions);

function testFunctionTwo(testCase)

通过将 'IncludeSubfolders' 设置为 true 来从上述文件夹 tmpTest 中运行这些测试。

results = runtests(pwd,'IncludeSubfolders',true);

Running runtestsExampleTest
.
Done runtestsExampleTest
__________

Running runtestsExampleSubFolderTest
.
Done runtestsExampleSubFolderTest
__________

runtests 同时在当前文件夹和子文件夹中运行这些测试。

如果您不指定 runtests 函数的 'IncludeSubfolders' 属性，则它不会在子文件夹中运行测试。

results = runtests(pwd);

Running runtestsExampleTest
.
Done runtestsExampleTest
__________

在工程中运行测试

如果您的当前文件夹是工程根文件夹，或您将工程根文件夹的路径传递给 runtests 函数，则 runtests 会运行指定工程中标有 Test 分类的所有测试文件。

此示例假设 C:\projects\project1 处的工程文件夹包含标有 Test 分类的测试文件。将当前文件夹更改为工程根文件夹，并在工程中运行测试。

cd 'C:\projects\project1'
runtests

您也可以通过打开 project1 来运行测试。完成后关闭工程。

proj = openProject('C:\projects\project1');
runtests
close(proj)

另一种方法是，通过将工程根文件夹的完整路径传递给 runtests，在工程中运行测试。

runtests('C:\projects\project1')

并行运行测试

创建以下测试文件，并以 runInParallelTest.m 的名称将其保存到 MATLAB^® 路径上。

function tests = runInParallelTest
tests = functiontests(localfunctions);

function testA(testCase)
verifyEqual(testCase,5,5);

function testB(testCase)
verifyTrue(testCase,logical(1));

function testC(testCase)
verifySubstring(testCase,'SomeLongText','Long');

function testD(testCase)
verifySize(testCase,ones(2,5,3),[2 5 3]);

function testE(testCase)
verifyGreaterThan(testCase,3,2);

function testF(testCase)
verifyEmpty(testCase,{},'Cell array is not empty.');

function testG(testCase)
verifyMatches(testCase,'Some Text','Some [Tt]ext');

并行运行测试。并行运行测试需要 Parallel Computing Toolbox™。测试框架可能会改变组的顺序和数量，或每个组中所包含的测试。

results = runtests('runInParallelTest','UseParallel',true);

Split tests into 7 groups and running them on 4 workers.
----------------
Finished Group 2
----------------
Running runInParallelTest
.
Done runInParallelTest
__________


----------------
Finished Group 3
----------------
Running runInParallelTest
.
Done runInParallelTest
__________


----------------
Finished Group 1
----------------
Running runInParallelTest
.
Done runInParallelTest
__________


----------------
Finished Group 4
----------------
Running runInParallelTest
.
Done runInParallelTest
__________


----------------
Finished Group 6
----------------
Running runInParallelTest
.
Done runInParallelTest
__________


----------------
Finished Group 5
----------------
Running runInParallelTest
.
Done runInParallelTest
__________


----------------
Finished Group 7
----------------
Running runInParallelTest
.
Done runInParallelTest
__________

运行所选参数化测试

打开脚本

在您的工作文件夹中，创建 testZeros.m。该类包含四种测试方法。

classdef testZeros < matlab.unittest.TestCase
    properties (TestParameter)
        type = {'single','double','uint16'};
        outSize = struct('s2d',[3 3], 's3d',[2 5 4]);
    end
    
    methods (Test)
        function testClass(testCase, type, outSize)
            testCase.verifyClass(zeros(outSize,type), type);
        end
        
        function testSize(testCase, outSize)
            testCase.verifySize(zeros(outSize), outSize);
        end
        
        function testDefaultClass(testCase)
            testCase.verifyClass(zeros, 'double');
        end
        function testDefaultSize(testCase)
            testCase.verifySize(zeros, [1 1]);
        end
        
        function testDefaultValue(testCase)
            testCase.verifyEqual(zeros,0);
        end
    end
end

完整测试套件包含 11 个测试元素：6 来自 testClass 方法，2 个来自 testSize 方法，1 个分别来自 testDefaultClass、testDefaultSize 和 testDefaultValue 方法。

在命令提示符下，运行 testSize 方法的所有参数化。

runtests('testZeros/testSize')

Running testZeros
..
Done testZeros
__________


ans = 

  1x2 TestResult array with properties:

    Name
    Passed
    Failed
    Incomplete
    Duration
    Details

Totals:
   2 Passed, 0 Failed, 0 Incomplete.
   0.083841 seconds testing time.

runtests 函数从 testSize 方法执行两个参数化测试。您也可以使用 runtests('testZeros','ProcedureName','testSize') 指定测试过程名称。

运行使用 outSize 参数属性的测试元素。

runtests('testZeros','ParameterProperty','outSize')

Running testZeros
........
Done testZeros
__________


ans = 

  1x8 TestResult array with properties:

    Name
    Passed
    Failed
    Incomplete
    Duration
    Details

Totals:
   8 Passed, 0 Failed, 0 Incomplete.
   0.058143 seconds testing time.

runtests 函数执行了八个使用 outSize 参数属性的测试：六个来自 testClass 方法，两个来自 testSize 方法。

运行使用 single 参数名称的测试元素。

runtests('testZeros','ParameterName','single')

Running testZeros
..
Done testZeros
__________


ans = 

  1x2 TestResult array with properties:

    Name
    Passed
    Failed
    Incomplete
    Duration
    Details

Totals:
   2 Passed, 0 Failed, 0 Incomplete.
   0.014073 seconds testing time.

runtests 函数执行了两个来自 testClass 方法并使用 outSize 参数名称的测试。

输入参数

全部折叠

`tests` — 测试
字符串数组 | 字符向量 | 字符向量元胞数组

测试，指定为字符串数组、字符向量或字符向量元胞数组。使用此参数指定测试内容。例如，您可以指定测试文件、测试类、包含测试文件的文件夹、包含测试类的包或包含测试文件的工程文件夹。

示例： runtests("myTestFile.m")

示例： runtests(["myTestFile/test1" "myTestFile/test3"])

示例： runtests("mypackage.MyTestClass")

示例： runtests(pwd)

示例： runtests({'mypackage.MyTestClass','myTestFile.m',pwd,'mypackage.subpackage'})

示例： runtests("C:\projects\project1")

名称-值参数

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

示例： runtests(tests,Name="productA_*") 运行名称以 "productA_" 开头的测试元素。

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

示例： runtests(tests,"Name","productA_*") 运行名称以 "productA_" 开头的测试元素。

测试标识

全部折叠

`IncludeSubfolders` — 指示是否运行子文件夹中的测试的指示符
`false` （默认） | `true` | `0` | `1`

指示是否运行子文件夹中测试的指示符，指定为 false 或 true（0 或 1）。默认情况下，框架只运行指定文件夹（而不包含其子文件夹）中的测试。

`IncludeSubpackages` — 指示是否运行子包中的测试的指示符
`false` （默认） | `true` | `0` | `1`

指示是否运行子包中的测试的指示符，指定为 false 或 true（0 或 1）。默认情况下，框架只运行指定包（而不包含其子包）中的测试。

`IncludeReferencedProjects` — 指示是否包含来自引用工程的测试的指示符
`false` （默认） | `true` | `0` | `1`

指示是否包含来自引用工程的测试的指示符，指定为 false 或 true。有关引用工程的详细信息，请参阅大型工程组件化。

`InvalidFileFoundAction` — 对无效测试文件采取的操作
`"warn"` （默认） | `"error"`

对函数正在处理的文件夹或包中的无效测试文件采取的操作，指定为 "warn" 或 "error"。

"warn" - 该函数对文件夹或包中的每个无效测试文件发出警告，并在有效文件中运行测试。
"error" - 如果该函数在文件夹或包中发现无效的测试文件，将会引发错误。

无效的测试文件是框架无法运行的测试文件。示例包括：包含语法错误的测试文件、基于函数但缺少局部函数的测试文件，以及具有 Test 方法但向该方法传递了未定义的参数化属性的文件。

测试过滤

全部折叠

`BaseFolder` — 基本文件夹的名称
字符串数组 | 字符向量 | 字符向量元胞数组

包含测试文件的基本文件夹的名称，指定为字符串数组、字符向量或字符向量元胞数组。此参数过滤测试套件。要使测试框架包含经过过滤的套件中的一个测试，Test 元素必须包含在 BaseFolder 指定的基本文件夹之一中。如果没有 Test 元素与基本文件夹匹配，将返回空测试套件。使用通配符 (*) 以匹配任何数量的字符。使用问号字符 (?) 只匹配一个字符。

对于包中定义的测试文件，基本文件夹是顶级包文件夹的父级。

`DependsOn` — 源文件和文件夹的名称
字符串向量 | 字符向量 | 字符向量元胞向量

包含源代码的文件和文件夹的名称，指定为字符串向量、字符向量或字符向量元胞向量。此参数过滤测试套件。为了使测试框架在过滤后的套件中包括测试，定义测试的文件必须依赖指定的源代码。如果没有测试文件依赖源代码，则返回空测试套件。

指定的值必须表示至少一个具有 .m、.p、.mlx、.mlapp、.mat 或 .slx 扩展名的现有文件。无法用不支持的扩展名显式指定文件名。如果指定文件夹名称，框架将提取该文件夹中受支持文件的路径。

您必须安装 MATLAB Test™ 才能使用 DependsOn。有关通过源代码依存关系选择测试的详细信息，请参阅 matlabtest.selectors.DependsOn (MATLAB Test)。

示例： DependsOn=["myFile.m" "myFolder"]

示例： DependsOn=["folderA" "C:\work\folderB"]

`Name` — 测试名称
字符串数组 | 字符向量 | 字符向量元胞数组

测试的名称，指定为字符串数组、字符向量或字符向量元胞数组。此参数过滤测试套件。要使测试框架包含经过过滤的套件中的一个测试，Test 元素的 Name 属性必须匹配 Name 指定的名称之一。如果 Test 元素都没有匹配的名称，将返回空测试套件。使用通配符 (*) 以匹配任何数量的字符。使用问号字符 (?) 只匹配一个字符。

对于一个给定的测试文件，测试的名称唯一地标识测试内容的最小可运行部分。测试名称包括包名称、文件名（不包括扩展名）、过程名称和关于参数化的信息。

`ParameterProperty` — 参数化属性的名称
字符串数组 | 字符向量 | 字符向量元胞数组

定义测试使用的参数的测试类属性的名称，指定为字符串数组、字符向量或字符向量元胞数组。此参数过滤测试套件。要使测试框架包含经过过滤的套件中的一个测试，Test 元素的 Parameterization 属性必须包含 ParameterProperty 指定的至少一个属性名称。如果 Test 元素都没有匹配的属性名称，将返回空测试套件。使用通配符 (*) 以匹配任何数量的字符。使用问号字符 (?) 只匹配一个字符。

`ParameterName` — 参数名称
字符串数组 | 字符向量 | 字符向量元胞数组

测试使用的参数的名称，指定为字符串数组、字符向量或字符向量元胞数组。MATLAB 根据定义参数的测试类属性生成参数名称：

如果属性值是元胞数组，则 MATLAB 根据元胞数组元素的值、类型和维度，基于元胞数组的元素生成参数名称。
如果属性值是结构体，则 MATLAB 将根据结构体字段生成参数名称。

ParameterName 参数过滤测试套件。要使测试框架包含经过过滤的套件中的一个测试，Test 元素的 Parameterization 属性必须包含 ParameterName 指定的至少一个参数名称。如果 Test 元素都没有匹配的参数名称，将返回空测试套件。使用通配符 (*) 以匹配任何数量的字符。使用问号字符 (?) 只匹配一个字符。

`ProcedureName` — 测试过程的名称
字符串数组 | 字符向量 | 字符向量元胞数组

测试过程的名称，指定为字符串数组、字符向量或字符向量元胞数组。此参数过滤测试套件。要使测试框架包含经过过滤的套件中的一个测试，Test 元素的 ProcedureName 属性必须匹配 ProcedureName 指定的过程名称之一。如果 Test 元素都没有匹配的过程名称，将返回空测试套件。使用通配符 (*) 以匹配任何数量的字符。使用问号字符 (?) 只匹配一个字符。

在基于类的测试中，测试过程的名称是包含该测试的 Test 方法的名称。在基于函数的测试中，它是包含测试的局部函数的名称。在基于脚本的测试中，它是从测试部分标题生成的名称。与测试套件元素的名称不同，测试过程的名称不包括任何包名称、文件名或关于参数化的信息。

`Superclass` — 派生测试类的父类的名称
字符串数组 | 字符向量 | 字符向量元胞数组

派生测试类的父类的名称，指定为字符串数组、字符向量或字符向量元胞数组。此参数过滤测试套件。要使测试框架包含经过过滤的套件中的一个测试，Test 元素的 TestClass 属性必须指向从 Superclass 指定的类之一派生的一个测试类。如果没有 Test 元素与类匹配，将返回空测试套件。

`Tag` — 标记的名称
字符串数组 | 字符向量 | 字符向量元胞数组

测试使用的标记的名称，指定为字符串数组、字符向量或字符向量元胞数组。此参数过滤测试套件。要使测试框架包含经过过滤的套件中的一个测试，Test 元素的 Tags 属性必须包含 Tag 指定的至少一个标记名称。如果 Test 元素都没有匹配的标记名称，将返回空测试套件。使用通配符 (*) 以匹配任何数量的字符。使用问号字符 (?) 只匹配一个字符。

测试运行自定义

全部折叠

`Strict` — 应用严格检查的指示符
`false` （默认） | `true` | `0` | `1`

在运行测试时应用严格检查的指示符，指定为 false 或 true（0 或 1）。例如，如果测试发出警告，框架会生成验证失败。

`UseParallel` — 并行运行测试的指示符
`false` （默认） | `true` | `0` | `1`

并行运行测试的指示符，指定为 false 或 true（0 或 1）。

默认情况下 runtests 串行运行测试。如果您将 UseParallel 设置为 true，则 runtests 会将测试套件分成若干单独的组且并行运行这些组，前提是满足以下条件：

安装了 Parallel Computing Toolbox。
存在一个打开的并行池，或者在 Parallel Preferences 中启用了自动池创建。

否则，runtests 以串行方式运行测试，而不管 UseParallel 的值是什么。

并行测试可能与其他选项不兼容。例如，如果 UseParallel 和 Debug 都设置为 true，则以串行方式运行测试。当并行运行时，测试框架可能会改变组的顺序和数量，或每个组中所包含的测试。

`Debug` — 应用调试功能的指示符
`false` （默认） | `true` | `0` | `1`

在运行测试时应用调试功能的指示符，指定为 false 或 true（0 或 1）。例如，如果遇到测试失败，框架将暂停执行测试以进入调试模式。

`OutputDetail` — 事件详细信息的显示级别
0 | 1 | 2 | 3 | 4 | `matlab.automation.Verbosity` 枚举

事件详细信息的显示级别，指定为介于 0 和 4 之间的整数值或 matlab.automation.Verbosity 枚举对象。整数值对应于 matlab.automation.Verbosity 枚举的成员。

runtests 函数使用 OutputDetail 指定的信息量来显示失败事件和日志记录事件。默认情况下，runtests 显示 matlab.automation.Verbosity.Detailed 级别（级别 3）的失败事件和记录的事件，以及 matlab.automation.Verbosity.Concise 级别（级别 2）的测试运行进度。

数值表示	枚举成员名称	详细程度描述
`0`	`None`	无信息
`1`	`Terse`	最少的信息
`2`	`Concise`	适中信息量
`3`	`Detailed`	部分补充信息
`4`	`Verbose`	大量补充信息

`LoggingLevel` — 记录诊断信息的最高详细级别
1 （默认） | 0 | 2 | 3 | 4 | `matlab.automation.Verbosity` 枚举

针对测试运行包含所记录诊断信息的最高详细级别，指定为介于 0 和 4 之间的整数值或 matlab.automation.Verbosity 枚举对象。runtests 函数包含在此级别和更低级别记录的诊断信息。整数值对应于 matlab.automation.Verbosity 枚举的成员。

默认情况下，runtests 包含在 matlab.automation.Verbosity.Terse 级别（级别 1）记录的诊断信息。要排除所记录的诊断信息，请将 LoggingLevel 指定为 Verbosity.None（级别 0）。

记录的诊断信息是您通过调用 log (TestCase) 或 log (Fixture) 方法提供给测试框架的诊断信息。

数值表示	枚举成员名称	详细程度描述
`0`	`None`	无信息
`1`	`Terse`	最少的信息
`2`	`Concise`	适中信息量
`3`	`Detailed`	部分补充信息
`4`	`Verbose`	大量补充信息

工件生成

全部折叠

`ReportCoverageFor` — 要包含在代码覆盖率报告中的源代码的路径
文件或文件夹的路径

代码覆盖率报告中要涵盖的源代码的路径，指定为字符串数组、字符向量或字符向量元胞数组。将此选项用于 runtests 可运行指定的测试，并为指定的代码文件生成代码覆盖率报告。该报告显示由测试执行的源代码的对应部分。

源代码位置可以是一个或多个文件夹的绝对或相对路径，也可以是扩展名为 .m、.mlx 或 .mlapp 的文件的绝对或相对路径。

示例： runtests(tests,'ReportCoverageFor','mySource.m')

数据类型： char | string | cell

`GenerateBaselines` — 创建或更新基线数据的指示符
`false` （默认） | `true` | `0` | `1`

创建或更新在使用特定验证方法的测试中使用的 MAT 文件的指示符，指定为 false 或 true（0 或 1）。您必须安装 Simulink^® Test 才能使用 GenerateBaselines。

当您将此参数指定为 true 时，您的测试必须使用 sltest.TestCase (Simulink Test) 类的下列验证方法中的至少一个：

verifySignalsMatch（例如，testCase.verifySignalsMatch(actVal,'myBaseline.mat')）
assumeSignalsMatch
assertSignalsMatch
fatalAssertSignalsMatch

有关详细信息，请参阅Using MATLAB-Based Simulink Tests in the Test Manager (Simulink Test)。

提示

当您在测试中使用共享测试脚手架并将 runtests 函数的输入指定为字符串数组或字符向量元胞数组时，测试框架会对数组进行排序，以减少共享脚手架的设置和拆解操作。因此，测试运行的顺序可能不同于输入数组中元素的顺序。有关详细信息，请参阅 sortByFixtures。
当您在远程并行池上运行测试时（需要 MATLAB Parallel Server™ 和 Parallel Computing Toolbox），MATLAB 首先将包含您的测试的本地文件夹复制到远程工作进程。为了最小化与此步骤相关联的开销，请确保这些文件夹只包含与您的测试相关的文件。

扩展功能

自动并行支持
通过使用 Parallel Computing Toolbox™ 自动运行并行计算来加快代码执行。

要并行运行测试，请将 UseParallel 名称-值参数指定为 true。

有关并行计算的更多一般信息，请参阅Run MATLAB Functions with Automatic Parallel Support (Parallel Computing Toolbox)。

版本历史记录

在 R2013b 中推出

全部展开

R2023a: 按源代码依存关系过滤测试套件

您可以按测试文件对指定源代码的依存关系来过滤测试套件。使用 DependsOn 名称-值参数（需要 MATLAB Test）来指定源文件和文件夹。

R2023a: 运行验证需求集的测试

If you have Requirements Toolbox™ and MATLAB Test installed, you can use the runtests function to run tests that verify requirement sets.要运行测试，请将一个或多个需求集文件指定为一个字符串标量或字符串向量。例如，results = runtests("myRequirementSet.slreqx") 运行验证指定的需求集的测试。

R2022b: 指定要针对无效测试文件采取的操作

要指定测试框架在遇到文件夹或包中的无效测试文件时是发出警告还是引发错误，请使用 InvalidFileFoundAction 名称-值参数。

R2022b: 从元胞数组生成的参数名称更具描述性

当您将非空元胞数组分配给参数化属性时，测试框架会根据元胞数组中元素的值、类型和维度生成参数名称。在以前的版本中，如果属性值是字符向量元胞数组，该框架将根据元胞数组中的值生成参数名称。否则，该框架将参数名称指定为 value1、value2、…、valueN。

如果您的代码使用参数名称来创建或过滤测试套件，请用描述性参数名称替换旧的参数名称。例如，通过用描述性参数名称替换 value1 来更新 suite = testsuite(pwd,"ParameterName","value1")。

R2022a: `IncludeSubfolders` 以同样的方式对待文件夹和包

IncludeSubfolders 名称-值参数以同样的方式对待文件夹和包。例如，runtests(pwd,IncludeSubfolders=true) 运行当前文件夹及其任何子文件夹（包括包文件夹）中的所有测试。在以前的版本中，IncludeSubfolders 会忽略包文件夹。

R2021b: `runtests` 会忽略未定义测试过程的工程文件

runtests 函数会忽略 MATLAB 工程中未定义测试过程的任何文件。例如，如果抽象的 TestCase 类定义文件使用 Test 分类进行标记，则该函数会忽略它。在以前的版本中，如果对除具体测试文件之外的任何文件使用 Test 分类的工程调用 runtests，则 MATLAB 会生成错误。

R2021b: 在没有 Java 虚拟机 (JVM) 软件的情况下，工程中的测试无法运行

如果 MATLAB 在没有 Java^® 虚拟机 (JVM™) 软件的情况下运行，则 runtests 无法运行 MATLAB 工程中的测试。原因是没有 JVM 软件就无法打开工程。在以前的版本中，当 MATLAB 在没有 JVM 软件的情况下运行时，runtests 基于工程中的测试文件创建一个套件并运行该套件。

R2021a: 在基于线程的池中并行运行测试

您可以通过启动线程工作进程并行池，然后使用 UseParallel 名称-值参数调用 runtests 函数，在基于线程的池上运行测试（需要 Parallel Computing Toolbox）。

在基于线程的池上使用 runtests 运行的测试存在以下限制：

您的测试和源代码只能使用线程工作进程支持的功能。有关基于线程的环境的限制的详细信息，请参阅Choose Between Thread-Based and Process-Based Environments (Parallel Computing Toolbox)。
定义测试内容的文件夹必须位于 MATLAB 搜索路径中。
必须使用类或函数的名称来指定测试名称，不带文件扩展名。
基于线程的池不支持存储测试工件。
基于线程的环境不支持 Simulink。因此，使用 Simulink Test 编写的测试无法在基于线程的池上运行。

R2020b: 在集群和云上并行运行测试

您可以在集群和云上并行运行测试（需要 MATLAB Parallel Server 和 Parallel Computing Toolbox）。要在远程并行池上运行测试，请使用 UseParallel 名称-值参数调用 runtests 函数。

R2020b: 使用独立应用程序并行运行测试

您可以创建支持并行运行测试的独立应用程序（需要 MATLAB Compiler™ 和 Parallel Computing Toolbox）。在代码中使用指令 %#function parallel.Pool，以便 MATLAB Compiler 可以找到并打包并行运行测试所需的所有组件。有关详细信息，请参阅编译 MATLAB 单元测试。

R2020b: 创建或更新基线数据

要创建或更新在使用特定验证方法的测试中使用的 MAT 文件，请使用 GenerateBaselines 名称-值参数。您必须安装 Simulink Test 才能使用 GenerateBaselines。

R2019a: 在 MATLAB 工程中运行测试

如果您的当前文件夹是工程根文件夹，或您将工程根文件夹的完整路径传递给 runtests 函数，则该函数会运行指定工程中标有 Test 分类的所有测试文件。

R2019a: 从引用工程运行测试

要从引用工程运行测试，请使用 IncludeReferencedProjects 名称-值参数。

R2019a: 生成 HTML 代码覆盖率报告

要指定要包含在代码覆盖率报告中的源代码，请使用 ReportCoverageFor 名称-值参数。

另请参阅

matlab.unittest.TestResult | matlab.unittest.TestRunner | matlab.unittest.TestSuite | testsuite | testrunner

runtests

语法

说明

示例

运行工作文件夹中的测试

使用文件名运行测试

运行子文件夹中的测试

在工程中运行测试

并行运行测试

运行所选参数化测试

输入参数

tests — 测试 字符串数组 | 字符向量 | 字符向量元胞数组

名称-值参数

IncludeSubfolders — 指示是否运行子文件夹中的测试的指示符 false （默认） | true | 0 | 1

IncludeSubpackages — 指示是否运行子包中的测试的指示符 false （默认） | true | 0 | 1

IncludeReferencedProjects — 指示是否包含来自引用工程的测试的指示符 false （默认） | true | 0 | 1

InvalidFileFoundAction — 对无效测试文件采取的操作 "warn" （默认） | "error"

BaseFolder — 基本文件夹的名称 字符串数组 | 字符向量 | 字符向量元胞数组

DependsOn — 源文件和文件夹的名称 字符串向量 | 字符向量 | 字符向量元胞向量

Name — 测试名称 字符串数组 | 字符向量 | 字符向量元胞数组

ParameterProperty — 参数化属性的名称 字符串数组 | 字符向量 | 字符向量元胞数组

ParameterName — 参数名称 字符串数组 | 字符向量 | 字符向量元胞数组

ProcedureName — 测试过程的名称 字符串数组 | 字符向量 | 字符向量元胞数组

Superclass — 派生测试类的父类的名称 字符串数组 | 字符向量 | 字符向量元胞数组

Tag — 标记的名称 字符串数组 | 字符向量 | 字符向量元胞数组

Strict — 应用严格检查的指示符 false （默认） | true | 0 | 1

UseParallel — 并行运行测试的指示符 false （默认） | true | 0 | 1

Debug — 应用调试功能的指示符 false （默认） | true | 0 | 1

OutputDetail — 事件详细信息的显示级别 0 | 1 | 2 | 3 | 4 | matlab.automation.Verbosity 枚举

LoggingLevel — 记录诊断信息的最高详细级别 1 （默认） | 0 | 2 | 3 | 4 | matlab.automation.Verbosity 枚举

ReportCoverageFor — 要包含在代码覆盖率报告中的源代码的路径 文件或文件夹的路径

GenerateBaselines — 创建或更新基线数据的指示符 false （默认） | true | 0 | 1

提示

扩展功能

自动并行支持 通过使用 Parallel Computing Toolbox™ 自动运行并行计算来加快代码执行。

版本历史记录

R2023a: 按源代码依存关系过滤测试套件

R2023a: 运行验证需求集的测试

R2022b: 指定要针对无效测试文件采取的操作

R2022b: 从元胞数组生成的参数名称更具描述性

R2022a: IncludeSubfolders 以同样的方式对待文件夹和包

R2021b: runtests 会忽略未定义测试过程的工程文件

R2021b: 在没有 Java 虚拟机 (JVM) 软件的情况下，工程中的测试无法运行

R2021a: 在基于线程的池中并行运行测试

R2020b: 在集群和云上并行运行测试

R2020b: 使用独立应用程序并行运行测试

R2020b: 创建或更新基线数据

R2019a: 在 MATLAB 工程中运行测试

R2019a: 从引用工程运行测试

R2019a: 生成 HTML 代码覆盖率报告

另请参阅

主题

WeChat

`tests` — 测试
字符串数组 | 字符向量 | 字符向量元胞数组

`IncludeSubfolders` — 指示是否运行子文件夹中的测试的指示符
`false` （默认） | `true` | `0` | `1`

`IncludeSubpackages` — 指示是否运行子包中的测试的指示符
`false` （默认） | `true` | `0` | `1`

`IncludeReferencedProjects` — 指示是否包含来自引用工程的测试的指示符
`false` （默认） | `true` | `0` | `1`

`InvalidFileFoundAction` — 对无效测试文件采取的操作
`"warn"` （默认） | `"error"`

`BaseFolder` — 基本文件夹的名称
字符串数组 | 字符向量 | 字符向量元胞数组

`DependsOn` — 源文件和文件夹的名称
字符串向量 | 字符向量 | 字符向量元胞向量

`Name` — 测试名称
字符串数组 | 字符向量 | 字符向量元胞数组

`ParameterProperty` — 参数化属性的名称
字符串数组 | 字符向量 | 字符向量元胞数组

`ParameterName` — 参数名称
字符串数组 | 字符向量 | 字符向量元胞数组

`ProcedureName` — 测试过程的名称
字符串数组 | 字符向量 | 字符向量元胞数组

`Superclass` — 派生测试类的父类的名称
字符串数组 | 字符向量 | 字符向量元胞数组

`Tag` — 标记的名称
字符串数组 | 字符向量 | 字符向量元胞数组

`Strict` — 应用严格检查的指示符
`false` （默认） | `true` | `0` | `1`

`UseParallel` — 并行运行测试的指示符
`false` （默认） | `true` | `0` | `1`

`Debug` — 应用调试功能的指示符
`false` （默认） | `true` | `0` | `1`

`OutputDetail` — 事件详细信息的显示级别
0 | 1 | 2 | 3 | 4 | `matlab.automation.Verbosity` 枚举

`LoggingLevel` — 记录诊断信息的最高详细级别
1 （默认） | 0 | 2 | 3 | 4 | `matlab.automation.Verbosity` 枚举

`ReportCoverageFor` — 要包含在代码覆盖率报告中的源代码的路径
文件或文件夹的路径

`GenerateBaselines` — 创建或更新基线数据的指示符
`false` （默认） | `true` | `0` | `1`

自动并行支持
通过使用 Parallel Computing Toolbox™ 自动运行并行计算来加快代码执行。

R2022a: `IncludeSubfolders` 以同样的方式对待文件夹和包

R2021b: `runtests` 会忽略未定义测试过程的工程文件