CMakeLists.txt
CMakeLists.txt file contains a set of directives and instructions describing the project's source files and targets (executable, library, or both).
When you create a new project, CLion generates CMakeLists.txt file automatically and places it in the project root directory. To open a project, you can point CLion to the top-level CMakeLists.txt and choose Open as Project.
Example below shows the CMakeLists.txt file of a simple "Hello, World!" project:
You can edit CMakeLists.txt files right in the Editor. Make sure to reload the project after editing. Automatic reload feature is disabled by default, you can turn it on by selecting the Automatically reload CMake project on editing checkbox in .
For projects with complex structure, you can create subdirectory CMakeList.txt files to describe the build, contents, and target rules for a subdirectory. Type of a target added by a subdirectory CMakeLists.txt file can differ depending on the role of the module.
CMakeLists.txt file templates
When you create a CMake or CMake-based (CUDA, Qt) project via the New Project wizard, CLion uses different templates to generate CMakeLists.txt depending on the project type and settings. You can fine-tune these templates in , the Other tab:
When editing a template text, you can use common predefined variables and the following CMake-specific variables:
${CMAKE_DEFAULT_PROJECT_FILE} | the main.cpp/main.c/libary.cpp/library.c file of the project. |
${CMAKE_LANGUAGE_VERSION} | the selected language standard. |
${CMAKE_MAJOR_VERSION} | the major number of the minimum supported CMake version. For example, if the version if |
${CMAKE_MINOR_VERSION} | the minor number of the minimum supported CMake version. For example, if the version if |
${CMAKE_LIBRARY_TYPE} |
|
${QT_VERSION} | the selected Qt version. |
${REQUIRED_LIBS} | the Qt libraries required for the selected project type. By default, they are |
There is also a template for CMake scripts that you can add to an existing project via Files tab:
in the context menu of the project view. By default, this template is empty. You can edit it using the same variables in , theCode assistance in CMakeLists.txt
Code completion
CLion provides code completion for most of the elements in your CMakeLists.txt. For example, you can get the list of the packages bundled with CMake when writing a find_package()
command:
Quick documentation popup
Quick Documentation popup helps you get more information on the elements in your CMake code. To invoke it, use mouse hover or press Control+Q.
For example, you can view quick documentation for completion suggestions:
Code folding
Folding/unfolding in CMake scripts is available for macros and functions, if-else clauses, comments, as well as arbitrary code selections (make sure to enable Custom folding regions in for this to work).
Structure view
Structure view for CMake shows variables, functions, macros, and targets used your script. To open it, press Alt+7 (for the tool window) or Control+F12 (for the popup).
Customizable syntax highlighting
You can adjust the color and font scheme for CMake files in
:Code style for CMake files
In
, you can adjust the code style being applied to CMake files. When you change a certain setting, the Preview pane shows how this will affect your code.