6.1.2. Project properties

When you create a project, RealView Debugger sets up default project settings, called Project Properties. These settings include project information and build options that you can modify. The project properties are stored in project files that have the .prj file extension. A project file is located in the directory you specify when you create a project.

You can access the Project Properties for your project using a Project Properties window. For more details on accessing the Project Properties, and how to modify them, see the chapter that describes managing projects in the RealView Debugger v1.8 Project Management User Guide.

For more information about the compilation tool options used to implement the project build options, see Setting up project build options for the basic compilation tasks and the compilation tools documentation.

Build target configurations for Standard and Library projects

When you create a Standard or Library project, RealView Debugger automatically opens a Project Properties window, and sets up default build target configurations, Debug, DebugRel, and Release. You can delete these build target configurations and create create your own as required. However, for the purposes of this tutorial, it is suggested that you use the default configurations.

The build-related groups also include special child groups corresponding to each of the build target configurations. These are identified by a key symbol and the configuration name (see Figure 6.1).

Figure 6.1. Build target configuration child groups

Build target configuration child groups

Each build target configuration can have different values for the build settings, but only one configuration is active for a project. For example, you might want to set up and use the Debug and Release configurations to build images for debugging and final release.

Any setting that is not in one of the child groups is a global settings that is used for all build target configurations. You can move or copy settings to any of these child groups:

  • If you move a global setting to a build target configuration group, the current value for that setting is used only for that build target configuration. Any other build target configurations use the default value for the setting.

  • If you copy a global setting to a build target configuration group, you can change the copied setting to a configuration-specific value. Any other build target configurations use the global value for the setting.

The first time you close the Project Properties window after creating a Standard or Library project, RealView Debugger creates a build directory and makefile for each build target configuration defined for the project.

Note

If a makefile and directory for the active build target configuration does not already exist when you build a project, RealView Debugger displays a prompt stating that the makefile does not exist. Click Yes at the prompt dialog. RealView Debugger creates the makefile and directory for the active build target configuration, then performs the build.

See the chapter that describes managing projects in the RealView Debugger v1.8 Project Management User Guide for more details on build target configurations.

Preprocessing and post-processing commands

Standard and Library projects also enable you to specify other preprocessing and post-processing commands. For example, after RealView Debugger has built an image, you can set up a fromelf command that the project build process is to use to convert the image to a binary ROM image.

Copyright © 2002-2005 ARM Limited. All rights reserved.ARM DUI 0181G
Non-Confidential