← servoy magazine

[Tutorials] Install Subversion for Servoy 5 on Mac

  • Tutorials

It took a bit of work to track down all the little details required to get subversion up and running successfully with Servoy 5 on a Mac. Enjoy.


1 Requirements

Make sure the directory and Developer are named "Servoy". In other words, don't rename anything after installing Servoy!

You need an SVN server someplace. Options:
   setup your own
   we're currently using http://www.beanstalkapp.com
   a bazillion other ones out there for reasonable monthly fees (and even free)

2 Install SVN for Mac

Download the latest Mac OS X binary package from openCollabNet
   http://www.open.collab.net/downloads/community/
   
Install the file and follow the steps

Once installed, run the command export PATH=/opt/subversion/bin:$PATH to set the proper path

3 Install subversive in Servoy Eclipse
Help > Install New Software...

Add the following 2 URL's (press the "Add" button to add them in)

   http://download.eclipse.org/technology/subversive/0.7/update-site/
   http://community.polarion.com/projects/subversive/download/eclipse/2.0/update-site/

Choose which connector to install
   select "--All Available Sites--" from "Work with:" filter
   expand "Subversive SVN Connectors" and select:
      - Subversive SVN Connector Connectors (required)
      - SVNKit 1.3.0 Implementation (need for subversion v1.6x)
      - Native JavaHL 1.6 Implementation (need for subversion v1.6x)
   expand "Subversive SVN Team Provider Plugin" and select:
      - Subversive SVN JDT Ignore Extensions
      - Subversive SVN Team Provider
      - Subversive SVN Team Provider Localization (don't need if just using english)   click "next" until installed

4 Configure subversive
Go to preferences for subversive (Team > SVN)

   make sure under "SVN Connector" tab that the native JavaHL is selected
   rest of the defaults are ok

Open SVN perspective
   Window menu > Open perspective... > Other... > SVN Repository Exploring

Add an SVN repository and connect it to your SVN server
   "SVN Repositories" view > "New Repository Location" (small yellow button at top of view)
      enter URL to SVN server
      enter user/password credentials (or SSL key under SSL settings)
         recommend clicking "Save password"
         note that capitalization may be important
      (optional) use a custom label to name this repository

5 Basic usage notes
The basic things you can do:
   Share
   Synchronize
   Commit
   Update
   
Share: creates initial link from workspace to repository (only need to do once)
   right-click a solution in Servoy's Solution Explorer
   choose "Team > Share Project..."
   select type of team sharing. in this case "SVN"
   choose your newly created repository
   click "Next" and optionally enter a comment in the next pane
      note "Launch the Commit Dialog for the shared resources"
         this does two additional steps: synchronize and commit. this is a good thing
         you get the option to enter comments on the commit
   at this point you get an error dialog "Developer started repsoitory"
      the short version is click "Change setting / restart"

   sharing is done
      switch to SVN perspective and you should see your newly shared, synchronized and committed files
   
Synchronize: compare what's in your workspace to what is on the SVN server
   right-click a solution in Servoy's Solution Explorer
   choose "Team > Synchronize with repository..."
      will pop you into Synchronize perspective
      double-click and object to see differences
   note: a right arrow next to an object name denotes that you have new change in the workspace
      an asterisk denotes the repository has a new change

Commit: push workspace changes to repository
   you can do from Solution Explorer or SVN perspective

Update: pull repository changes to workspace
   this overwrites files in your workspace
   you can do from Solution Explorer or SVN perspective


5 Finish up
Subversive is cool in that it generally tells you when you need to commit as you're working. Just look for the ">" in front of your objects in the Solution Explorer.

Numbers to the right of objects in the Solution Explorer/SVN Repositories denote the revision you are working on.

At this point you can rename the servoy directory and developer file if you'd like.

Comments (2)

Ben Savignac
Very useful information, David! I had gotten an account with BeanStalk, but I was hesitating to install SVN on my MBP because I felt the task was a daunting one and I needed the safety net of a how-to like this one. Will try it out in the coming days. Thanks again!
Servoy Stuff
So I see that you settled for Subversive as your SVN plugin. Any particular reason you chose that one over Subclipse?