export
将工程导出到存档
说明
export(
将指定的工程导出到名为 proj
,archiveName
)archiveName
的新工程存档文件中。
工程存档会保留工程文件、结构、标签和快捷方式,但不包括任何源代码管理信息。您可以使用工程存档将工程发送给无权访问源代码管理存储库的客户、供应商或同事。收件人可以通过双击工程存档文件从存档中创建新工程。
默认情况下,此函数将所有工程引用打包在存档中。如果工程包含对绝对网络路径的引用,您可能不需要此选项。在本例中,函数会复制工程本身,并在提取时将其视为相对引用。
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);
输入参数
proj
— 工程
matlab.project.Project
对象
工程,指定为 matlab.project.Project
对象。使用 currentProject
从当前加载的工程创建一个工程对象。
archiveName
— 存档文件名或路径
字符向量 | 字符串标量
存档文件名或路径,指定为以文件扩展名 .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)
ArchiveReferences
— 在包中包含引用的选项
true 或 1
(默认值) | false 或 0
在包中包含引用的选项,指定为数值或逻辑值 1
(true) 或 0
(false)。
如果指定 true
,MATLAB 将导出工程并在包中包含引用。提取存档时会创建引用工程的副本,并将它们链接到顶级工程。它还包括被引用工程所引用的工程的一个副本。
如果您指定 false
,则 MATLAB 导出工程时会保留指向引用的现有绝对和相对链接。为了确保在提取存档文件时顶层工程没有缺失引用,引用必须存在于相同的绝对路径和相对路径上。
如果工程没有引用,则该选项不适用。
数据类型: logical
ExportProfile
— 指定导出配置文件名称的选项
'none'(默认值)
指定导出配置文件名称的选项,指定为字符向量或字符串标量。
如果指定,MATLAB 将导出由 ExportProfile
指定的工程文件的子集。导出配置文件不会应用对引用工程的更改。当您共享工程时,MATLAB 会导出整个引用工程。
数据类型: char
| str
Files
— 要导出的文件
字符串数组 | 字符向量元胞数组 | ProjectFile
对象数组
要导出的文件,指定为字符串数组、字符向量元胞数组或 ProjectFile
对象数组。
IgnoreMissingFilesError
— 允许导出缺失文件的工程的选项
false 或 0
(默认值) | true 或 1
忽略缺失文件错误并允许导出缺失文件的工程的选项,指定为数值或逻辑值 1
(true) 或 0
(false)。
数据类型: logical
版本历史记录
在 R2019a 中推出R2024a: 将工程文件列表导出到存档
通过指定 Files
参量,将工程文件列表导出到存档中。
R2024a: 导出有缺失文件的工程
通过将 IgnoreMissingFilesError
设置为 true 启用将有缺失文件的工程导出到存档。
R2023a: 将工程文件的子集导出为存档
通过指定用户定义的导出配置文件,将工程文件的子集导出到存档文件中。
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)