Importing Multiple Local/Remote C/C++ Projects

To create multiple projects for your C/C++ files on the remote server, use the Import Remote C/C++ Projects wizard.

  1. To create multiple Remote C/C++ Projects begin by opening the Import Local/Remote C/C++ Projects wizard by going to File > New > Project. Under C/C++, select Import Local/Remote C/C++ Projects.

    File > New > Project > Remote > Import Local/Remote C/C++ Projects


  2. Use the Connection field pulldown to select your remote host. Select the remote folders to import. Click Next.

    Select remote folders to import

    NOTE: Do not create projects pointing to the same project location on the remote host in multiple IDEs. This will cause unexpected behavior to occur.


  3. Select the project Type:

    Choose Project Type
  4. The remote location root will be generated for the selected folders. New projects will have the same name as its folder name.

    Specify project location


  5. Check the Associate a local location checkbox if you wish to have a local project. If you wish to use source control (see Working with Rational Team Concert for additional configuration information), work disconnected from the remote machine, or wish to use a mounted folder, you will want a local project.

    Associate local location option

    If you wish to use a location other than the default, uncheck Use default location.


    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.



  6. Click Next to configure project options.

    Configure Project Options

    Choose either C or C++ for the language option.


    If you would like to create your own makefile, choose Makefile project, otherwise select Managed Build to have a makefile generated for you. The options available for a managed build project are further explained here.


    The Tool Chains section shows which tool chains are available for your project.



  7. 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.



    Choosing Do not index project until the project has been built will prevent the indexer from launching until the project has been built.



  8. Click on Advanced ... to edit the configuration for the C/C++ Indexing service and/or the Build service. For more information, see Service Providers.

    C/C++ Indexing Service


    Build Service
    When you have finished your edits, click OK.


  9. Click Finish in the Import Remote C/C++ Projects wizard to create the remote C/C++ projects. Creating the projects may take a few minutes. Once the projects have been created they will appear in the Project Explorer view.

    Remote Projects in Project Explorer View


Once you have created the remote C/C++ projects, you are ready to create a C or C++ file.



Related tasks
Creating a remote connection
Creating a Local/Remote C/C++ project
Creating a C or C++ source file
Editing a C or C++ File
Creating a makefile
Building a C/C++ project