Xcode SVN Integration

Introduction

Integrating Subversion into your Xcode project is a very simple process, once you know what to do. It makes adding, updating and committing files to the SVN repository easy. Xcode’s diff tool is also a very nice feature that comes with configuring SVN. There are more advanced things, however, that Xcode is not very good at, for which I recommend using the command-line tool or a more advanced GUI like Versions.

Step by step guide

1. Choose `Configure SCM Repositories…` from the `SCM` menu.
   
2. Add a new repository using the plus button on the bottom right.
3. Name the repository (i.e. “BYU Cocoaheads Project”), and make sure Subversion is chosen for `SCM System`.
4. For the URL enter `https://byuch-project1.googlecode.com/svn/trunk`. You will notice other fields become auto-populated.
5. For the User, enter your username here on Google Code. If you do not know it, it can be found by clicking on Profile in the top right of the page.
6. For the Password, use you !GoogleCode.com Password, found in your profile settings. This is not the password you use to log into Google.
   
7. At this point you should see “Authenticated” at the bottom of the page. If not, make sure all your settings have been put in accurately and that you have the appropriate rights on the project.
   
8. Choose `Repositories` from the `SCM` menu.
9. Select the repository and choose `Checkout` from the toolbar.
10. Save to a location on your hard drive where you would like to keep the project.
11. If Xcode detects an Xcode project in the folder you will be asked if you’d like to open the file. Do so or open the file manually if not prompted.
12. Choose `Configure SCM For This Project…` from the `SCM` menu.
13. The General tab of the Project Info window should have appeared. For Xcode 3.1, select your repository from the `SCM Repository` pop up menu. For Xcode 3.2, click on the `Configure Roots & SCM…` button in the top right, make sure Subversion is chosen the the top pop up menu, and then choose the repository from the pop up in the table. The repository will probably say “Recommended” next to it.
    
14. The `SCM` drop down menu should now be populated with more options. If not, ensure that you have configured the SCM correctly in the previous steps.
    
15. Begin using SVN from within Xcode. I recomend turning on the SCM column in your project by right clicking on the `Groups & Files` column header and choosing `SCM`.