sltest.testmanager.setpref

设置测试管理器预设项

全页折叠

语法

settings = sltest.testmanager.setpref(group,preference,value)

settings = sltest.testmanager.setpref('MATLABReleases','ReleaseList',releasePrefs)

settings = sltest.testmanager.setpref('MATLABReleases',release,releasePref)

simlog_setting = sltest.testmanager.setpref('ShowSimulationLogs','IncludeOnCommandPrompt',value)

simlog_detailed_setting = sltest.testmanager.setpref('ShowSimulationLogs','ShowAllLogDetails',value)

name_setting = sltest.testmanager.setpref('ResultSetProperty','ResultSetName',name)

说明

settings = sltest.testmanager.setpref(group,preference,value) 设置 group 中的测试管理器预设项，由 preference 和 value 指定。

示例

settings = sltest.testmanager.setpref('MATLABReleases','ReleaseList',releasePrefs) 使用 releasePrefs 指定的版本更新您预设项中指定的版本。此预设项允许您使用当前版本以外的版本进行测试。

此语法取代了现有的添加版本列表。包含已在发布首预设项中的发布路径会返回错误。要将该版本包含在 releasePrefs 中，请首先删除现有的版本列表。

示例

settings = sltest.testmanager.setpref('MATLABReleases',release,releasePref) 将指定的 release 添加到测试管理器预设项中的发布列表中。将 releasePref 设置为 {[]} 以删除该版本。

示例

当 value 为 true 时，simlog_setting = sltest.testmanager.setpref('ShowSimulationLogs','IncludeOnCommandPrompt',value) 在 MATLAB^® 命令提示符下显示仿真日志。默认值为 false。

示例

simlog_detailed_setting = sltest.testmanager.setpref('ShowSimulationLogs','ShowAllLogDetails',value) 在 value 为 true 时，会在 MATLAB 命令提示符下显示详细的错误消息和仿真日志。ShowAllLogDetails 不支持多版本测试、实时测试、以并行模式运行的 MATLAB 单元测试，或以并行模式运行的软件在环测试。默认值为 false。

示例

name_setting = sltest.testmanager.setpref('ResultSetProperty','ResultSetName',name) 设置用于测试结果集的名称。指定的名称将应用于您设置预设项后运行的测试的所有结果集。此函数不会改变现有结果集的名称。

示例

全部折叠

设置测试套件部分显示预设项

更改测试套件部分中两个测试管理器预设项的显示设置。

获取测试套件显示预设项。

settings = sltest.testmanager.getpref('TestSuiteDisplay')

settings = 

  struct with fields:

        TestTag: 1
    Description: 1
    Requirement: 1
       Callback: 1
       Coverage: 1

隐藏 Description 和 Requirement 部分。

settings = sltest.testmanager.setpref...
('TestFileDisplay',{'Description','Requirement'},{false,false})

settings = 

  struct with fields:

           TestTag: 1
       Description: 0
       Requirement: 0
          Callback: 1
          Coverage: 1
    TestFileOption: 1

添加和删除 MATLAB 发布预设项

您可以一次添加多个版本，删除添加的版本，或者在测试管理器 MATLAB 发布首预设项中添加和删除单个版本。

设置您的预设项以包含多个版本。为每个版本创建一个结构体。

r1 = struct('Name','18b',...
            'MATLABRoot','\\mycompany\R2012b\matlab',...
            'Selected',true);
r2 = struct('Name','19a',...
            'MATLABRoot','\\mycompany\R2014a\matlab',...
            'Selected',true);
r3 = struct('Name','20a',...
            'MATLABRoot','\\mycompany\R2015a\matlab',...
            'Selected',true);

使用 sltest.testmanager.setpref 添加版本。

sltest.testmanager.setpref('MATLABReleases','ReleaseList',{r1,r2,r3});

将另一个版本添加到预设项中。

r4 = struct('Name','19b',...
            'MATLABRoot','\\mycompany\R2013a\matlab',...
            'Selected',true);
sltest.testmanager.setpref('MATLABReleases','19b',{r4});

从预设项中删除一个版本。

sltest.testmanager.setpref('MATLABReleases','18b',{[]});

设置仿真日志显示

打开在命令提示符下显示仿真日志。要在命令提示符中查看更多详细信息，请使用 sltest.testmanager.setpref("ShowSimulationLogs","ShowAllLogDetails",true); 代替.

sltest.testmanager.setpref("ShowSimulationLogs",...
   "IncludeOnCommandPrompt",true);

恢复为不显示命令提示符下的仿真日志输出。

sltest.testmanager.setpref('ShowSimulationLogs',...
   'IncludeOnCommandPrompt',false);

查看当前仿真日志显示设置。

sltest.testmanager.getpref('ShowSimulationLogs',...
   'IncludeOnCommandPrompt')

设置结果集名称

设置用于新结果集的非默认名称。

sltest.testmanager.setpref('ResultSetProperty',...
   'ResultSetName','My Result Set');

通过指定空字符向量恢复为默认结果集名称。

sltest.testmanager.setpref('ResultSetProperty',...
   'ResultSetName','');

输入参数

全部折叠

`group` — “预设项”组
`'TestFileDisplay'` | `'TestSuiteDisplay'` | `'TestCaseDisplay'` | `'ShowSimulationLogs'` | `'ResultSetProperty'`

预设项组名称，指定为以下值之一：

'TestFileDisplay' - 文件部分显示预设项
'TestSuiteDisplay' - 测试套件部分显示预设项
'TestCaseDisplay' - 测试用例部分显示预设项
'MATLABReleases' - MATLAB 版本用于测试预设项
'ShowSimulationLogs' - 是否在命令提示符下显示仿真日志
'ResultSetProperty' - 用于结果集的名称

