Build Rules Configuration dialog
The Build Rules Configuration dialog allows you to define build and link rules, execution commands, and environment variables for a language, such as Genero or Java.
The integrated Toolbar allows for adding, duplicating, and deleting languages.
If you delete a language, only the rules and variables of the current editable level are deleted. For example, if you are editing the language from Project Manager, this action deletes only the project rules and variables. If the language is empty, this action removes the language.
The tabs are used to manage the build, link, and execution rules, as well as the environment variables.
Build tab
The Build Rules List includes the build rules Default, Template, Global, and Project build rules for the selected language. The integrated Toolbar allows for adding, duplicating, deleting and editing build rules.
- Add a build rule
- Select the Global category (Preferences only) or Project category (Project Manager only) and click this icon to add a custom rule. See Add/Edit a build rule.
- Duplicate selected build rule
- Select an existing rule and click this icon; the Build rule is added to the appropriate category. Select the newly added rule and click the Edit icon to modify the duplicated rule.
- Delete a selected build rule
- Select an existing rule and click this icon to remove it.
- Edit a selected build rule
- Select a custom Build rule and click this icon to modify the Build Rule fields. See Add/Edit a build rule.
Link tab
A link rule is executed when you build an application or library node.
- Command lines
- Commands that will be executed during the linking of an application / library node. See Command line options for build, link, execution rules
- Output files
- List of files generated by the link command. See Predefined node variables
- Additional dependencies
- List of files used by the link command to generate output files. If all of the listed files are less recent than the output files, the link is up to date. If the dependencies list is empty, the link rule is executed every time. If the dependencies contain one or several variables which are all empty (for example, $(BuildOutputFilePaths)), the link rule is never executed.
- Overwrite default rules
- To define a link rule for the current level (Global or Project) and overwrite the existing link rule (defined at the Default, Global, or Template level), select this checkbox.
Execution tab
An execution rule is executed when you run, debug, or profile an application node.
- Run command
- Command used when user runs an application.
- Debug command
- Command used when user debugs an application.
- Profile command
- Command used when user profiles an application.
- Overwrite default rule
- To define a execution rule for the current level (Global or Project) and overwrite the existing execution rule (defined at the Default, Global, or Template level), select this checkbox.
Variables tab
The Variables tab lists environment variables set for the selected language. The integrated Toolbar allows for adding, deleting and editing environment variables. See Add or edit environment variables.
In addition to using hard-coded values when defining variables, you can use predefined node variables. See Predefined node variables.