Home

This documentation is out of date. Please refer to the latest version.

[Previous: The Code Editor] [Qt Creator Manual] [Next: Qt Version Management]

Build Settings

To modify the build settings of your project, switch to the Projects mode using the mouse or with Ctrl+4.

Action items to create, clone, or delete build configurations can be found at the bottom of the dialog. You can have as many build configurations as needed. By default Qt Creator creates a debug and release build configuration. Both these configurations use the Default Qt Version.

In the tree on the left, a list of build configurations and their settings are displayed. The screenshot above shows the debug and release configurations and their corresponding settings: Build Environment and Build Steps.

When you select a build configuration in the tree, a configuration page for general build settings will be displayed. Here you can specify which Qt version to use to build your project, whether to shadow build the project.

In the Build Environment page you can specify the environment used for building. By default the environment in which Qt Creator was started is used and modified to include the Qt version. Depending on the selected Qt version, Qt Creator will automatically add the necessary environment variables.

The build system of Qt Creator is built on top of qmake and make. The settings for qmake and make can be changed in the Build Settings page. Qt Creator will run the make command using the correct Qt version.

Note: The Gdb Macros Build step builds a small library along with your project that is used for the custom display of Qt and STL objects in the integrated debugger. The library is created and built in a "qtc-gdbmacros" subfolder of your project's main directory, and loaded dynamically into your application if you run it in the debugger. If the debugging helper seems to break your build or your application, you can remove the build step. You will still be able to debug applications, but the contents of Qt and STL data types will not be displayed properly.

Dependencies

If you have multiple projects loaded in your session, you can configure dependencies between them. This will affect the build order of your projects. To do this, go the the Dependencies tab after selecting the project for which you want to configure the dependencies, and then use the checkboxes to check which of the other projects is a dependency.

[Previous: The Code Editor] [Qt Creator Manual] [Next: Qt Version Management]