Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

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

了解弹体工程

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

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

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

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

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

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

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

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

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

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

设置工程文件并打开工程

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

sldemo_slproject_airframe

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

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

注意

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

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

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

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

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

    点击 x 以清除搜索。

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

  5. 要对文件进行排序和自定义列,请点击搜索框最右侧的 Organize view 按钮。

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

打开并运行常用文件

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

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

重新生成 S-Function。

  1. 在工具条中的 Project Shortcuts 选项卡上,点击快捷方式 Rebuild Project's S-functions

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

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

打开顶层模型。

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

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

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

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

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

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

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

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

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

  5. 要查看更改,请右键点击 Modified 文件视图中的 find_top_models 文件,然后选择 Compare > Compare to Ancestor

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

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

  1. 在 Files 视图中,选择 Project (number of files) 选项卡,然后展开 models 文件夹。

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

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

  4. 要查看更改,请选择 Modified (number of files) 选项卡。右键点击修改后的模型文件,然后选择 Compare > Compare to Ancestor

    比较工具打开报告。

运行依存关系分析

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

  1. Project 选项卡的 Tools 部分中,点击 Dependency Analyzer

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

  2. 要突出显示问题文件,请在 Properties 窗格的 Problems 部分中,指向消息 Not in Project,然后点击放大镜图标

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

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

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

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

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

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

    3. 在依存关系分析器工具条的 Impact Analysis 部分中,点击 All Dependencies

运行工程完整性检查

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

有关使用工程检查修复问题的示例,请参阅

提交修改的文件

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

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

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

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

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

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

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

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

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

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

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

相关示例

详细信息