workbench3.2用户手册学习笔记六

6 Creating User-Defined Projects

6.1 Introduction

User-Defined Projects 假定您作为用户负责设置和维护您自己的构建系统、文件系统内容、makefile 等。用户界面为 user-defined projects 提供以下支持：

• 您可以配置可启动构建实用程序的构建命令。这允许您从工作台GUI开始构建。
• 您可以为构建、重建和清理项目配置不同的规则。
• 您可以在项目资源管理器中创建反映生成文件中规则的生成目标。这允许您直接从“项目资源管理器”中选择和生成任何生成规则。
• 您可以在构建控制台中查看构建输出。

6.2 Creating and Maintaining Makefiles

当你创建用户定义项目时，Workbench 会检查项目资源的根位置是否存在名为 Makefile 的文件。
如果你使用-f make选项在“新建项目向导”的“生成命令”字段中指定不同的文件名，则可以包含子目录的相对或绝对路径。
如果该文件不存在，Workbench 会创建一个带有默认 all 规则和一个 clean 的框架 makefile。这使您可以使用 Build Project、Rebuild Project 和 Clean Project 菜单命令。它还可以防止生成构建错误。 由于您负责维护此 makefile，因此您可以随时将任何其他规则写入其中。
如果您将用户定义的项目基于现有项目，则该项目的 makefile 将复制到新项目的位置，覆盖已存在的任何 makefile。（如有必要，您可以使用 -f make 选项更改新项目的 makefile 的名称，以避免覆盖现有的 makefile。）

6.3 Creating User-Defined Projects

在创建项目之前，请查看 3.4.3 User-Defined Projects, p. 33 中对用户定义项目的描述。

To create a user-defined project, do the following:

1. 选择 File > New > Project。
2. 选择 General > User-Defined Project，然后点击 Next。
3. 选择目标操作系统，然后单击下一步。
4. 键入项目名称，并为其指定一个位置，
5. 点击 Finish。
项目将会出现在项目资源管理器中。

6.4 Configuring User-Defined Projects

创建项目后，您可以配置其构建目标、构建规范和构建宏。

To configure build properties for a project, do the following:

1. 在项目资源管理器中右键单击项目，然后选择属性。
2. 在“属性”对话框中，单击“构建属性”。
注意：不能为用户定义的项目配置构建工具和构建路径。
在 Linux 中，用户定义项目的 makefile 可以使用构建规范中的值来帮助从目标的 sysroot 设置正确的交叉编译工具链和体系结构。
有关更多详细信息，请参阅 9.3 Configuring User-Defined Builds, p. 106 和 9.4 Accessing Build Properties, p. 107，以及按主机的帮助键。

Configuring Build Support

使用 Build Support 选项卡为您的项目配置构建支持。

To configure build support, do the following:

1. 默认情况下构建支持是启用着的。 单击 Disabled 将其禁用，然后单击 User-defined build 以重新启用它。
2. 如有必要，编辑默认的构建命令。
3. 指定是否应将接收到的对象和当前对象传递到下一级。
4. 指定是否应将收到的构建目标传递到下一个级别。
5. 指定 Workbench 应在构建后刷新项目的时间。
   因为整个项目的刷新可能需要一些时间（取决于其大小）Workbench 默认情况下不会这样做。 您可以选择刷新当前项目、当前文件夹、当前文件夹及其子文件夹，或者什么都不刷新。 此选项适用于项目的所有构建运行。
6. 您可以通过选择另一个构建选项卡继续配置您的项目，或者如果您已完成，请单击确定关闭构建属性。

Configuring Build Targets

使用 “构建目标” 选项卡可以配置制作规则并为项目定义自定义构建目标。
在你定义构建目标后，右键单击项目并选择 Build Options 即可使用它。 构建目标会由项目中的每个文件夹继承，无需在每个单独的文件夹中定义相同的构建目标。
这将使得自定义构建目标会不同于您选择 File > New > Build Target 时创建的默认目标，或者是当你在项目创建期间命名的一个构建目标。
默认的构建目标是在定义构建目标的级别上的专用生成规则（无论是项目级别、文件夹级别还是子文件夹级别）。自定义构建目标可以在多个级别上使用，可以作为命令或制作规则。

To configure build targets, do the following:

1. 在 Make rules 部分，在字段中键入所需的制作规则。 当您从 Project 菜单中选择相应的选项或在 Project Explorer 中右键单击您的项目并从上下文菜单中选择它们时，将运行这些规则。
   当您在 Project Explorer 中选择一个文件夹时，Build Folder 和 Clean Folder 选项可用。
2. 要定义自定义构建目标，请单击 New。 The New Custom Build Target 对话框将会打开。
3. 输入构建目标的名称，然后输入 Workbench 应该执行的 make 规则或外部命令。 您也可以单击 Variables 并将变量添加到 make 规则或命令。
   Select Variable 对话框中表示的变量是上下文相关的，并且取决于 Project Explorer 中的当前选择。对于包含文件特定组件的变量，只有在选择文件并且可以评估变量时才会启用相应的目标。没有特定于文件的组件的构建目标会始终启用。
4. 选择类型，无论它是一个 Rule 还是一个 Command。
5. 为生成目标选择一个刷新选项，指定工作台是应该使用项目设置、刷新当前文件夹或项目，还是什么都不做。单击 OK 以关闭该对话框。
6. 通过单击 Edit 或 Rename 来编辑构建目标的选项。 您还可以通过单击列本身来编辑选项（名称除外）。
7. 单击确定关闭构建属性。

Configuring Other Build Options
有关为用户定义的项目配置其他构建选项的信息，请参阅 9. Building Projects 中的以下部分：

• 9.5 Working with Build Specs, p. 108
• 9.6 Configuring Build Macros, p. 110
• 9.7 Configuring Build Paths, p. 111

6.5 Debugging Source

在用户定义的项目中调试源文件时，必须将项目添加到源查找路径。 这样做可确保调试器可以解析断点并查找文件。

To add source lookup settings for a running process, do the following:

1. 在 Debug 视图中,右键单击一个启动配置,一个目标或一个线程。
2. 选择 Edit Source Lookup。将出现 Edit Source Lookup Path 对话框。
3. 点击 Add, 将会出现 Add Source 对话框。
4. 选择 Project 然后点击 OK。
5. 从选择对话框中选择您的项目，然后再次单击确定。
6. 单击向上或向下以调整列表中条目的顺序。源查找容器按照它们在 Source Lookup Path 对话框中出现的顺序进行搜索。
7. 选中 Search for duplicate source files on the path 以强制调试器搜索并显示与给定调试器路径匹配的所有文件，而不是找到一个之后就停止。
有关源查找路径的更多信息，请打开 Edit Source Lookup Path对话框并按主机的帮助键。