Simulink.exportToVersion

R2026b

导出模型、库或工程，用于 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) 将指定的模型或库导出到指定版本的 Simulink^®，采用该版本可以加载的格式。

如果系统中包含指定的 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 之前的版本，该函数将列出具有长名称的工程文件。请缩短名称并替换工程中对该文件名的所有引用，然后导出到以前的版本。

示例

全部折叠

将模型导出到以前的版本

将当前顶层系统导出到 R2022b。

 Simulink.exportToVersion(bdroot,"mymodel.slx","R2022b");

将模型导出到以前的版本并断开链接

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

Simulink.exportToVersion(bdroot,"mymodel.slx",...
                         "R2023b",BreakUserLinks=true);

将工程及引用导出到以前版本

将当前顶层工程导出到 R2023a。

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

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

Simulink.exportToVersion(proj,"myzipfilename","R2024a",IncludeReferences=true);

输入参数

全部折叠

`modelname` — 要导出的模型
模型名称

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

数据类型: string | character vector

`target_filename` — 导出的文件的名称
字符串 | 字符向量

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

示例: "myExportedModel.slx"

`proj` — 要导出的工程
`matlab.project.Project` 对象

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

`zipfilename` — 导出的 ZIP 文件
字符串 | 字符向量

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

示例: "myExportedProject.zip"

`version` — MATLAB^® 发行版
版本号

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

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

示例: "R2015B"

数据类型: string | character vector

名称-值参数

全部折叠

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

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

`AllowPrompt` — 显示提示或消息对话框
`false` (默认) | `true` | `"on"` | `"off"`

在对话框中显示任何输出提示或消息或仅在命令行中显示消息的选项，指定为逻辑值。例如，选择显示提示以将文件设为可写入的信息或者有关导出版本的消息。要显示提示，请指定 true 或 "on"。要隐藏提示，请指定 false 或 "off"。

数据类型: string | character vector | logical

`BreakUserLinks` — 断开用户定义库模块的链接
`false` (默认) | `true` | `"on"` | `"off"`

断开用户定义库模块的链接并用保存文件中的库模块副本替换这些链接的选项，指定为逻辑值。要开启该选项，请指定 true 或 "on"。要关闭该选项，请指定 false 或 "off"。

数据类型: string | character vector | logical

`BreakToolboxLinks` — 断开所有工具箱链接
`false` (默认) | `true` | `"on"` | `"off"`

断开所有工具箱链接并用保存文件中内置 MathWorks^® 库模块的副本替换这些库模块的链接的选项，指定为逻辑值。要开启该选项，请指定 true 或 "on"。要关闭该选项，请指定 false 或 "off"。

'BreakToolboxLinks' 选项影响 Simulink 库模块以及 MathWorks 工具箱或模块集附带的其他任何库中的模块。

注意

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

对 Simulink S-Function 的库链接的任何封装不会升级到 S-Function 的新版本。
Simulink 库中封装子系统的任何库链接不会升级到新的子系统行为。
任何断开的链接都会阻止自动库转换机制升级该链接。请参阅使用转换表维护库模块的兼容性。
如果您保存的模型与内置库之间的链接已断开，请使用升级顾问扫描模型中已过期的模块，并将 Simulink 模块升级到最新版本。

数据类型: string | character vector | logical

`IncludeReferences` — 将引用工程导出为以前的版本
`false` 或 `0` (默认) | `true` 或 `1`

将引用工程导出到以前版本的选项，指定为逻辑值。要开启该选项，请指定 true 或 1。要关闭该选项，请指定 false 或 0。

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

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

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

数据类型: logical

`AllowMissingFiles` — 导出到 Simulink 的以前版本时忽略缺失工程文件
`false` 或 `0` (默认) | `true` 或 `1`

将工程导出到以前版本时忽略缺失工程文件的选项，指定为逻辑值。要开启该选项，请指定 true 或 1。要关闭该选项，请指定 false 或 0。

当该选项开启时，Simulink.exportToVersion 在导出过程中不会发出与丢失的工程文件相关的错误。

当该选项关闭时，Simulink.exportToVersion 在检测到工程中丢失文件时会发出错误。

数据类型: logical

输出参量

全部折叠

