Main Content

本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

了解示例工程

此示例通过 Times Table App 示例工程来展示工程工具如何帮助您整理您的工程。

使用 Times Table App 示例,我们将了解如何:

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

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

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

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

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

设置示例文件

创建 Times Table App 示例工程文件的工作副本并打开该工程。MATLAB® 将这些文件复制到示例文件夹中以便您编辑它们。该工程将文件置于 Git™ 源代码管理下。

matlab.project.example.timesTable

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

您可以使用文件视图查看、搜索工程文件和对其排序。

要查看工程中的文件,请在文件视图中,点击工程 (number of files)。如果选择此视图,将仅显示您的工程中的文件。

要查看工程文件夹中的所有文件,请点击全部。此视图将显示工程根文件夹下的所有文件,而不仅是工程中的文件。因此,此视图对于向工程添加文件非常有用。

要以列表而不是树的形式查看文件,请在文件视图右上角的布局字段中,选择列表

有几种方法可以在工程中查找文件和文件夹:

  • 要按名称搜索特定文件或文件类型,请在任何文件视图的搜索框中键入内容或点击筛选器按钮。例如,在搜索字段中,输入文本 timestable。工程会返回包含单词 timestable 的所有文件和文件夹。点击 以清除搜索。

  • 要搜索文件内容,请转至工程选项卡,然后点击搜索按钮。在搜索字段中输入值,然后按 Enter 键。例如,输入单词 tests。工程将显示包含单词 tests 的所有文件和文件夹。点击 以清除搜索。

  • 要更改文件的分组或排序方式以及自定义列,请点击操作 按钮并从可用选项中进行选择。

打开并运行常用文件

您可以使用快捷方式在大型工程中更轻松地查找文件。在工程快捷方式选项卡上查看并运行快捷方式。您可以将快捷方式分组。

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

要执行某项操作,请在工程快捷方式选项卡上,点击关联的快捷方式。例如,要打开工程需求,请点击文档 > 需求。要运行测试,请点击测试 > 运行所有测试

要创建新快捷方式,请选择文件视图,右键点击文件,然后选择创建快捷方式

将文件夹添加到工程

创建一个新文件夹并将其添加到工程路径中。将工程文件夹添加到工程路径可确保工程的所有用户都能访问其中的文件。

  1. 选择文件视图。

  2. 右键点击空白区域,然后选择新建 > 文件夹。输入文件夹的名称。该文件夹会自动添加到工程中。

  3. 右键点击新文件夹,然后选择工程路径 > 添加到工程路径(包括子文件夹)

查看已修改文件中的更改

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

  1. 选择文件视图。使用树布局查看文件夹,然后展开 utilities 文件夹。

  2. 右键点击 source/timesTableGame.m,然后选择打开

  3. 在编辑器中进行更改(例如添加注释),然后保存文件。

  4. 文件视图中,选择已修改 (number of files) 选项卡。编辑文件后,您会看到已修改 (2)。您更改的文件将显示在列表中。

  5. 要查看更改,请在已修改文件视图中右键点击 source/timesTableGame.m,然后选择比较 > 与父级比较。MATLAB 比较工具将打开一个报告,将您的沙盒中的文件修改版与存储在版本控制中的原版进行比较。比较报告类型可能因您选择的具体文件而异。如果选择 Simulink® 模型来进行比较,此命令将运行 Simulink 模型比较。

* 注意 - 当您打开 Times Table App 示例工程时,该工程会在 resources 文件夹中显示修改后的文件。这是打开示例工程的副作用。在您自己的工程中编辑文件时,只有影响文件元数据的更改(例如向文件添加标签)才会在 resources 文件夹中创建修改后的文件。

分析依存关系

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

  1. 工程选项卡上,点击依存关系分析器

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

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

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

再次检查是否有问题。

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

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

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

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

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

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

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

运行工程完整性检查

为确保您的更改已准备好提交,请检查您的工程。在工程选项卡上,点击运行检查以运行工程完整性检查。这些检查会查找缺失的文件、要添加到源代码管理或从源代码管理检索的文件及其他问题。“检查”对话框提供自动修复发现的问题的功能(如果可能的话)。当您点击“检查”对话框中的详细信息按钮时,可以查看推荐的操作并决定是否进行更改。

提交修改的文件

修改文件并对检查结果满意后,可以将更改提交到源代码管理存储库。

  1. 在文件视图中,选择已修改 (number of files) 选项卡。您更改的文件会显示在列表中。

  2. 要将更改提交到源代码管理,请在工程选项卡上的源代码管理部分中,点击提交

  3. 为您的提交输入注释,然后点击提交。在源代码管理提交您的更改时查看状态栏中的消息。在 Git 中,您可以同时拥有本地和远程存储库。这些说明会提交到本地存储库。要提交到远程存储库,请在源代码管理部分中,点击取回

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

要查看和编辑工程详细信息,请在工程选项卡上的环境部分中,点击详细信息。查看和编辑工程详细信息,如名称、说明、工程根目录、启动文件夹以及包含生成文件的文件夹的位置。

要查看有关源代码管理集成和存储库位置的详细信息,请在工程选项卡上的源代码管理部分中,点击 Git 详细信息。Times Table App 示例工程使用 Git 源代码管理。

关闭工程

点击 (位于工程窗口的右上角)以关闭工程。

proj = currentProject;
close(proj);

相关主题