Main Content

export

将工程导出到存档

自 R2019a 起

说明

示例

export(proj,archiveName) 将指定工程导出到名为 archiveName 的新工程存档文件中。archiveName 必须包含 .mlproj 扩展名或无任何扩展名。如果 archiveName 不包含 .mlproj 扩展名,则 MATLAB® 会将其追加到文件名之后。

工程存档会保留工程文件、结构、标签和快捷方式,但不包括任何源代码管理信息。您可以使用工程存档将工程发送给无权访问源代码管理存储库的客户、供应商或同事。收件人可以通过双击工程存档文件从存档中创建新工程。

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

示例

export(proj,Name,Value) 使用由一个或多个名称-值参数指定的附加选项将指定的工程导出为一个新工程存档文件。

示例

全部折叠

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

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

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

export(proj,"timestableproj.mlproj")

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

打开您要导出的工程。使用 currentProject 从当前加载的工程创建一个工程对象。

openProject("myProject.prj");
proj = currentProject;

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

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

输入参数

全部折叠

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

存档文件名或路径,指定为以文件扩展名 .mlproj 结尾的字符向量或字符串标量。如果未指定扩展名,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)

在包中包含引用的选项,指定为 truefalse

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

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

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

数据类型: logical

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

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

数据类型: char | str

版本历史记录

在 R2019a 中推出

全部展开