Main

January 19, 2008

Getting Started with svnX on the Mac

56.gifIf you're using Subversion version control, one GUI option for Mac users is svnX

Getting started isn't immediately intuitive with the multiple windows, so here are some steps I put together for one of my guys today:

1. You need to setup the connection to the SVN server in the 'repositories' window:
- name: whatever you want to reference it as
- path: https://www.yourdomain.com
- username
- password

After that's entered, you can double click on its listing above the edit fields. It should then try to connect and display the most recent log messages. That's the first step to getting going.

2. Create the folder on your machine where you want the files to live. Go back to the svnX window that has the logs, below the log listings it should show "root" in the first column, Click on that and "trunk" should appear and begin to load its subfolders. With "trunk" selected, click svn checkout at the top and choose the folder you created. You can click show output to see the files getting added.

3. Then, in the svnX Working Copies window, create a new item. The 'name' should match what you used in #1 above for the connection name and the path should be the folder that you created, just the root, not the 'trunk'.

4. After you've added the working copy, double click its listing in the copies window. A new window should launch. Click Update to pull down the latest. Click Show output to see what changes if any were pulled down.

5. So every time you start a new session, you just need to fire up that last window to 'get latest'. Hit refresh to see any changes you've made.. click 'update' on the side to post your changes to svn and 'add' for any new files that aren't in svn.

Certificate Errors
You may get certificate errors when trying to connect for the first time, you'll need to subvert it by using the terminal

Hosted Subversion
I recently ran across Beanstalk, a hosted version of Subversion. I haven't tried it out,but it is supposed to integrate with Basecamp, another online application we use.