Converting to a remote C or C++ project

You can convert a general, C or C++ project into a remote C/C++ project using the Convert to Remote C/C++ Project Wizard.

To convert a general, C or C++ project to a remote C or C++ project:

  1. Select the projects you want to convert to Remote C/C++ projects in the Project Explorer. Right click and select Convert to Remote C/C++ Project.

    Select projects in Project Explorer, right click, select Convert to Remote C/C++ Project

  2. All project conversion candidates in the workspace will be listed. Projects selected in the Project Explorer in the previous step will be preselected in the list.


    Convert to Remote C/C++ Project Wizard window

  3. Configure the File synchronization options:

    If you are not using a mounted directory, select Work with local copy of files and push file changes to remote location.

    If you are using a mounted directory, and this directory corresponds to the remote location, select Local location is a mounted folder pointing to the remote location.

    NOTE: If the location is a mounted version of the remote location and you do not select this option, your files will not synchronize properly and the C/C++ Indexer will not be properly invoked when your files change.


  4. Browse for the remote location root for the selected projects. All projects will be created as subfolders of the specified root folder.


  5. Click Next to configure project options.

    Configure Project Options

  6. Click Next to configure the build and indexing options.

    Configure build and indexing Options

    The build command is the build command to be used to build your project; the build directory is the location where the build output is to be stored (default is ${remote_path:/${project_name}} which stores the build output in each project's location); the compiler executable directory is the location where the compiler executable can be found.



    By default, project will not be indexed until it has been built. You can change this by unchecking the Do not index project until project has been built checkbox.



    Click Next.


  7. Review the project location and build directory for each project. Click Finish

    Select projects in Project Explorer, right click, select Convert to Remote C/C++ Project

  8. Converted projects will appear in the Remote Reconciler view.

    Converted projects in Remote Reconciler view