[Tutorials] Install Subversion for Servoy 5 on Mac
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)
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)