Home

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

[Previous: Debugging with Qt Creator] [Qt Creator Manual] [Next: Tips and Tricks]

CMake Support in Qt Creator

Since Qt Creator 1.1, support for CMake project files is available.

Opening CMake Projects

To open a CMake project select Open from the File menu and select the CMakeLists.txt file from your CMake project. A wizard will guide you with the rest of the process. If the CMake project does not have an in-place build, Qt Creator lets you specify the directory in which the project is built (shadow build).

The screenshot below shows how you can specify command line arguments to CMake for your project.

Normally, there is no need to pass any command line arguments for projects that are already built, as CMake caches that information.

Building CMake Projects

Qt Creator builds CMake Projects by running make or mingw32-make, depending on your platform. The build errors and warnings are parsed and displayed in the Build Issues output pane.

By default Qt Creator builds the "all" target. You can change which targets get build in the Project/Build Settings.

Currently only one build configuration is supported and the build directory can't be changed after the initial import. This limitation will be fixed for the next version.

Running CMake Projects

Qt Creator automatically adds Run Configurations for all the targets specified in the CMake project file.

Known issues for the current version can be found here.

[Previous: Debugging with Qt Creator] [Qt Creator Manual] [Next: Tips and Tricks]