Path variables
Use path variables to define absolute paths to resources that are not part of a specific project. These external resources may be located in different places on the computers of your teammates. This is why user-defined custom path variables are not stored as project settings, but as global IDE settings. Once configured, such path variables will have the same value for any project that you open with your instance of CLion.
There are two pre-defined variables in CLion: $USER_HOME$
for your home directory and $PROJECT_DIR$
for the directory where your project is stored.
You can refer to path variables when configuring external tools and run/debug configurations of the following types:
Create and use a path variable
For example, when your program takes input data from a file, you can create a path variable for the file location, and then refer to this variable in a run/debug configuration that you share through VCS with your teammates.
Press Control+Alt+S to open the IDE settings and select
.Click and enter the name of the new variable (for example,
DATA_PATH
) and its value that points to the target directory with the data file on your disk:In the configuration settings, click in the required field (Redirect Input in our example). Select the variable in the Macros dialog:
Set the Store as project file checkbox and specify the location where the file with your configuration will be stored:
You can check the contents of this file (which is <project directory>.idea/runConfiguration/<configuration name>.xml by default):
Now if you share this .xml file through VCS, your teammates will get the configuration with
$DATA_PATH$
in it, and they will be able to change the value so that it points to their location of the input data file.
Ignore path variables
Whenever you open or update a project, CLion checks for unresolved path variables. If the IDE detects any, it will ask you to define values for them. If you are not going to use files or directories with the unresolved path variables, you can add them to the list of ignored variables.
You can also use the list of ignored variables when a program argument passed to the run/debug configuration has the same format as a path variable (for example, an environment variable).
Press Control+Alt+S to open the IDE settings and select
.Add the names that CLion shouldn't consider to be path variables to the Ignored Variables field.
Click OK to apply the changes.