Main Content

通过一个弹体工程来了解工程工具

了解弹体工程

用示例工程作为尝试,了解这些工具如何帮助您组织工作。工程可以帮助您管理:

  • 您的设计(模型和库文件、.m.mat 及其他文件、S-Function 的源代码和数据)

  • 用于您的工程的一组操作(运行设置代码、打开模型、仿真、编译和运行关闭代码)

  • 操作源代码管理下的文件(签出、比较修订版、标记或标签和签入)

本弹体示例将说明如何完成以下工作:

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

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

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

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

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

设置工程文件并打开工程

运行以下命令以创建工程文件的工作副本并打开工程:

openExample('simulink/AirframeProjectExample')

工程示例将文件复制到您的临时文件夹,以便您可以编辑它们并将其置于 Git™ 源代码管理下。

Project 窗口将打开,并加载工程。该工程被配置为运行一些启动任务,包括将当前工作文件夹更改为工程根文件夹。

注意

您也可以通过指定 openExample('simulink/UsingAProjectWithSVNExample') 使用 SVN 源代码管理来尝试此示例工程。以下示例说明使用 Git 时的选项。

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

  1. 在 Project 中,查看文件视图以管理工程中的文件。当工程(文件数) 视图处于选中状态时,仅显示您的工程中的文件。

  2. 要查看沙盒中的所有文件,请点击全部。此视图将显示工程根文件夹下的所有文件,而不仅是工程中的文件。此视图可用于将文件从您的沙盒中添加到工程。

  3. 要查找特定的文件或文件类型,请在任何文件视图中,在搜索框中键入内容或点击“过滤器”按钮。您还可以在文件内搜索。

    点击 x 以清除搜索。

  4. 要以列表而不是树形式来查看文件,请使用“布局”控制项。

  5. 要对文件进行排序和自定义列,请点击搜索框最右侧的“整理视图”按钮。

  6. 您可以将 Project 停靠在 MATLAB® 桌面中或取消停靠。如果要最大化查看工程文件的空间,请取消停靠 Project。拖动标题栏可将其取消停靠。

打开并运行常用文件

您可以使用快捷方式使用户更容易在大型工程中找到脚本。在工程快捷方式工具条上查看和运行快捷方式。您可以将快捷方式分组。

在本示例中,重新生成 S-Function 的脚本被设置为快捷方式,以便工程的新用户可以轻易找到它。您还可以让用户更便捷地找到工程内的顶层模型或其他模型。在此示例中,顶层模型 slproject_f14.slx 是一个快捷方式。

重新生成 S-Function。

  1. 在工具条中的“工程快捷方式”选项卡上,点击快捷方式重新编译工程的 S-Function

    快捷方式文件会编译一个 MEX 文件。如果您尚未设置编译器,请按照说明选择编译器。

  2. 打开 rebuild_s_functions.m 文件以了解它的工作原理。

打开顶层模型。

  • 在“工程快捷方式”选项卡上,点击快捷方式 F14 模型以打开此工程的根模型。

  • 要创建用于访问常用文件的快捷方式,请选择文件视图,右键点击一个文件,然后选择创建快捷方式

您还可以指定要在启动和关闭时运行的文件。请参阅Automate Startup Tasks

查看在修改过的文件中的更改

打开并更改文件,然后查看更改。

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

  2. 双击以从工程打开 find_top_models 文件进行编辑,或右键点击并选择打开

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

  4. 在工程的“文件”视图中,选择选项卡已修改(文件数)。编辑文件后,您会看到已修改 (2)。您更改的文件显示在列表中。您编辑了 utilities 文件夹中的一个文件。注意“修改的文件”列表还包含 resources 文件夹。存储在 resources 文件夹中的文件是由您的更改生成的内部工程定义文件。工程定义文件允许您通过创建快捷方式、添加标签和添加工程描述等方式向文件添加元数据。工程定义文件还定义添加到工程中的文件。您可以像审核任何其他工程文件一样,审核工程定义文件修订中的更改。请参阅Project Definition Files

  5. 要查看更改,请右键点击已修改文件视图中的 find_top_models 文件,然后选择比较 > 与前代比较

    MATLAB 比较工具打开报告,将您的沙盒中的文件修改版与存储在版本管理工具中的原版进行比较。比较报告类型可能因您选择的具体文件而异。如果您选择一个 Simulink® 模型来执行比较 > 与前代比较,则此命令将运行 Simulink 模型比较。

要比较模型,请尝试以下示例。

  1. 在“文件”视图中,选择工程(文件数) 选项卡,然后展开 models 文件夹。

  2. 双击以从工程打开 AnalogControl 文件进行编辑,或右键点击并选择打开

  3. 在模型中进行更改,例如打开模块并更改一些参数,然后保存模型。

  4. 要查看更改,请选择已修改(文件数) 选项卡。右键点击修改后的模型文件,然后选择比较 > 与前代比较

    比较工具打开报告。

运行依存关系分析

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

  1. 工程选项卡上,点击向下箭头以展开工具库。在 App 下,点击依存关系分析器

    依存关系图显示工程中所有分析的依存关系的结构。属性窗格列出必需的产品、附加功能和任何问题文件。

  2. 要突出显示问题文件,请在属性窗格的问题部分中,指向消息文件不在工程中,然后点击放大镜图标

  3. 选择依存关系箭头以检查依存关系类型。timesthree.mexw64f14_airframe.slx 要求的 S-Function 二进制文件。您可以向工程添加二进制文件,或者就像在此工程中,提供用于从工程中的源代码重新生成二进制文件的实用工具脚本。

  4. 要从问题文件列表中删除文件,请右键点击该文件,然后选择隐藏警告。下次运行依存关系分析时,该文件不会显示为问题文件。

    在此示例中,您不想将二进制文件添加到工程中,而是使用脚本从工程中的源代码重新生成二进制文件。使用隐藏警告停止将此类文件标记为问题。

  5. 查看修改后的文件的依存关系。

    1. 在依存关系分析器工具条的视图部分中,点击源代码管理。现在,图中每个文件的颜色表示其源代码管理状态。

    2. 在依存关系图中,选择修改的文件。要选择多个文件,请按住 Shift 并点击文件。

    3. 在依存关系分析器工具条的影响分析部分中,点击所有依存关系

运行工程完整性检查

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

提交修改的文件

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

  1. 在“文件”视图中,选择已修改(文件数) 选项卡。您更改的文件显示在列表中。

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

  3. 输入您的提交注释,然后点击提交

    在源代码管理提交您的更改时查看状态栏中的消息。Git 提交到您的本地存储库。要提交到远程存储库,请在“源代码管理”部分中使用推送。请参阅使用 Git 拉取、推送和提取文件

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

  • 要查看和编辑工程详细信息,请在工程选项卡的环境部分中,点击详细信息。查看和编辑详细信息,例如名称、描述、工程根目录、启动文件夹和生成的文件的文件夹(如 slprj 文件夹)。

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

也可以使用工程 API 获取当前工程:

project = currentProject;
您可以使用工程 API 来获取所有工程详细信息并在命令行操作该工程。请参阅 currentProject

有关后续步骤,请参阅工程管理

相关示例

详细信息