Knowledgebase

Search:     Advanced search

Changing the Surround SCM Plug-in Used with Visual Studio Projects

Article ID: 763  |  Last updated: 05 Jul, 2017

Surround SCM has two integration plug-ins for Visual Studio:

  • The Surround SCM plug-in is built using the Microsoft Source Code Control interface (MSSCCI) API, which only lets Visual Studio access a basic, limited set of Surround SCM functionality. Surround SCM actions are available in the File > Source Control menu when this plug-in is enabled.
  • The Surround SCM Integration Provider plug-in is built using the Visual Studio Integration Extension (VSIX) API, which lets Visual Studio access most Surround SCM functionality. Surround SCM actions are available in the Surround SCM menu when this plug-in is enabled.

To access more Surround SCM actions in Visual Studio, change projects using the Surround SCM plug-in to use the Integration Provider plug-in instead.

Note: The Surround SCM SCCI plug-in is the only option for Visual Studio 2003. If you use this Visual Studio version, you cannot change projects to use the Integration Provider plug-in. 

  1. Make sure the Surround SCM Integration Provider plug-in is installed. It is installed if you select the Visual Studio integration option during Surround SCM installation.
  2. In Visual Studio, unbind the solution and all projects from source control.
  3. Enable the Surround SCM Integration Provider plug-in.
  4. Connect Visual Studio to Surround SCM.
  5. Rebind the projects to source control and check them in to Surround SCM.
  6. Rebind the solution file to source control.

Unbinding the solution and projects from source control

  1. Open the solution in Visual Studio.
  2. Right-click the solution file and choose Check Out.
  3. Choose File > Source Control > Change Source Control. The Change Source Control dialog box opens.
  4. Ctrl+click the solution and all projects and then click Unbind. You are prompted to confirm the unbinding.
  5. Click Unbind.
  6. After all projects are unbound, click OK to close the Change Source Control dialog box.
  7. Click Save All to save the changes and then restart Visual Studio.

Enabling the Integration Provider plug-in

  1. Choose Tools > Options. The Options dialog box opens.
  2. Click the Source Control category and select Plug-in Selection.
  3. Make sure Surround SCM Integration Provider is set as the source control plug-in.
    Note: Do not select Surround SCM. If Surround SCM Integration Provider is not listed, rerun the Surround SCM installer and select the Visual Studio integration option.

Connecting Visual Studio to Surround SCM

  1. Choose File > Surround SCM > Bind/Unbind Settings. The Surround SCM Connection Settings dialog box opens.
  2. Ctrl+click the solution file and all project files and then click Connect. You may be prompted to enter your Surround SCM username and password.

Rebinding projects

Note: Only bind one project at a time. Do not bind the solution yet because you need to sync the projects with Surround SCM first.

  1. In the Surround SCM Connection Settings dialog box, select a project and click Bind. You are prompted to confirm the branch and repository to bind the project to.
  2. Click Yes.
  3. Repeat steps 1 and 2 for all other projects.
  4. After all projects are bound, click Save All and then close Visual Studio.
  5. Start Surround SCM and recursively check in all project files.
  6. Add all new .vxcproj and .vcxproj.filters files to the corresponding repositories. You can view working directory differences to make sure the repositories are synced with your working directory.

Rebinding the solution

  1. In Surround SCM, check out the solution file.
  2. Start Visual Studio.
  3. Choose File > Surround SCM > Bind/Unbind Settings. The Surround SCM Connection Settings dialog box opens.
  4. Select the solution file and click Bind. You are prompted to confirm the branch and repository to bind the solution to.
  5. Click Yes.
  6. After the solution is bound, right-click it and choose Check In. The solution and all projects are upgraded to used the Surround SCM Integration Provider plug-in.
Article ID: 763  |   Last updated: 05 Jul, 2017
Tags
Visual Studio

Prev   Next
Surround SCM IntelliJ IDEA and WebStorm Integration     Surround SCM NetBeans Integration