Load/Reload CMake Project
CMakeLists.txt file changes, CLion shows a banner on top of the editor:
As you see, CLion suggests to reload the current project using the following options:
Choose the first option to reload the current project manually. In this case, the subsequent editing on the file
CMakeLists.txt will lead to showing the same banner.
The second option results in selecting the checkbox Automatically reload CMake project on editing in the CMake page of Settings. All the subsequent changes of the file
CMakeLists.txt will cause the automatic reload of the current project and will pass unnoticed.
It is possible to make CLion always reload automatically. This is done in one of the following ways:
Open Settings, and under the Build, Execution, Deployment node click the CMake page. Then select the checkbox Automatically reload CMake project on editing.
Click and type
reload cmake. Click the line with the required action:
In addition, CLion allows you to reload the project using the main menu. To reload a project from the main menu, do one of the following:
On the main menu, choose
On the main menu, choose
In CMake tool window, click the button
Reset CMake cache
In some cases you may need to reset the CMake cache before building a project, without affecting the CLion cache. To reset the CMake cache and reload the project, do one of the following:
Click the button of the CMake tool window. In the drop down menu that opens, select the Reset Cache and Reload Project option.
TroubleshootingYou may face the following cases when working on your project:
CMakeLists.txt file is not detected
If you open a project in CLion, but no
CMakeLists.txt file is detected (e.g. the project does not contain a
CMakeLists.txt file or it is located out of the project root folder), you can see that there is no CMake tool window opened. Besides, the CMake related options such as Reload CMake Project, Change Project Root Directory, and other options of the main and context menus are unavailable: the project is not associated with the CMake build system. To associate your project with CMake, click the warning message Select CMakeLists.txt file: Select the desired
CMakeLists.txt in the dialog that opens.
CLion detected an improper CMakeLists.txt file
If CLion detects a
CMakeLists.txt file, but you want to use another one for your project, then you need to disassociate a project from CMake, and then link the project again with the proper
CMakeLists.txt. To do that:
Go to the Unload CMake Project option from the drop down menu:main menu option and select
Upon this action, the CLion's state is as described in case #1. Now do one of the following:
Click Select CMakeLists.txt file and select the proper
CMakeLists.txtfile from the dialog.
Find the desired
CMakeLists.txtfile in the Project View and right click it. Select Load CMake Project from the context menu.
If you need to unlink your project off the CMake build system completely, use the Unload CMake Project action as described above.