Qbs Build Configuration | Qt Creator Documentation
Description: Settings for building applications with Qbs.

- Qt Creator Documentation
- Qbs Build Configuration
- Qt Creator 17.0.1

Reference

# Qbs Build Configuration

Specify build settings for the selected kit in Projects > Build & Run > Build > Build Settings.

Qbs builds projects in the directory specified in the Build Directory field.

In the Tooltip in target selector field, you can enter text that is displayed as a tooltip when you hover over the build configuration in the kit selector.

You can enter a name for the build configuration in the Configuration name field.

If debug info is being generated, you can have it placed into separate files, rather than embedded into the binary, by selecting Enable in the Separate debug info field. For more information, see Analyze CPU usage. To use default settings, select Leave at Default.

For more information about the QML debugging options, see Setting Up QML Debugging.

For more information about configuring Qbs, see Preferences: Qbs.

## Qbs Build Steps

To specify build steps for Qbs:

1. In the Build variant field, select:
   - Debug to include debug symbols in the build for debugging the application.
   - Profile for an optimized release build that is delivered with separate debug information. It is best suited for analyzing applications.
   - Release to create the final installation binary package.
2. In the ABIs field, select the ABIs for the Android device architectures to build the project for.
3. In the Parallel jobs field, specify the number of parallel jobs to use for building.
4. In the Properties field, specify the properties to pass to the project. Use colons (:) to separate keys from values. For more information, see Modules in the Qbs Manual.
5. In the Flags field, select:
   - Keep going to continue building when errors occur, if possible.
   - Show command lines to print actual command lines to Compile Output instead of high-level descriptions.
   - Force probes to force re-execution of the configure scripts of Probes.
6. In the Installation flags field:
   - Select Install to copy artifacts to their install location after building them. This option is enabled by default.

     Note: On Windows, the build will fail if the application is running because the executable file cannot be overwritten. To avoid this issue, you can clear this check box and add a Qbs Install deployment step in the run settings that will be performed just before running the application.

   - Select Clean install root to remove the contents of the install root directory before the build starts.
   - Select Use default location to install the artifacts to the default location. Clear the check box to specify another location in the Installation directory field.

The Equivalent command line field displays the build command that is constructed based on the selected options.

## Qbs Clean Steps

When building with Qbs, you can specify flags in Clean Steps:

- Select Dry run to test cleaning without executing commands or making permanent changes to the build graph.
- Select Keep going to continue cleaning when errors occur, if possible.

The Equivalent command line field displays the clean command that is constructed based on the selected options.

See also Build Systems: Qbs and Preferences: Qbs.

Reference