In dem Eclipse JEE Package muss man wie auch unter Ganymede erst das Subversive Plugin und anschließend einen Subversive Connector installieren. Man muss also zwei verschiedene Update Sites für die Installation ansprechen.

Subversive Plugin Installation

Das Subersive Plugin selbst steht unter der Eclipse Lizenz und ist somit direkt über die Eclipse Galielo Update Site http://download.eclipse.org/releases/galileo zu finden. Diese Update Site muss nicht neu hinzugefügt werden sondern ist schon im “Install new Software” Dialog (Hauptmenü->Help->Install new Software…) unter “Work with” bereits zu finden:

Wenn die Update Site ausgewählt wurde muss unter dem Punkt “Collaboration” der “Subversive SVN Team Provider (Incubation)” selektiert werden. Das ist das von Eclipse bereitgestelte Subversive Plugin:

Anschließend die Installation mit dem Button “Next” starten und den Dialog Angaben folgen.

Da noch eine weitere Installation der Subversive Connectors folgt muss Eclipse nicht dringend wie empfohlen neu gestartet werden.

Subversive Connector Installation

Nachdem das Subversive Plugin als Basis installiert wurde muss als Subversive Connector eine externe Bibliothek installiert werden. Dazu bietet Polarion wie auch schon zu Eclipse Ganymede verschiedene Connectoren an. Die benötigte Update Site URL ist http://community.polarion.com/projects/subversive/download/eclipse/2.0/galileo-site/. Diese muss im “Install new Software” Dialog (Hauptmenü->Help->Install new Software…) noch hinzugefügt werden.

Dazu die URL einfach in das “Work with” Eingabefeld kopieren und Enter drücken. Als Connectoren kann man entweder einen reinen Windows Connector (JavaHL) oder reinen Java Connector (SVNKit) verwenden. Welchen man verwenden möchte kann man selbst entscheiden. Es ist kein Problem alle angebotenen zu installieren da man diesen später noch konfigurieren kann:

Anschließend die Installation mit dem Button “Next” starten und den Dialog Angaben folgen. Eclipse nach der Installtion wie aufgefordert neu starten.

Subversive Konfiguration

Einmal installiert kann man im “Eclipse Installation Details” Dialog (Hauptmenü->Help->About Eclipse->Installation Details) die installierte Subversive Software aufgelistet sehen:

Welcher Subversive Connector verwendet werden soll kann in den Eclipse Preferences (Hauptmenü->Window->Preferences) unter Team->SVN im Reiter SVN Connector konfiguriert werden:

Einmal alles installiert und konfiguriert kann man in der SVN Perspektive nun einen SVN Repository einrichten und seine Projekte wieder mit dem SVN Repository synchronisieren.

Die Versionierungssoftware Subversion (SVN) hat mittlerweile CVS als das Tool der Wahl abgelöst und ist immer mehr auf dem Vormarsch. In Eclipse Europa (Eclipse 3.3) war das Eclipse Plugin Subclipse weit verbreitet und hat gute Dienste als SVN Client geleistet.

Mit Eclipse Ganymede (Eclipse 3.4) hat sich etwas in der SVN Unterstützung getan. Zum einen ist bisher noch keine Unterstützung Seitens Subclipse für Eclipse 3.4 erschienen und zum anderen hat Eclipse in Ganymede das Konkurrenzprodukt Subversive direkt integriert. Somit hat sich auch die Installation des SVN Clients in Eclipse Ganymede auch etwas geändert. Es wird nun zwischen dem Subversive Plugin und dem SVN Connector unterschieden. Während das Subversive Plugin von Eclipse entwickelt und gewartet wird, liegt der SVN Connector weiterhin in der Hand von polarion.org.

Folgende fünf Schritte sind notwendig um das Subversive Plugin sowie den SVN Connector von Subversive in Eclipse Ganymede zu installieren.

Installation von Subversion

[Update 01.10.2008] Nachdem mehrere Kommentare aufgetaucht sind, dass die Connectors nicht selektierbar seien oder irgendetwas anderes nicht funktioniert, habe ich den Weg nochmal bei mir druchgespielt und hier den Teil mit Screenshots geupdatet. Es waren bei mir nur fünf Schritte notwendig um mein Subversive Client zu installieren und auf mein SVN Repository zuzgreifen. Der sechste Schritt bezieht sich auf die SVN Perspektive.

• Schritt 1: Update Seites hinzufügen
• Schritt 2: Zu installierende Software selektieren
• Schritt 3: Bestätigen der zu installierenden Software
• Schritt 4: Eclipse neu starten
• Schritt 5: SVN Connector auswählen/konfigurieren
• (Schritt 6: Mit Subversion in der SVN Perspektive arbeiten)

