Everyware™ Software Framework
PART 5. ADDITIONAL ECLIPSE TOOLING
SVN Integration
· Overview
SVN Integration
Overview
This example shows how to add SVN capabilities to Eclipse. There are two main SVN plugins for Eclipse. They are Subversive and Subclipse. For various reasons we will focus on Subversive. It seems to be more stable than Subclipse and has more supported features as of this writing. Also, Subversive is supported by Buckminster which is what Eurotech uses for continuous build and integration of ESF.
In this example you will learn how to:
- Add and Configure the Subversive Plug-ins for Eclipse
Prerequisites
Subversive SVN
Begin by clicking ‘Help -> Install New Software…’ in the Eclipse menu. This will open the menu shown in figure 1. Select ‘Helios – http://download.eclipse.org/releases/helios’ in the ‘Work with:’ field. Expand the ‘Collaboration’ section and select the three plug-ins below:
- Subversive Revision Graph
- Subversive SVN JDT Ignore Extensions
- Subversive SVN Team Provider
These are all shown in figure 1. Once they are selected click ‘Next’.
Figure 1 Selecting the Subversive Plug-ins
This will result in the verification dialog box shown in figure 2. Click ‘Next’ again.
Figure 2 Confirming the Subversive Plugins
A new dialog will display the Eclipse EULA that is required for these plug-ins. Accept the agreement as shown in figure 3 and click ‘Finish’.
Figure 3 Accepting the EULA
The install will probably take a few minutes to complete. Once done, it will prompt you with a restart option as shown in figure 4. Select ‘Restart Now’. This will restart Eclipse with the newly installed plug-ins.
Figure 4 Restart Dialog
With Eclipse restarted we can now configure the Subversive plug-in. The Eclipse Welcome screen (shown in figure 5) has documentation links to the Subversive documentation. Feel free to look it over.
Figure 5 Subversive Welcome Screen
Once done, close the welcome screen and go to ‘Window -> Preferences’. Then go to ‘Team -> SVN’ as shown in figure 6.
Figure 6 SVN Preferences
This will open the dialog box shown in figure 7. Select SVN Kit 1.3.2 and click ‘Finish’.
Figure 7 Selecting the SVN Connector
This will open the dialog shown in figure 8. It should show the Subversive SVN Connectors and SVNKit 1.3.2 Implementation already selected. Click ‘Next’. It will then open a review screen. Click ‘Next’ again. Finally accept the EULA and click ‘Finish’.
Figure 8 Installing the SVN Connectors
Again you may be prompted about an error validating the authenticity of the software. Click ‘OK’ to continue installing. You will once again be prompted to restart Eclipse. When Eclipse comes back up Subversive will be installed and configured. There are additional configuration changes you can make via the ‘Window -> Preferences’ menu. A convienent change to make is to make ‘Outgoing changes’ more pronounced within the Package Explorer. Do this by selecting ‘Team -> SVN -> Label Decorations’ and then selecting the ‘Icons Decorations’ tab. Finally check the ‘Outgoing changes’ checkbox and click ‘OK’. This is shown in figure 9.
Figure 9 Modifying the Icon Decorations
You now have a new perspective in Eclipse. You can get there by going to ‘Window -> Open Perspective -> Other…’. This will open the dialog box shown in figure 9. Select ‘SVN Repository Exploring’ and click ‘OK’.
Figure 10 Switching to the SVN Repository Exploring Perspective
You will notice in the main Eclipse Window the Package Explorer has been replaced with a ‘SVN Repositories’ pane. Also, you will notice a growing ‘Perspectives List; across the top center of the Eclipse Window. This is a handy way to quickly switch between perspectives. This is shown in figure 10.
Figure 11 The SVN Repository Exploring Perspective
Now we can add a repository by right clicking in the ‘SVN Repositories’ pane and selecting ‘New -> Repository Location…’. This will open the dialog shown in figure 11. In this dialog you must specify a URL and optionally a username and password if required by your SVN repository. Optionally you can also save the password by clicking the ‘Save password’ checkbox.
After adding these properly you will see a new SVN repository in your ‘SVN Repositories’ window pane. You can now browse the SVN tree, check out projects, commit code back, etc. You can also compare SVN versions and compare local versions to the repository versions. The common notions of branches, tags, and trunk are all supported so you can easily tag and branch projects as well. Refer to the Subversive plug-in documentation for more information.
Copyright © 2010 Eurotech Inc. All rights reserved.