主要内容

了解示例工程

此示例打开 Times Table 示例工程来展示工程工具如何帮助您整理您的工程。

打开示例以下载 Times Table App 示例工程并探索如何

  1. 浏览源代码管理下的一些示例工程文件。

  2. 检查工程快捷方式以访问常用的文件和任务。

  3. 分析工程中的依赖关系,并找到工程中尚不存在的必需文件。

  4. 修改一些工程文件,找到和查看修改后的文件,将其与早期版本进行比较,并将修改过的文件提交到源代码管理。

  5. 查看仅包含工程文件的视图、包含修改过的文件的视图,以及包含工程根文件夹下所有文件的视图。

MATLAB desktop shows the Project toolstrip on top and the Project and Source Control panels stacked on the left.

查看、搜索和排序工程文件

“工程”面板显示工程根文件夹下的所有文件。默认情况下,该面板具有工程状态列和标签列。如果工程在源代码管理下,则源代码管理列会显示工程根文件夹中文件的源代码管理状态。

  • 要仅查看状态为“在工程中”的文件,请右键点击空白处并选择过滤 > 仅显示工程文件

  • 要在打开的工程中查找文件和文件夹,请使用“查找文件”面板 Find Files icon

有关详细信息,请参阅管理工程文件

打开并运行常用文件

您可以使用快捷方式在大型工程中更轻松地查找文件。从工程工具条中的 Shortcuts 库查看和运行快捷方式。您可以将快捷方式分组。

Times Table App 工程包含几个快捷方式,包括打开工程需求的快捷方式和运行工程中所有测试的快捷方式。快捷方式使工程用户能够更轻松地找到这些任务。

  • 要执行与快捷方式关联的操作,请在 Shortcuts 库中点击关联的快捷方式。例如,要打开工程需求,请点击需求。要运行测试,请点击运行所有测试

  • 要创建新快捷方式,请在“工程”面板中右键点击文件,然后选择创建快捷方式

有关详细信息,请参阅创建常见任务的快捷方式

将文件夹添加到工程

要将文件夹及其内容添加到工程,请在“工程”面板中右键点击空白处,然后选择新建 > 文件夹。您也可以将现有文件夹粘贴或拖放到“工程”面板中。该文件夹及其内容会自动添加到工程。

为了确保在工程中运行任务时可访问文件,请将工程文件夹添加到工程路径。在“工程”面板中,右键点击文件夹并选择添加到工程路径 > 选定的文件夹和子文件夹

查看已修改文件中的更改

打开文件、进行更改并查看更改。

  1. 在“工程”面板中,在 source 文件夹中,通过双击 timesTableGame.m 文件打开该文件。

  2. 在编辑器中进行更改(例如添加注释),然后保存文件。在“工程”面板中,您可以使用源代码管理列中的蓝色“修改”图标 识别修改后的文件。对于大型工程,使用“源代码管理”面板 Source Control icon 查看修改后的文件。如果源代码管理图标不在边栏中,请点击“打开更多面板”按钮 Open more panels icon 并选择“源代码管理”面板。

  3. 要查看更改,请右键点击 source/timesTableGame.m 并选择源代码管理 > 查看更改。MATLAB 比较工具将打开一个报告,将您的工作副本中的文件修改版与存储在版本控制中的原版进行比较。比较报告类型可能因您选择的具体文件而异。如果选择 Simulink® 模型进行比较,则会打开 Simulink 模型比较报告。

分析依赖关系

要检查所有必需的文件是否都在工程中,请对您的工程运行文件依赖关系分析。

  1. 在工程工具条的工具库中点击依赖关系分析器

  2. 依赖关系图显示工程中所有分析的依赖关系的结构。右窗格列出所需的附加功能和任何问题文件。请注意,没有列出任何问题文件。

现在,删除一个必需的文件。在“工程”面板中,右键点击 source/timesTableGame.m 文件,然后选择从工程中删除。点击“从工程中删除”对话框中的删除

依赖关系分析器会自动更新图和属性窗格中的问题部分。

再次检查是否有问题。

  1. 在依赖关系分析器中的属性窗格中,将鼠标移至问题下的问题消息文件不在工程中,然后点击放大镜 Magnifying glass icon。图会更新以突出显示问题文件 timesTableGame.m

  2. 要查看问题文件的依赖关系,请在影响分析部分中,点击所有依赖关系

现在您已看到问题,请通过将缺失文件放回到工程中来修复问题。右键点击该文件,然后选择添加到工程。下次运行依赖关系分析时,该文件不会显示为问题文件。

运行依赖关系分析后,要调查修改后的文件的依赖关系,请执行影响分析。

  1. 视图部分中,点击源代码管理。图会按源代码管理状态对文件着色。

  2. 在图或文件列表中选择修改的文件。

  3. 要查看修改的文件的依赖关系,请在影响分析部分中,点击所有依赖关系

有关详细信息,请参阅分析工程依赖关系

运行工程完整性检查

为确保您的更改已准备好提交,请检查您的工程。要运行工程完整性检查,请在工程工具条的环境部分中,点击工程问题。在工程问题面板中的检查选项卡中,点击运行检查。这些检查会查找缺失的文件、要添加到源代码管理或从源代码管理检索的文件及其他问题。“问题”面板仅列出失败的检查并尽可能列出自动修复。有关详细信息,请参阅运行工程检查

提交修改的文件

在修改文件并对检查结果满意后,可以提交更改。

  1. 在工程工具条的源代码管理部分中,点击提交。您也可以在“源代码管理”面板中点击提交

  2. 为您的提交输入注释,然后点击提交。源代码管理列中的状态图标将从蓝色变为绿色。在 Git 中,您可以同时拥有本地和远程存储库。这些说明会提交到本地存储库。要提交到远程存储库,请在源代码管理部分中,点击推送

有关在 MATLAB 中使用源代码管理的详细信息,请参阅源代码管理

查看工程和源代码管理信息

要查看和编辑工程详细信息,请在工程工具条中点击设置。然后,查看和编辑工程详细信息,如名称、描述、工程根目录、启动文件夹以及包含生成文件的文件夹的位置。

要查看有关源代码管理集成和存储库位置的详细信息,请在“工程”面板中右键点击空白处并选择源代码管理 > 查看详细信息

关闭工程

要关闭工程,请在工程工具条中点击关闭工程。也可以使用 close 函数。

另请参阅

主题