Im Eclipse Hauptmenü “Help->Software Updates…” klicken und den Reiter “Available Software” selektieren.
Anschließend auf den “Add Site” Button klicken um die Eclipse Subversive Update Seite “http://download.eclipse.org/technology/subversive/0.7/update-site/” hinzuzufügen.

Anschließend wieder mit dem Button “Add Site” noch die Subversive Connector Update Seite “http://www.polarion.org/projects/subversive/download/eclipse/2.0/update-site/” hinzufügen:

Zum einen muss von der Eclipse Subversive Update Seite der “Subversive SVN Team Provider Plugin” installiert werden. Es reicht an der Stelle aus einfach das komplette Paket samt Unterpaketen zu selektieren.
Zum anderen muss von der Polarion Update Seite der Subversive SVN Connector selektiert werden. Ich habe hier nur die beiden SVNKit 1.1.7 und 1.2.0 selektiert. Auch hier könnte man alle selektieren, denn der Connector der später verwendet werden soll kann konfiguriert werden.

Anschließend auf den Button “Install…” drücken um die Installation zu starten. Es kann einen kleinen Moment dauern, bis alle Informationen aus dem Internet bezogen wurden.

Eigentlich nicht wirklich ein Schritt aber man sieht noch einmal deutlich, welche Packet wirklich benötigt und installiert werden.

Anschließend Eclipse neu starten. Nach einer erfolgreichen Installation erscheint auf dem Workspace die Welcome View mit einem Subversive Eintrag.

Ein SVN Connector ist bereits automatisch konfiguriert worden aber es schadet nichts das noch einmal zu überprüfen. In den Eclipse Preferences (Hauptmenü->Window-Preferences) ist unter dem Eintrag “Team->SVN” das Konfigurationspanel für die Subversion Unterstützung zu finden. Dort kann in dem Tab “SVN Connector” der zu verwendende Connector konfiguriert werden.

Hat man etwas in den Einstellungen geändert sollte das Preferences Fenster mit “OK” beendet werden.

Um mit SVN zu arbeiten steht nun eine “SVN Repository Exploring Perspektive” und dazugehörige Views zur Verfügung. Darin kann man nun ein Projekt aus einem SVN Repository aus- oder einchecken.

In Eclipse, bzw. unter Subversive, hat die Default-Projektstruktur immer die Strukturordner “trunk”, “branches” und “tags”. Erstellt man ein neues Projekt in einem SVN Repository (rechte Maustaste auf das Repository oder einem Pfad darunter->New->Project Structure…) so wird immer diese Projektstruktur automatisch angelegt und mit den von Subversive dafür definierten Symbolen dargestellt:

Nun kann auch unter Eclipse Ganymede wieder mit einer ordentlichen Source-Code-Versionierung gearbeitet werden.

ToroiseSVN

Als kleiner Tipp noch am Rande: Möchte man Subversion unter Windows auch außerhalb von Eclipse verwenden um z.B. Dokumente oder ganze Ordnerstrukturen (wie zum Beispiel für die Entwicklung des Firefox Plugins “Birthday Reminder“) zu versionieren und abzusichern dann bietet sich das freie Tool TortoiseSVN an.

Dieses fügt sich im Datei-Explorer in das Kontextmenü (rechte Maustaste) ein. So hat man die Möglichkeit direkt aus dem Datei Explorer heraus Pfade zu commiten oder zu updaten. Ein Repository Browser, Merge oder Diff Ansicht wird auch gleich mitgebracht. Einen kleinen ersten Eindruck erhält man auch in den bereitgestellten Schreenshots.

Freies Online-Buch “Version Control with Subversion”

Als letztes noch der Hinweis auf das frei verfügbare Online-Buch “Version Control with Subversion” das ausführlich die Arbeitsweise und die Handhabung von Subversion beschreibt.

Das Buch ist von O’Reilly herausgegeben, auf Deutsch übersetzt und kann als einseitige HTML Seite (ca 1.1 MB) oder mehrseitig online angesehen werden. Dieser Link sollte von jedem der mit Subversion anfängt oder arbeitet als Lesezeichen gespeichert werden.
Wer lieber PDF mag kann es sich auch als PDF ansehen oder herunterladen (ca 1.3 MB). Und wer es doch lieber kaufen möchte weil er es lieber in Papierform mag kann dies natürlich auch tun. Es ist bei Amazonzu haben.