Main Content

Simulink.exportToVersion

导出模型、库或工程，用于 Simulink 的以前版本

全页折叠

语法

exported_file = Simulink.exportToVersion(modelname,target_filename,version)
exported_file = Simulink.exportToVersion(modelname,target_filename,version,Name,Value)
exported_project = Simulink.exportToVersion(proj,zipfilename,version)
exported_project = Simulink.exportToVersion(proj,zipfilename,version,exportReferencedProjects)

说明

示例

exported_file = Simulink.exportToVersion(modelname,target_filename,version) 将模型或库 modelname 以指定的旧版 Simulink® version 能够加载的格式导出到名为 target_filename 的文件中。

如果系统中包含指定的 Simulink 软件版本不支持的功能，此命令将删除该功能，并将任何不支持的模块替换为空的黄色封装子系统模块。因此，转换后的系统可能生成不同的结果。

save_system ExportToVersion 选项是此功能的旧版选项，现在仍然支持。

示例

exported_file = Simulink.exportToVersion(modelname,target_filename,version,Name,Value) 将其他选项指定为一个或多个名称-值对组参数。

示例

exported_project = Simulink.exportToVersion(proj,zipfilename,version) 将工程 proj 以指定的旧版 Simulink version 能够加载的格式导出到 ZIP 文件 zipfilename 中。如果工程包含需求链接文件或者需求文件，Simulink.exportToVersion 会更新链接以指向新导出的文件。

示例

exported_project = Simulink.exportToVersion(proj,zipfilename,version,exportReferencedProjects) 将顶层工程 proj 和所有引用工程以指定的旧版 Simulink version 能够加载的格式导出到 ZIP 文件 zipfilename 中。

示例

全部折叠

获取并导出当前顶层系统。

 Simulink.exportToVersion(bdroot,'mymodel.slx','R2014b');

获取并导出当前顶层系统，将库模块链接替换为已保存的文件中的库模块副本。

Simulink.exportToVersion(bdroot,'mymodel.slx',...
                         'R2014b','BreakUserLinks',true);

获取当前顶层工程并将其导出。

openExample('simulink/AirframeProjectWithReferencesExample')
proj = currentProject;
Simulink.exportToVersion(proj,'myzipfilename','R2019a');

导出当前顶层工程和所有引用工程。

Simulink.exportToVersion(proj,'myzipfilename','R2019a',true);

输入参数

全部折叠

要导出的模型，指定为字符向量或字符串标量，不带任何文件扩展名。该模型必须已加载且未进行过修改。目标文件不能与模型文件相同。

数据类型： char | string

导出的文件名，指定为字符向量或字符串标量。目标文件不能与模型文件相同。

示例： 'mymodel.slx'

数据类型： char | string

要导出的工程，指定为 matlab.project.Project 对象。使用 currentProject 从当前加载的工程创建一个工程对象。

包含导出工程的 ZIP 文件名，指定为字符向量或字符串标量。

示例： 'myzipfile.zip'

数据类型： char | string

MATLAB 不区分大小写的版本名称，指定为字符向量或字符串标量。MATLAB 版本名称指定以前的 Simulink 版本。Simulink.exportToVersion 将系统导出为指定的旧版本 Simulink 能够加载的格式。您最多可以将模型导出到 7 年以前的版本。不能导出到当前版本。

您可以使用后缀 _MDL 或 _SLX 将模型文件格式指定为 SLX 或 MDL。如果不指定格式，将以默认的模型文件格式导出。导出工程时，无法指定模型文件格式。

示例： 'R2015B'

数据类型： char | string

（可选）将引用工程导出为以前的版本，指定为 true 或 false。

如果为 true，Simulink.exportToVersion 将顶层工程和所有引用工程导出为以前的版本，并在 ZIP 文件中包含这些引用。提取 ZIP 文件会创建引用工程的副本，并将它们链接到顶层工程。

如果为 false，Simulink.exportToVersion 仅将顶层工程导出为以前的版本。Simulink.exportToVersion 保留引用的现有绝对和相对链接。对于提取的工作工程，引用必须处于相同的绝对路径和相对路径上。

如果工程没有引用，则会忽略该参数。

名称-值参数

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

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

示例： 'AllowPrompt','off'

允许显示提示或消息对话框，由一个逻辑值指定，该逻辑值指明是在对话框中显示任何输出提示或消息，还是只在命令行中显示消息。例如，提示将文件设为可写入的信息或者有关导出版本的消息。如果您要允许提示，则设置为 true 或 on。

断开用户定义的链接，由一个逻辑值指定，该逻辑值指明函数是否将用户定义的库模块的链接替换为保存的文件中的库模块副本。

断开所有工具箱链接，由一个逻辑值指定，该逻辑值指明函数是否将内置 MathWorks® 库模块的链接替换为保存的文件中的库模块副本。'BreakToolboxLinks' 选项影响 Simulink 库模块以及 MathWorks 工具箱或模块集附带的其他任何库中的模块。

注意

升级到 Simulink 软件的更新版本时，'BreakToolboxLinks' 选项可能导致兼容性问题。例如：

  • 对 Simulink S-Function 的库链接的任何封装不会升级到 S-Function 的新版本。

  • Simulink 库中封装子系统的任何库链接不会升级到新的子系统行为。

  • 任何断开的链接都会阻止自动库转换机制升级该链接。请参阅使用转换表维护库模块的兼容性。

    如果您保存的模型与内置库之间的链接已断开，请使用升级顾问扫描模型中已过期的模块，并将 Simulink 模块升级到最新版本。

输出参数

全部折叠

导出的文件的路径，以指定的旧版 Simulink 能够加载的格式返回。

包含导出工程的 ZIP 文件的路径，以指定的旧版 Simulink 能够加载的格式返回。

限制

Simulink.exportToVersion 不支持将外部测试框架导出到以前的版本。

  • 对于具有外部测试框架的模型，Simulink.exportToVersion 会自动将其转换为内部测试框架。

  • 对于包含具有外部测试框架的模型的工程，Simulink.exportToVersion 导出工程，并将测试框架报告为缺失文件。

版本历史记录

在 R2016a 中推出

另请参阅

主题