User manual

UM0036 Project creation and build
Doc ID 7705 Rev 11 157/385
When settings are available you can configure the following:
● Always use custom build step: Checking this box allows you to access the Custom
Build tab, where you can enter your own commands and options for building this file
(see Section 4.10.2: Custom build tab on page 157).
● Exclude file from build: Checking this box will exclude this file or folder when you build
your project. When you check this box, all other tabs disappear.Only the General tab is
available.
● Intermediate directory: This field allows you to specify the path name for the folder
where intermediate files from the compiler or assembler will be stored. If you do not
specify an intermediate directory to use for a file or folder, then intermediate files are
stored in your project’s Output Directory by default (see Section 4.5.1: General
settings tab on page 85). You can type the path name of a directory you have created,
or use the browse button to locate it.
Note: Specifying an intermediate directory may be necessary if you have two or more source files
in different directories with the same name. In this case, the default mechanism for naming
intermediate files results in identical filenames. When output to the same default directory,
the last intermediate file generated will replace any previously generated file with the same
name.
4.10.2 Custom build tab
The custom build feature allows you to specify your own commands (based on your toolset)
to build your application. Custom build commands override any standard settings that you
may have applied using the standard project settings interface. Only those custom
commands which you have specified are performed during the build.
This file provides the following features:
Description field: Here you can enter a description that will appear in the Build tab of the
Output window, to help you identify when your custom build command is being executed
and view any related messages or errors.
Commands field: Here you enter the commands to be executed during the build using the
syntax and options specific to your toolset.
Directory button: Click on this button for a list of commonly used macros to help you identify
directories and path name to use during the build. Select the macro from the list and it is
automatically added at the cursor’s position in the Commands field.
Files button: Click on this button for a list of commonly used macros to help define filenames
and extensions to use during the build. Select the macro from the list and it is automatically
added at the cursor’s position in the Commands field.
Dependencies button: Click on this button to open the User Defined Dependencies
window. In this window, you can specify the dependencies for custom building of the
selected source file. To add files as dependencies, click on the file icon and type the path
name, or browse to find the file. Change the order of the files in the list by using the up and
down arrow buttons. Once you have entered the dependencies click on OK.
Note: This option is only available in the Custom Build tab for files, not folders.