CMake

CMake automates the configuration of build systems. It controls the software compilation process by using simple configuration files, called CMakeLists.txt files. CMake generates native build configurations and workspaces that you can use in the compiler environment of your choice.

You can use CMake from Qt Creator to build applications for the desktop, as well as mobile and embedded devices. Or, build single files to test your changes.

Supported CMake Versions

Qt Creator requires CMake's file-based API, and therefore you'll need CMake version 3.14, or later.

For systems with older versions of CMake, only workarounds are available:

  • For CMake version 3.5 or later, generate a compilation database and open that in Qt Creator, as described in Use compilation databases.
  • Create an ad-hoc project file for a qmake build using qmake -project and open that in Qt Creator. Typically, you cannot compile such projects without manual changes.
  • Manually create an ad-hoc project file for a generic project and open that in Qt Creator. Typically, you cannot compile such projects without manual changes.

See also Configure projects for building, Configure projects for running, How To: Build with CMake, CMake Build Configuration, Debug CMake project files, Deploying to Remote Linux, Open projects, and Use compilation databases.

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