`exported_file` — 导出的文件
文件路径

导出文件的文件路径，以字符向量形式返回。

数据类型: character vector

`exported_project` — 包含导出工程的 ZIP 文件
文件路径

包含导出工程的 ZIP 文件的文件路径，以字符向量形式返回。

数据类型: character vector

限制

Simulink.exportToVersion 不支持将外部测试框架导出到以前的版本。
- 对于具有外部测试框架的模型，Simulink.exportToVersion 会自动将其转换为内部测试框架。
- 对于包含具有外部测试框架的模型的工程，Simulink.exportToVersion 导出工程，并将测试框架报告为缺失文件。
Simulink.exportToVersion 不支持导出存储在数据字典或引用字典中的配置。因此，导出的数据字典不包含在原始数据字典中存储的配置。

版本历史记录

在 R2016a 中推出

全部展开

R2025a: 将工程导出到以前版本时忽略缺失文件

从 R2025a 开始，您可以通过将 AllowMissingFiles 参量设置为 true，在将工程导出到以前版本时忽略缺失的工程文件。

R2025a: 使用 Name=Value 参量导出引用工程

在 R2025a 中，使用位置参量导出引用工程会发出警告。请改用 Name=Value 参量。

Simulink.exportToVersion(proj,"myzipfilename","R2019a",IncludeReferences=true);

R2022a: 将工程及引用导出到以前版本

从 R2022a 开始，您可以将整个工程及所有引用工程导出到以前版本。有关详细信息，请参阅将工程及引用导出到以前版本。

R2021b: 将工程导出到以前版本

从 R2021b 开始，您可以将整个工程导出到以前版本。有关详细信息，请参阅将工程及引用导出到以前版本。

另请参阅

save_system

主题

保存模型

Simulink.exportToVersion

语法

描述

示例

将模型导出到以前的版本

将模型导出到以前的版本并断开链接

将工程及引用导出到以前版本

输入参数

modelname — 要导出的模型 模型名称

target_filename — 导出的文件的名称 字符串 | 字符向量

proj — 要导出的工程 matlab.project.Project 对象

zipfilename — 导出的 ZIP 文件 字符串 | 字符向量

version — MATLAB® 发行版 版本号

名称-值参数

AllowPrompt — 显示提示或消息对话框 false (默认) | true | "on" | "off"

BreakUserLinks — 断开用户定义库模块的链接 false (默认) | true | "on" | "off"

BreakToolboxLinks — 断开所有工具箱链接 false (默认) | true | "on" | "off"

IncludeReferences — 将引用工程导出为以前的版本 false 或 0 (默认) | true 或 1

AllowMissingFiles — 导出到 Simulink 的以前版本时忽略缺失工程文件 false 或 0 (默认) | true 或 1

输出参量

exported_file — 导出的文件 文件路径

exported_project — 包含导出工程的 ZIP 文件 文件路径

限制

版本历史记录

R2025a: 将工程导出到以前版本时忽略缺失文件

R2025a: 使用 Name=Value 参量导出引用工程

R2022a: 将工程及引用导出到以前版本

R2021b: 将工程导出到以前版本

另请参阅

主题

`modelname` — 要导出的模型
模型名称

`target_filename` — 导出的文件的名称
字符串 | 字符向量

`proj` — 要导出的工程
`matlab.project.Project` 对象

`zipfilename` — 导出的 ZIP 文件
字符串 | 字符向量

`version` — MATLAB^® 发行版
版本号

`AllowPrompt` — 显示提示或消息对话框
`false` (默认) | `true` | `"on"` | `"off"`

`BreakUserLinks` — 断开用户定义库模块的链接
`false` (默认) | `true` | `"on"` | `"off"`

`BreakToolboxLinks` — 断开所有工具箱链接
`false` (默认) | `true` | `"on"` | `"off"`

`IncludeReferences` — 将引用工程导出为以前的版本
`false` 或 `0` (默认) | `true` 或 `1`

`AllowMissingFiles` — 导出到 Simulink 的以前版本时忽略缺失工程文件
`false` 或 `0` (默认) | `true` 或 `1`

`exported_file` — 导出的文件
文件路径

`exported_project` — 包含导出工程的 ZIP 文件
文件路径