Surround SCM 2011.1.1 and later supports integration with Xcode 4. See Surround SCM Third-Party Integrations for information about supported versions.

Note: The following information only applies to Xcode 4. See Surround SCM Xcode 3 Integration if you use Xcode 3.

Requirements

• Changelists must be enabled in Surround SCM. The Xcode plug-in uses changelists for all check in and add operations. Files are automatically added to a default Xcode changelist when they are added to a project and are not available in Surround SCM until the changelist is committed.
• Checking in files without check out must be enabled in Surround SCM.

Installing the plug-in

The Xcode plug-in is installed during the Surround SCM Client installation. If you did not install it, close Xcode, rerun the installer, and select the Xcode 4 integration option.

Associating projects with Surround SCM

You can associate a project with Surround SCM when you open a project, add a working copy, or get the project in Xcode.

Opening a project

To associate a project with Surround SCM, open it from a working directory. After you get all the required files, Xcode automatically detects the project is controlled by Surround SCM. You may be prompted to connect to Surround SCM before you can perform Surround SCM actions.

Adding a repository

In the Repositories pane in the Xcode Organizer, click the plus (+) button and choose Add Working Copy. Select the project root folder from the file browser to ensure Xcode associates all project files with Surround SCM.

Getting the project in Xcode

1. In the Welcome to Xcode dialog box, click Connect to a repository
   or
   In the Repositories pane in the Xcode Organizer, click the plus (+) button and choose Checkout or Clone Repository.
   The Checkout or Clone dialog box opens.
2. Enter the Surround SCM sscm:// address for the project’s root repository as the Location and click Checkout.
3. If a working directory is not set for the repository, you are prompted to set it.
   
   
   
4. Click Yes. Xcode retrieves the files to the working directory.
5. Click Open Project when the check out is complete.

1. In the Repositories pane in the Xcode Organizer, click the plus (+) button and choose Add Repository. The Add a Repository dialog box opens.
2. Enter the repository Name and Surround SCM sscm:// address as the Location.
3. Click Next. You may be prompted to log in to Surround SCM.
4. Click Add. The repository is added to the Xcode Organizer.
   Note: You do not need to enter trunk, branches, or tags information because the plug-in does not support branching.
   
5. Select Root under the repository.
   
6. Browse to the repository to get and click Checkout. Xcode retrieves the files to the working directory.

Setting Xcode integration user options

1. In Surround SCM, choose Tools > Users Options and select the Xcode Integration category.
2. Select Display the TestTrack Browser dialog before all changelist commit operations to always open the TestTrack Browser to attach files to TestTrack items before committing changes.
3. Enter any file extensions in the Ignored Files field to exclude files when committing changelists.
4. Click OK to save the changes.

Performing Surround SCM actions

Select a file in the project navigator and choose an action from the File > Source Control menu.

Xcode uses the following status badges to display local file status, which can help you determine if files are in sync with Surround SCM.

• M — The local file was modified and does not match the file in Surround SCM.
• U —  A newer file version was checked in and the local file is no longer current.
• A — The file is not in Surround SCM and is in the default Xcode pending changelist.
• I — The file is ignored by Surround SCM based on the integration user options.
• ! — The file is not in Surround SCM. Only visible in the Commit dialog box.
• - — The files in the folder have different statuses. Expand the folder for details.
• ? — The file status cannot be determined.

Troubleshooting

Refer to the Xcode 4 Transition Guide for troubleshooting help.

Host is unreachable
A host is unreachable error may be displayed if you use an IP address to connect to Surround SCM when associating a new repository or opening a project. Replace the IP address with the Surround SCM Server hostname to establish the association.