`preference` — 预设项名称
字符向量 | 字符向量元胞数组

预设项名称，指定为字符向量。使用 settings = sltest.testmanager.getpref(group) 获取特定 group 的有效预设项。

示例: ('TestSuiteDisplay','TagText')

示例: ('ShowSimulationLogs','IncludeOnCommandPrompt')

示例: ('ShowSimulationLogs','ShowAllLogDetails')

示例: ('ResultSetProperty','ResultSetName')

`value` — 预设项值
`true` 或 `1` | `false` 或 `0` | 逻辑值元胞数组

预设项值，指定为数字或逻辑值 1 (true) 以显示预设项或 0 (false) 以隐藏偏好。

示例: true

示例: {true,false}

`release` — 发布以添加或删除预设项
字符向量

发布以添加到首选项或从预设项中删除，指定为字符向量。

示例: '20a'

`releasePrefs` — 发布信息
结构 | 元胞数组

发布信息，指定为结构体或结构元胞数组。在结构体中，按以下顺序包括：

'Name',releaseName
'MATLABRoot',Path
'Selected',logical

示例: struct('Name','20a','MATLABRoot','\\mypath','Selected',true)

`releasePref` — 发布信息
结构 | `{[]}`

发布信息，指定为结构体或 {[]}。使用 {[]} 从预设项中删除发布信息。在结构体中，包括：

'Name',releaseName
'MATLABRoot',Path
'Selected',Boolean

示例: struct('Name','20a','MATLABRoot','\\mypath','Selected',true)

`name` — 结果集名称
字符向量 | 字符串

结果集的名称，指定为字符向量或字符串。新名称仅适用于新的测试运行。设置此属性不会改变现有的结果集名称。如果设置新名称然后导入结果集，则导入的结果集将保留其原始名称。

示例: 'my Result Set'

输出参量

全部折叠

`settings` — 测试管理器预设项
结构

预设项设置，以结构体返回。

`simlog_setting` — 测试管理器预设项是否在命令行显示仿真日志
0 | 1

是否在命令行显示仿真日志的预设项设置，返回为 0 (false)或 1 (true)。

`simlog_detailed_setting` — 测试经理对是否在命令行显示详细错误消息和仿真日志的偏好设置
0 | 1

命令行中是否显示详细错误消息和仿真日志的偏好设置，返回值为 0 (false)或 1 (true)。

`name_setting` — 测试管理器对结果集名称的预设项
字符向量

结果集名称的预设项设置，以字符向量形式返回。

版本历史记录

在 R2017a 中推出

全部展开

R2025a: 在命令行中显示详细的错误和仿真日志消息。

要在命令行中显示详细的仿真日志消息，请使用 'ShowSimulationLogs','ShowAllLogDetails',true 作为输入。

R2023b: 为结果集设置新名称

要为将来的测试运行设置新的非默认结果测试名称，请使用 sltest.testmanager.setpref('ResultSetProperty','ResultSetName',name)，其中 name 是结果集的新名称。

R2021a: 在命令行上显示仿真日志消息

要在命令行显示仿真日志消息，请使用 'ShowSimulationLogs','IncludeOnCommandPrompt',true 作为输入。

另请参阅

sltest.testmanager.getpref

sltest.testmanager.setpref

语法

说明

示例

设置测试套件部分显示预设项

添加和删除 MATLAB 发布预设项

设置仿真日志显示

设置结果集名称

输入参数

group — “预设项”组 'TestFileDisplay' | 'TestSuiteDisplay' | 'TestCaseDisplay' | 'ShowSimulationLogs' | 'ResultSetProperty'

preference — 预设项名称 字符向量 | 字符向量元胞数组

value — 预设项值 true 或 1 | false 或 0 | 逻辑值元胞数组

release — 发布以添加或删除预设项 字符向量

releasePrefs — 发布信息 结构 | 元胞数组

releasePref — 发布信息 结构 | {[]}

name — 结果集名称 字符向量 | 字符串

输出参量

settings — 测试管理器预设项 结构

simlog_setting — 测试管理器预设项是否在命令行显示仿真日志 0 | 1

simlog_detailed_setting — 测试经理对是否在命令行显示详细错误消息和仿真日志的偏好设置 0 | 1

name_setting — 测试管理器对结果集名称的预设项 字符向量

版本历史记录

R2025a: 在命令行中显示详细的错误和仿真日志消息。

R2023b: 为结果集设置新名称

R2021a: 在命令行上显示仿真日志消息

另请参阅

主题

`group` — “预设项”组
`'TestFileDisplay'` | `'TestSuiteDisplay'` | `'TestCaseDisplay'` | `'ShowSimulationLogs'` | `'ResultSetProperty'`

`preference` — 预设项名称
字符向量 | 字符向量元胞数组

`value` — 预设项值
`true` 或 `1` | `false` 或 `0` | 逻辑值元胞数组

`release` — 发布以添加或删除预设项
字符向量

`releasePrefs` — 发布信息
结构 | 元胞数组

`releasePref` — 发布信息
结构 | `{[]}`

`name` — 结果集名称
字符向量 | 字符串

`settings` — 测试管理器预设项
结构

`simlog_setting` — 测试管理器预设项是否在命令行显示仿真日志
0 | 1

`simlog_detailed_setting` — 测试经理对是否在命令行显示详细错误消息和仿真日志的偏好设置
0 | 1

`name_setting` — 测试管理器对结果集名称的预设项
字符向量