User manual

Project creation and build UM0036
84/385 Doc ID 7705 Rev 11
saved as Build Configurations so that you can easily switch between two or more
configurations.
The name of each build configuration also corresponds to a folder in your project directory
that is created automatically by STVD (for example, the Debug configuration corresponds to
the Debug folder in your project directory). This folder is the default Output directory for your
project and the Intermediate directory for each of your files when you build your application
with the corresponding build configuration.
By default, two configurations are automatically created for each project: Debug and
Release. The Debug configuration applies your toolset’s default settings to produce a
version of your application that is ready to be debugged. The Release configuration applies
your toolset’s default settings to produce an optimized version of your application that is
ready to be programmed to your target microcontroller.
Setting the build configuration
To set the build configuration for your project:
1. Select Build > Configurations.
The project configurations window opens.
2. If your workspace contains more than one project, use the Project list box to select the
project that you want to apply the build configuration to.
3. Select the configuration you want from the list in the Configurations field and then
click on Set Active.
The active configuration is in bold type.
4. Click on Close.
Once you have set the build configuration, you can customize it in the Project Settings
window.
Creating a new build configuration
When you change from one build configuration to another, the Output directory is
automatically changed to designate the appropriate folder. Likewise, the Intermediate
directories for all files are automatically changed to use the corresponding folder, except if
you have manually designated an alternate folder for the Intermediate directory. For more
information, refer to Section 4.10: Configuring folder and file settings on page 156.
To create a new build configuration based on the settings in any of the existing configuration:
1. Select Build > Configurations
2. Click on Add in the New Configuration window
3. Type a name for the configuration
4. In the Copy Settings From field, select the existing configuration to use as the basis
for the new configuration and click on OK.
4.5 Configuring project settings
The Project Settings window provides the standard interface for customizing the build of a
project or specific files within a project. The tabs in the Project Settings window present
commonly used options in menus, list boxes and check boxes. In addition, these tabs
provide fields for entering custom commands and other supported options.