export

将工程导出到存档

全页折叠

语法

export(proj,archiveName)
export(proj,Name=Value)

说明

export(proj,archiveName) 将指定的工程导出到名为 archiveName 的新工程存档文件中。

export 函数运行依赖关系分析以确定要包含在存档中的所有必需文件。工程存档会保留工程文件、结构、标签和快捷方式，但不包括任何源代码管理信息。您可以使用工程存档将工程发送给无权访问源代码管理存储库的客户、供应商或同事。收件人可以通过双击工程存档文件从存档中创建新工程。

默认情况下，export 函数将所有工程引用打包在存档中。如果工程包含对绝对网络路径的引用，您可能不需要此选项。在本例中，函数会复制工程本身，并在提取时将其视为相对引用。

示例

export(proj,Name=Value) 将指定的工程导出为一个新工程存档文件，且可使用一个或多个名称-值参量指定其他选项。使用此语法从存档中省略工程引用，指定导出配置文件等。

示例

示例

全部折叠

打开 Times Table App 工程。使用 currentProject 从当前加载的工程创建一个工程对象。

openExample("matlab/TimesTableProjectExample")
proj = currentProject;

将工程导出到存档工程文件。

export(proj,"timestableproj.mlproj");

您现在可以通过共享文件 timestableproj.mlproj 来发送工程。

打开要导出的工程，并创建一个工程对象。

proj = openProject("myProject.prj");

使用名为 excludetests 的用户定义的导出配置文件导出工程文件的子集。请参阅 创建导出配置文件。

export(proj,"myProjectArchive.mlproj",ExportProfile="excludetests");

打开工程并创建一个工程对象。

proj = openProject("myProject.prj");

导出文件 mymodel.slx 所需的所有文件。

requiredFiles = listRequiredFiles(proj,"mymodel.slx");
export(proj,"myModelDependencies.mlproj",Files=requiredFiles);

输入参数

全部折叠

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

存档文件名或路径，指定为以文件扩展名 .mlproj 或 .zip 结尾的字符向量或字符串标量。如果不指定扩展名，MATLAB® 会将 .mlproj 扩展名追加到文件名。

如果 archiveName 是文件名，MATLAB 将该文件导出到当前文件夹。您也可以指定完全限定的路径名称。

示例: "projectArchive.mlproj"

名称-值参数

全部折叠

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

示例: export(proj,"archivewithnoReferences.mlproj",ArchiveReferences=false)

如果使用的是 R2021a 之前的版本，请使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: export(proj,"archivewithnoReferences.mlproj","ArchiveReferences",false)

在包中包含引用的选项，指定为数值或逻辑值 1 (true) 或 0 (false)。

如果指定 true，MATLAB 将导出工程并在包中包含引用。提取存档时会创建引用工程的副本，并将它们链接到顶级工程。它还包括被引用工程所引用的工程的一个副本。

如果您指定 false，则 MATLAB 导出工程时会保留指向引用的现有绝对和相对链接。为了确保在提取存档文件时顶层工程没有缺失引用，引用必须存在于相同的绝对路径和相对路径上。

如果工程没有引用，则该选项不适用。

数据类型: logical

指定导出配置文件名称的选项，指定为字符向量或字符串标量。

如果指定，MATLAB 将导出由 ExportProfile 指定的工程文件的子集。导出配置文件不会应用对引用工程的更改。当您共享工程时，MATLAB 会导出整个引用工程。

数据类型: char | str

要导出的文件，指定为字符串数组、字符向量元胞数组或 ProjectFile 对象数组。

忽略缺失文件错误并允许导出缺失文件的工程的选项，指定为数值或逻辑值 1 (true) 或 0 (false)。

数据类型: logical

版本历史记录

在 R2019a 中推出

全部展开

另请参阅

|

主题