Details on versioning

After the first steps in versioning I stumbled over some beginner's mistakes, I guess.

So let's walk through a quick project setup.

1. Create a project in Xcode somewhere on your disk (you'll delete it later anyways....)
2. Click on SCM in the Xcode menu, and then Repositories
3. After selecting your Repository (mine is called Local Subversion), select the folder/branch where you want the project to be stored at
4. Select Import in the toolbar
5. Select the folder where the previously created project is located at and hit Import
6. Xcode will tell you that the project got imported
7. Now close the project and delete it
8. Again go to the Repositores (step 2)
9. Now click Checkout in the toolbar (don't click export like I did the first time... this will lead to a non-versioned copy of the project)
10. Select the folder where you want the project to be stored at. This will be the working copy of the sources that you will work on.
11. Hit Checkout
12. Now you should have a copy on your desk. Next step is tell the project that it is a versioned project. Go to the project settings. On the very bottom of the properties page (in the General tab) you can now select the SCM repository. Select the repository that you would like to use.
13. If you want to you can change the build output to some other directory.
14. Afterwards you will see that the project file was modified as there is a capital "M" next to the project file (as long as you have selected the SCM preference by right clicking on the file listing)
15. Now you can commit those changes back to the repository by clicking on "Commit Entire Project" in the SCM menu.
16. That's it :-) 

First things first.... versioning

So before we get all into Objective-C or Cocoa I would like to setup Xcode to do versioning.

Why versioning?

First of all, versioning does not save you from making backups. Having said that, if you mess around with code a lot you will find yourself trying out stuff. Most of the times you will have to try things to get your app to do what you want to. Sooner or later it will happen that you will think "didn't this work the other day??"

I tried to save myself from such a thought over the years with making several backups including timestamps but let's face it... You always forget the important one and comparing different versions is a pain. Versioning is supposed to help you here, so let's try it out.

Which versioning system?

Xcode supports three systems (at least the dialog box tells me that it supports three): CVS, Subversion and Perforce. Perforce is AFAIK not for free, so we'll skip that one. Since CVS is pretty old and since I read somewhere that Subversion is somehow a better/newer CVS I wanted to give it a try.

Getting started

I tripped over this article on the developer pages of apple which gives a basic guidance to setting up Subversion with Xcode. The main issue with the article is that it focuses a real server (with a lot of people working on it). Now this usecase is the most interesting one when it comes down to sourcecode management (SCM) software in general, but right now I am only interested in getting versioning for myself (and only on my computer since I don't have a MacBook right now).

So when you read through the article you will probably see that svnserve is better for you then the Apache module, at least that is what I thought. So what I did is set up a repository as described in "Creating a Subversion Repository"(only creating it in my User directory instead of /Library), I skipped the Apache configuration and continued on "Using Subversion from Xcode". That chapter basically just tells you to set the project settings to have the build output put somewhere else (so that you do not checkin those files) and how to use the repository with Xcode.

Now I do not know what I did wrong, but the best that I could get is an authorizations error after manually starting the svnserve deamon (which is not necessary according to the documentation). I searched the apple pages and googled around a bit but didn't get to lucky on what to do next. Finally I found this page which tells me where the config file of Subversion is (actually it just tells me that there is a config file and what it's name is, but since we have spotlight...)

When I opened the config file I found an interesting note:

   ### This file controls the configuration of the svnserve daemon, if you

   ### use it to allow access to this repository.  (If you only allow

   ### access through http: and/or file: URLs, then this file is

   ### irrelevant.)

Ok, so if I can use file:/ instead of svn/svn+ssh or http I should be fine..... at least that was my guess. Happily it turned out that this guess wasn't so bad so without starting anything manually and without messing around with the authorizations to much I know have the following config:

scheme: file

Path:

That's it! Now all the versioning works fine.