Home · Editor · Code Navigation · Shortcuts · Wiki

[Previous: Project Settings] [Qt Creator Manual] [Next: Support for Generic Projects in Qt Creator]

CMake Support in Qt Creator

Since Qt Creator 1.1, support for CMake project files is available. Qt Creator 1.3 supports the Microsoft Toolchain if the CMake version is at least 2.8.

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 guides 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, mingw32-make, or nmake 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 specify which targets to build in Project mode, under Build Settings.

Qt Creator supports multiple build configurations. Also, the build directory can be modified after the initial import.

Running CMake Projects

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

Known issues for the current version can be found here.

[Previous: Project Settings] [Qt Creator Manual] [Next: Support for Generic Projects in Qt Creator]