Setting Up 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. You can also build single files to test your changes.
Qt Creator automatically runs CMake to refresh project information when you edit a
CMakeLists.txt configuration file in a project. Project information is also automatically refreshed when you build the project.
If Qt Creator cannot load the CMake project, the Projects view shows a <File System> project node to avoid scanning the file system and load the project faster. The node shows the same files as the File System view. Select Build > Clear CMake Configuration, and then select Build > Run CMake to reconfigure the project.
To view and specify settings for CMake:
- Select Tools > Options > Kits > CMake.
- The Name field displays a name for the CMake installation.
- The Path field displays the path to the CMake executable.
- The Help file field displays the path to the CMake help file (.qch) provided by and installed with CMake.
- Deselect the Autorun CMake check box if you do not want to automatically run CMake every time when you save changes to
- Select Apply to save your changes.
To add a path to a CMake executable that Qt Creator does not detect automatically, and to specify settings for it, select Add. To make changes to automatically detected installations, select Clone.
To remove the selected CMake executable from the list, select Remove.
Select the Kits tab to add the CMake tool to a build and run kit. The kit also specifies the CMake generator that is used for producing project files for Qt Creator and the initial configuration parameters:
For more information, see Adding Kits.
To open a CMakeLists.txt file for editing, right-click it in the Projects view and select Open With > CMake Editor.
You can also use the
cmo filter in the locator to open the CMakeLists.txt file for the current run configuration in the editor. This is the same build target as when you select Build > Build for Run Configuration.
The following features are supported:
- Pressing F2 when the cursor is on a filename to open the file
- Keyword completion
- Code completion
- Path completion
- Matching parentheses and quotes
Warnings and errors are displayed in the Issues output pane.
Through external libraries, Qt Creator can support code completion and syntax highlighting as if they were part of the current project or the Qt library.
Qt Creator detects the external libraries using the
find_package() macro. Some libraries come with the CMake installation. You can find those in the
Modules directory of your CMake installation. For more information, see cmake-packages(7).
Syntax completion and highlighting work once your project successfully builds and links against the external library.
© 2021 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.