主要内容

matlab.settings.loadSettingsCompatibilityResults

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

描述

例子

结果= matlab.settings.loadSettingsCompatibilityResults (toolboxName,版本)得到的结果的个人设置指定的工具箱和版本升级并返回它们ReleaseCompatibilityResults对象。这个函数仅用于调试目的,不应包括在航运工具箱的代码。

在运行matlab.settings.loadSettingsCompatibilityResults在运行函数之前,删除日志的结果了。删除日志,确保正确的升级结果总是加载。日志位于偏好文件夹,toolboxname文件夹中。

例子

全部折叠

创建然后升级一个工具箱工厂树,然后测试,升级成功完成。

创建函数createMyToolboxFactoryTree创建工厂设置工具箱的树mytoolbox

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

创建函数createMyToolboxSettingsFileUpgraders用一个空的设置文件升级程序对象。

函数升级升级= createMyToolboxSettingsFileUpgraders () = matlab.settings.SettingsFileUpgrader.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;

更改设置名称createMyToolboxFactoryTreeMyFontSizeMyFontColor字形大小FontColor

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

记录两个设置的重命名createMyToolboxSettingsFileUpgraders函数作为版本更改设置树2mytoolbox

函数升级升级= createMyToolboxSettingsFileUpgraders () = 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

获得版本升级的结果2mytoolbox以确定是否有任何异常发生在升级和所有升级操作是否成功完成。

matlab.settings.loadSettingsCompatibilityResults (“mytoolbox”,“Version2”)
ans = ReleaseCompatibilityResults属性:VersionLabel:“Version2”PreValidationExceptions: [0×0 matlab.settings。ReleaseCompatibilityException)结果:[1×1 matlab.settings.VersionResults]

输入参数

全部折叠

工具箱的升级结果,指定为一个字符或字符串向量。

例子:“mytoolbox”

工具箱版本升级的结果,指定为一个字符或字符串向量。

例子:“version2”

介绍了R2019b