Building for Multiple Platforms

You can build applications for multiple target platforms, or using different compilers, debuggers or Qt versions. Kits define the tools, device type and other settings to use.

By default, when you run the application, you automatically build and deploy it first. However, you can also perform each operation separately.

To check that the application code can be compiled and linked for a device, you can build the project. The build errors and warnings are displayed in the Issues output pane. More detailed information is displayed in the Compile Output pane.

To build an application:

  1. Click the Build and Run Kit Selector icon (1) or select Build > Open Build and Run Kit Selector to select the build and run kit.

    "Kit selector"

  2. Choose Build > Build Project or press Ctrl+B.

    You can also select the Run button (2) to also deploy and run the application after building it.

While the application is being built, the Build button changes to a Cancel Build button (3). To cancel the build, select the button or press Alt+Backspace. If you selected a build command and decide you would also like to run the application, you can select the Run button to schedule running the project after building is done.

For more information on the options you have, see Specifying Build Settings.

Additional Build Commands

To build all open projects, select Build > Build All. If building one application fails, Qt Creator displays an error message and continues building the other applications.

To quickly check the compile output for changes that you made in one file or subproject, you can use the Build menu commands to build a file or subproject. The available build menu commands depend on the build system you selected for the project: CMake, qmake, or Qbs.

Select Build > Build for Run Configuration to build the executable that corresponds to the selected run configuration. You can also use the cm filter in the locator.

To remove all build artifacts, select Build > Clean All or Clean Project. To clean the build directory and then build the project, select Build > Rebuild All or Rebuild Project.

To build and clean projects without dependencies, select the Build Without Dependencies, Rebuild Without Dependencies, and Clean Without Dependencies options in the context menu in the Projects view.

To run qmake or CMake to regenerate build system files, select Build > Run qmake or Run CMake.

Building with CMake

Qt Creator automatically runs CMake when you make changes to CMakeLists.txt files. To disable this feature, select Tools > Options > Kits > CMake > Autorun CMake.

For more information, see Setting Up CMake.

Building with qmake

To prevent failures on incremental builds, it might make sense to always run qmake before building, even though it means that building will take more time. To enable this option, select Tools > Options > Build & Run > qmake > Run qmake on every build.

© 2019 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.