Create and Edit Configurations

Run/debug configurations for CMake projects

• By default, the Generate run configurations for new CMake targets automatically option is enabled. It means that CLion creates configurations using the data on project targets and executables from your CMakeLists.txt scripts. This works for the most cases with the following limitations:

  • CLion will not create a new default configuration if the configuration with the same target already exists;

  • CLion will not create a new default configuration if the same configuration has already being created;

  • An old configuration which was created manually will be replaced with the new one created automatically if they have the same name.

  • Also, an automatically created configuration can be deleted automatically for the deleted/obsolete targets, if the Delete run configurations for missing CMake targets automatically is enabled.

• You can always create configurations manually on the base of one of the available templates.

Create a run/debug configuration

1. Open the Run/Debug Configuration dialog in one of the following ways:

   • Select Run | Edit Configurations from the main menu.

   • With the Navigation bar visible (View | Appearance | Navigation Bar), choose Edit Configurations from the run/debug configuration selector.

   • Press Shift+Alt+F10, then press 0 or select the configuration from the popup and press F4.

2. In the Run/Debug Configuration dialog, click on the toolbar or press Alt+Insert. The list shows the default run/debug configurations. Select the desired configuration type.

   The fields that appear in the right-hand pane display the default settings for the selected configuration type.

   

3. Depending on the chosen template, fill up the configuration settings. For example, CMake Application, Custom Build Application, Gradle / Gradle Native Application.

4. In the Before launch section, define whether you want to launch any external tool or other build configuration before run. To skip the build stage, remove Build from Before launch list.

5. Specify additional parameters depending on the configuration type. For descriptions of run/debug configuration parameters, refer to the Run/Debug Configurations Dialog section.

6. Apply the changes and close the dialog.

Edit an existing run/debug configuration

1. Do one of the following:

   • From the main menu, choose Run | Edit Configurations.

   • With the Navigation Bar visible (View | Appearance | Navigation Bar), choose Edit Configurations from the run/debug configurations selector.

   • Press Shift+Alt+F10, then press 0 to display the Edit Configuration dialog, or select the configuration from the popup and press F4.

2. In the corresponding run/debug configuration dialog, change parameters as required.

Enable the Services tool window

You can manage multiple run/debug configurations in the Services tool window. For example, you can start, pause, and stop several applications, track their status, and examine application-specific details.

1. From the main menu, select Run | Edit Configurations or use the selector on the toolbar.

2. In the Run/Debug Configurations dialog, select Templates from the list on the left.

3. In the right-hand pane, expand the Configurations available in Services section.

4. Click in the Configurations available in Services section and select the necessary run configuration type.

   

   You can add or remove multiple configuration types one by one.

   Note that the tool window will only display the configuration types for which you have created one or more configurations.

   Thus, if you add a configuration type for which no configurations exist in the project, this type will not be displayed in the tool window until you create a configuration of this type.

5. Apply the changes and close the dialog. The Services tool window with the selected configurations will open.