matlab.settings.loadSettingsCompatibilityResults

为特定版本升级工具箱个人设置的结果

折叠所有页面

语法

结果= matlab.settings.loadSettingsCompatibilityResults(toolboxName,version)

描述

结果= matlab.settings.loadSettingsCompatibilityResults(toolboxName，版本）获取升级指定工具箱和版本的个人设置的结果，并将它们作为ReleaseCompatibilityResults对象。此函数仅用于调试目的，不应包含在工具箱代码中。

在运行matlab.settings.loadSettingsCompatibilityResults，删除结果日志，再运行该函数。删除日志可以确保始终加载正确的升级结果。日志位于首选项文件夹中toolboxname文件夹中。

例子

全部折叠

获得升级个人设置的结果

创建并升级工具箱工厂树，然后测试升级是否成功完成。

创建函数createMyToolboxFactoryTree这将为工具箱创建出厂设置树mytoolbox．

函数myToolboxFactoryTree = creatatemytoolboxfactorytree ()“mytoolbox”，.．.“隐藏”、假);toolboxFontGroup = addGroup(myToolboxFactoryTree，“字体”，“隐藏”假)addSetting (toolboxFontGroup“MyFontSize”，“FactoryValue”11“隐藏”假的,.．.“ValidationFcn”@matlab.settings.mustBeNumericScalar) addSetting (toolboxFontGroup“MyFontColor”，“FactoryValue”，“黑”，.．.“隐藏”假的,“ValidationFcn”, @matlab.settings.mustBeStringScalar);结束

创建函数createMyToolboxSettingsFileUpgraders设置文件升级器对象为空。

函数upgraders = createMyToolboxSettingsFileUpgraders() upgraders = matlab.settings. settingsfileupgraders .empty;结束

创建settingsInfo.json工具箱的文件。指定mytoolbox作为根设置组名，createMyToolboxFactoryTree作为设置树的创建功能，和createMyToolboxSettingsFileUpgraders作为设置树的升级功能。的地方settingsInfo.json在工具箱里资源文件夹中。

｛“ToolboxGroupName”：“mytoolbox”，“隐藏”:假的,“CreateTreeFcn”：“createMyToolboxFactoryTree”，“CreateUpgradersFcn”：“createMyToolboxSettingsFileUpgraders”｝

将包含设置树创建函数的文件夹和工具箱资源文件夹添加到MATLAB中^®路径。然后，加载出厂设置树mytoolbox．

matlab.settings.reloadFactoryFile (“mytoolbox”）;

使用设置函数访问“设置”树的根并为MyFontSize设置。

S =设置;s.mytoolbox.font.MyFontSize.PersonalValue = 15;

中的设置名称createMyToolboxFactoryTree从MyFontSize而且MyFontColor来字形大小而且FontColor．

函数myToolboxFactoryTree = creatatemytoolboxfactorytree ()“mytoolbox”，.．.“隐藏”、假);toolboxFontGroup = addGroup(myToolboxFactoryTree，“字体”，“隐藏”假)addSetting (toolboxFontGroup“字形大小”，“FactoryValue”11“隐藏”假的,.．.“ValidationFcn”@matlab.settings.mustBeNumericScalar) addSetting (toolboxFontGroup“FontColor”，“FactoryValue”，“黑”，.．.“隐藏”假的,“ValidationFcn”, @matlab.settings.mustBeStringScalar);结束

中记录两个设置的重命名createMyToolboxSettingsFileUpgraders功能作为版本的设置树的更改2的mytoolbox．

函数upgraders = createytoolboxsettingsfileupgraders () upgraders = matlab.settings.SettingsFileUpgrader(“Version2”）;移动(升级,“mytoolbox.font.MyFontSize”，“mytoolbox.font.FontSize”）;移动(升级,“mytoolbox.font.MyFontColor”，“mytoolbox.font.FontColor”）;结束

重新加载的出厂设置树mytoolbox．

matlab.settings.reloadFactoryFile (“mytoolbox”）;

使用设置函数访问“设置”树的根并验证字形大小设置已从MyFontSize设置。

S =设置;s.mytoolbox.font.FontSize

ans =设置“mytoolbox.font”。字形大小' with properties: ActiveValue: 15 TemporaryValue:  PersonalValue: 15 FactoryValue: 11

获取版本的升级结果2的mytoolbox确定升级过程中是否出现异常，以及是否所有升级操作都成功执行。

matlab.settings.loadSettingsCompatibilityResults (“mytoolbox”，“Version2”）

ans = ReleaseCompatibilityResults with properties: VersionLabel: "Version2" PreValidationExceptions: [0×0 matlab.settings. settings.]release asecompatibilityexception] Results: [1×1 matlab.settings.VersionResults]