| |||
| Home > Working with Projects > Using the Project menu > Menu options | |||
The Project menu (shown in Figure 2.1) contains project control commands to create projects, redefine project settings, and control access to projects during your debugging session. Some options in the Project menu are not available unless at least one project is open or a source file is visible in the File Editor pane.
The options available are:
Displays the Create New Project dialog box where you can create a new user-defined project. See Common steps for creating a user-defined project for details.
Displays the Select Project to Open dialog box where you can
locate a user-defined project to open. A user-defined project is
saved with the .prj extension.
You can also open a user-defined project by dragging the appropriate project
settings file, with the .prj extension, from
Windows Explorer and dropping it into the File Editor pane.
You can also open a project from the Recent Projects list.
Displays the Project Control dialog box where you specify actions to perform on one or more open projects. See Using the Project Control dialog box for details.
Closes an open project. When two or more projects are open, a list selection box is displayed for you to choose which project or projects to close.
Displays a list of up to nine user-defined projects that you have used in this or previous debugging sessions. On first opening RealView Debugger, this option is grayed out. Each project you create is added to this list, and the list is saved in your start-up file.
Displays the Project Properties window where you can view and change project settings.
You can also display the Project Properties window by selecting Debug ? Set Source Search Path....
The project properties are saved in the project settings file
(*.prj or *.axf.apr).
The entries are populated when you first create the project, but
you can amend them as required. If you load an image directly, you can
use this option to access project properties for the associated auto-project,
created by RealView Debugger. See Chapter 5 Using the Project Properties Window for details.
Displays the Build-Tool Properties window to enable you to specify the location of development tools accessible to RealView Debugger for building. This option is not used for auto-projects.
It is recommended that you define the build tools before creating your first project. See Managing your build tools for details.
Adds the source file that is currently selected in the File Editor pane to the active user-defined project. This option is enabled when a source file is selected in the File Editor pane and a user-defined Standard or Library project is open.
For Custom projects, you must edit your own makefile to add files.
Displays the Select file(s) to Add dialog box to enable you to select one or more source files to add to the active user-defined project. You can also select files from your personal favorites list. This option is enabled when one or more user-defined Standard or Library projects are open.
For Custom projects, you must edit your own makefile to add files to the project.
Updates dependencies for the active user-defined project. This option is enabled when a user-defined project is open that contains a makefile.
Displays the Project Source View selection box. The display list shows those source files defined in the makefile for the active user-defined project. Select a source file from the list and click Edit to open the file in the File Editor pane. This option is enabled when a user-defined project is open that contains a makefile.
You can also view source files for a project using the Process Control pane. See Managing projects in the Process Control pane for details.
If you select certain options from the Project menu, for example Add Files to Project... or Update Dependencies, the project makefile is regenerated. When this happens, the Output pane switches to the Build tab and displays details about the makefile creation process, shown in Figure 2.2.
Do not try to add any files to your project until this process is complete and the results are visible in the Output pane.