12.2.2. Using the Project menu

The Project menu of the Code window 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:

New Project...

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.

Open Project...

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.

Project Control...

This option 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.

Close Project...

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.

Recent Projects

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.

Project Properties...

Displays the Project Properties window where you can view and change project settings.

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 Managing project properties for details.

Build-Tool Properties...

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.

Add This File to Project

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.

Add Files to Project...

Displays the Select file(s) to Add dialog box to locate 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.

Update Dependencies

Updates dependencies for the active user-defined project. This option is enabled when a user-defined project is open that contains a makefile.

View Project Source files...

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 12.1.

Figure 12.1. Rebuilding an application

Rebuilding an application

Do not try to add any files to your project until this process is complete and the results are visible in the Output pane.

See Managing user-defined projects for examples using the Project menu.

Copyright © 2003, 2004 ARM Limited. All rights reserved.ARM DUI 0234B
Non-Confidential