本页采用了机器翻译。点击此处可查看最新英文版本。

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,Name=Value)

说明

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,Name=Value) 根据一个或多个 Name=Value 参量指定的条件导出工程。您可以使用此语法来导出引用的工程和丢失的文件。

R2025a 之前的版本不支持超过 63 个字符的文件名。如果您尝试将包含超过 63 个字符的文件名的工程导出到 R2025a 之前的版本，该函数将列出具有长名称的工程文件。在导出到以前的版本之前，缩短名称并替换工程中对文件名的所有引用。

示例

示例

全部折叠

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

 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",IncludeReferences=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

名称-值参数

全部折叠

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

示例: Simulink.exportToVersion(bdroot,"mymodel.slx",... "R2014b",BreakUserLinks=true);

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

将引用的工程导出到以前版本的选项，指定为数值或逻辑 1 (true) 或 0 (false)。

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

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

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

将工程导出到以前的版本时忽略丢失的工程文件的选项，指定为数值或逻辑 1 (true) 或 0 (false)。

如果为真，Simulink.exportToVersion 不会在导出过程中发出与缺少工程文件相关的错误。

如果为假，Simulink.exportToVersion 在检测工程中缺少文件时会发出错误。

输出参量

全部折叠

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

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

限制

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

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

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

版本历史记录

在 R2016a 中推出

全部展开

另请参阅

主题