Qbs Build Configuration

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

{Qbs 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 the mouse 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

{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 deselect 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. Deselect 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:

{Qbs 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.

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.