Subversion/HowTo

Für Subversion gibt es jede Menge Clients, mit denen Projekte auf Subversion-Servern verwaltet (CRUD) verwendet können. Insbesondere biete jede IDE, wie z. B. WebStorm, Eclipse oder Visual Studio, üblicherweise einen Subversion-Client, der entweder schon integriert ist oder als Plugin nachgeladen werden kann.

Nachfolgend werden einige dieser Clients näher beschrieben.

Webdav- oder Rest-Schnittstelle

Wenn ein Subversion-Repository über eine Webdav- oder Rest-Schnittstelle zugänglich ist, können Sie die Inhalte des Repositories einfach über einen Web-Brwoser einsehen.

Beispiel: Klicken Sie einfach auf den folgenden URI:
https://glossar.hs-augsburg.de/beispiel/tutorium/es5/hello_world/

Dateivervaltung mit Subversion unter Windows

Tortoise

Tortoise ist ein Open-Source-SVN-Client für Windows.

1. Tortoise installieren.
2. Verzeichnis anlegen (z.B. „mmprog“ auf dem Desktop).
3. Rechtsklick auf den neuen SVN-Ordner:
   • Klick auf „SVN Checkout“
   • URL of Repository: <ein WebDav-Repository> (z.B. „https://glossar.hs-augsburg.de/beispiel/tutorium/es5/hello_world/“)
4. Ordner und Dateien im SVN-Ornder anlegen.
5. Rechtsklick auf den SVN-Ordner:
   • Klick auf „SVN Update“

Von nun an kann mit Hilfe von Tortoise oder einem anderen SVN-Client auf jedem netzwerkfähigen Rechner eine lokale Kopie des Repositories angelegt werden („SVN Checkout“).

Änderungen werden mit Hilfe von („SVN Update“) als neue Version ins Repostitory geschrieben.

Man kann über das TortoiseSVN-Menü auch

• neue Dateien und Ordner zum Repository hinzufügen („Add“),
• aus den nachfolgenden Versionen des Repositories löschen („Delete“; ein Löschen innerhalb der lokalen Kopie reicht nicht aus),
• in den nachfolgenden Versionen umbenennen („Rename“),
• ältere Versionen reaktivieren („Switch“)
• etc.

Insbesondere ist es möglich, verschiedene Versionen einer Datei oder eine Menge von Dateien im Repository zu vereinen („Merge“). Das kann zum Beispiel dann notwendig sein, wenn ein anderer Autor eine neuere Version einer Datei ins Repository einträgt, während man selbst noch die Vorgänger-Version lokal modifiziert.

Tortoise bietet darüber hinaus einen Repository-Browser, mit dem man jede Version des Repositories betrachten kann (Rechtsklick auf den SVN-Ordner → TortoiseSVN → Repo-browser).

SlikSVN

Installieren Sie SlikSVN wenn Sie Subversion ausschliesslich über die Kommandozeile bedienen möchten bzw. die Command Line Tools von TortoiseSVN nicht installiert haben.

Dateivervaltung mit Subversion unter Mac OS X

Nachdem die Verwendung von Subversion für MacUser komplizierter als für Windows ist, hab ich hier eine Alternative bereitgestellt. Das SC Plugin für Finder basiert auf dem TortoiseSVN für Windows und lääst sich ebenso einfach bedienen.

SC Plugin für Finder

• Webseite
• Downloadlink

Installation

dmg-Datei ausführen und SCPlugin-0.8.2-SVN.1.6.5.mpkg installieren.

Dadurch das der Server https://praktikum.multimedia.hs-augsburg.de/ keine Lizenz bereitstellt, würde eine Fehlermeldung erscheinen. Deswegen sind die nächsten 3 Schritte wichtig. (Keine Angst vor dem Terminal/Console).

1. Schritt: Terminal öffnen (über Spotlight oder über Programme Ordner

2. Schritt: folgenden Text eingeben und mit Enter bestätigen: svn list https://praktikum.multimedia.hs-augsburg.de/ Damit sprecht ihr euer Vertrauen gegenüber dem Server aus.

3. Schritt: Das Ergebnis erscheint und ihr werdet gefragt, ob ihr dem Server wirklich vertrauen wollt. Mit der Eingabe p akzeptiert ihr es für immer.

4. Schritt: In der Antwort sollte ein 200 OK nach der Serveradresse stehen. Damit habt ihr das Schwierigste geschafft.

Repository aktivieren

Im Programme Ordner sucht ihr nach SCPlugin (oder ähnliches) mit folgenden Symbol (s. unten) Dieses Icon zieht ihr in die Toolbarleiste eures Finders. Dort seht ihr jetzt das gleiche Icon.

Ein Klick darauf öffnet euch ein Menü mit allen Repository-Befehle. Ein Klick auf Checkout öffnet euch folgendes Fenster.

Dort tragt ihr eure Daten ein und wählt unten euren persönlichen Ordner aus. Ein Klick auf Checkout bestätigt alles.

Verwendung des Repository

Committen

• Ordner oder Datei auswählen.
• Aus dem Toolbarmenü Add auswählen
• Commit aus dem Toolbarmenü auswählen und alles wird hochgeladen.

Updaten

• Update aus dem Toolbarmenü auswählen und alles wird heruntergeladen.

svnX

svnX ist ein Open-Source-SVN-Client für Mac OS X (ab 10.4.9).

Installation

• Ein Subversion-Package (z.B, das von Martin Ott) ist Voraussetzung für den svnX-Client.
• svnX herunterladen.
• dmg-Datei ausführen.

Auf ein Repository zugreifen

• Repositories-Inspector öffnen (Window → Repositories)
• eine Verbindung zu einem Repository erstellen (auf + klicken)
• Name : beliebiger Name
• Path: die URL des Repository eingeben (z.B. http://glossar.hs-augsburg.de/webdav/tutorium/ )
• User und Password eingeben
• Doppelklick auf das neu angelegte Repository in der Liste (es öffnet sich neues Fenster)
• auf Checkout klicken, um den Ordner festzulegen, der mit dem Repository verbunden werden soll (es öffnet sich der Working Copies Inspector)
• Das Repository ist eingerichtet! Ab jetzt, sollte man im Repository-Inspector nichts mehr machen, es sei denn, man möchte grundlegende Änderungen vornehmen. Das Updaten, Committen, etc. sollte nur über den Working Copies Inspector geschehen.

Committen

• Im Working Copies Inspector doppelt auf das entsprechende Listenelement klicken
• die Ordner und Dateien, die man committen möchte markieren und auf Add
• wenn alle gewünschten Dateien "geaddet" wurden, auf Commit klicken

Updaten

• im Working Copies Inspector doppelt auf das entsprechende Listenelement klicken
• auf Update klicken

Leider gibt es bei der Verbindung mit HTTPS-Repositories ein Problem, falls das Zertifikat nicht von einer vertrauenswürdigen Stelle zertifiziert wurde. Damit svnX derartige Repositories akzeptiert, hilft ein Trick: eine Anmeldung mit einem anderen Client (z.B. ZigVersion - 30Tage-Trial / freie Lizenz zu non-kommerziellen Gebrauch). Alternative mit Terminal:

• svn list https://praktikum.multimedia.hs-augsburg.de/svn/kowa/
• Dann das Zertifikat permanent (p) akzeptieren.

Dateiverwaltung mit Subversion unter Eclipse

Subclipse

Subclipse ist ein Open-Source-SVN-Client für Eclipse.

Eclipse Indigo

Subclipse installieren (falls noch nicht geschehen)

1. c:\web\eclipse\eclipse.exe starten
2. Hilfe → Neue Software installieren...
3. Hinzufügen → Name: Subclipse, Position: http://subclipse.tigris.org/update_1.8.x ⇒ OK
4. Alle Pakete auswählen → Weiter → Weiter → Ich akzeptiere ... auswählen → Fertigstellen
5. Warnung akzeptieren: OK
6. Warnung akzeptieren: Jetzt neu starten

Achtung: Auf dem Rechner vorhandene lokale Kopien von Repositories, die noch mit Subclipse 1.6.x erstellt wurden, können mit Subclipse 1.8.x nicht mehr bearbeitet werden. Derartige lokale Repositories müssen gelöscht und mit Subclipse 1.8.x neu erstellt werden. (Vor einem Update von Version 1.6 auf 1.8 sollten daher alle lokalen Repositories tunlichst committed werden.)

Ein Repository eintragen

1. Fenster → Perspektive öffnen → Andere... → SVN Repository Exploring → OK
2. Rechtsklick ins Fenster SVN Repositories → New → Repository Location → <ein WebDav-Repository> (z.B. http://glossar.hs-augsburg.de/webdav/tutorium/)

Ein bestehendes Projekt aus einem Repository laden

1. Fenster → Perspektive öffnen → Andere... → SVN Repository Exploring → OK
2. Klick auf Dreiecke vor Repository-Namen und zugehörigen Unterverzeichnissen → Projekt im Repository wählen (Rechstklick) → Checkout

Ein bestehendes Projekt unter Repository-Verwaltung stellen

1. Projektperspektive wählen (Fenster → Perspektive öffnen → ...) und Projekt anlegen bzw. auswählen.
2. Rechtsklick auf das Projekt → Team → Projekt gemeinsam benutzen... → SVN → Weiter → Repository wählen → Use specific folder name → Projekt in geeignetes Unterverzeichnis des Repositories eintragen (z.B. https://praktikum.multimedia.hs-augsburg.de/svn/ACCOUNT/, wobei ACCOUNT durch die HSA-RZ-Kennung ersetzt werden muss) → Finish

Eclipse 3.4.x

Subclipse installieren

1. Help → Software Updates → Available Software → Add Site → Location http://subclipse.tigris.org/update_1.8.x
2. Mindestens Subclipse, Subversion Client Adapter und JavaHL von dieser URL installieren.

Achtung: Auf dem Rechner vorhandene lokale Kopien von Repositories, die noch mit Subclipse 1.6.x erstellt wurden, können mit Subclipse 1.8.x nicht mehr bearbeitet werden. Derartige lokale Repositories müssen gelöscht und mit Subclipse 1.8.x neu erstellt werden. (Vor einem Update von Version 1.6 auf 1.8 sollten daher alle lokalen Repositories tunlichst committed werden.)

Ein Repository eintragen

1. Window → Open Perspective → Other → SVN Repository Exploring → OK
2. Rechtsklick ins Fenster SVN Repositories → New → Repository Location → <ein WebDav-Repository> (z.B. http://glossar.hs-augsburg.de/webdav/tutorium/)

Ein bestehendes Projekt aus einem Repository laden

1. Window → Open Perspective → Other → SVN Repository Exploring → OK
2. Klick auf Dreiecke vor Repository-Namen und zugehörigen Unterverzeichnissen → Projekt im Repository wählen (Rechstklick) → Checkout

Ein bestehendes Projekt unter Repository-Verwaltung stellen

1. Projektperspektive wählen (Window → Open Perspective → ...) und Projekt anlegen bzw. auswählen.
2. Rechtsklick auf das Projekt → Team → Share Project → SVN → Next → Repository wählen → Use specific folder name → Projekt in geeignetes Unterverzeichnis des Repositories eintragen (z.B. https://praktikum.multimedia.hs-augsburg.de/svn/ACCOUNT/, wobei ACCOUNT durch die HSA-RZ-Kennung ersetzt werden muss) → Finish

Flash Builder 4.x

Subclipse installieren

1. Hilfe → Software-Updates → Suchen und installieren → Neu zu installierende Features suchen → Neue ferne Site → URL: http://subclipse.tigris.org/update_1.8.x/
2. Mindestens Subclipse, Subversion Client Adapter und JavaHL von dieser URL installieren.

Achtung: Auf dem Rechner vorhandene lokale Kopien von Repositories, die noch mit Subclipse 1.6.x erstellt wurden, können mit Subclipse 1.8.x nicht mehr bearbeitet werden. Derartige lokale Repositories müssen gelöscht und mit Subclipse 1.8.x neu erstellt werden. (Vor einem Update von Version 1.6 auf 1.8 sollten daher alle lokalen Repositories tunlichst committed werden.)

Ein Repository eintragen

1. Fenster → Perspektive → Andere... → SVN Repository Exploring → OK
2. Rechtsklick ins Fenster SVN Repositories → New → Repository Location → <ein WebDav-Repository> (z.B. http://glossar.hs-augsburg.de/webdav/tutorium/)

Ein bestehendes Projekt aus einem Repository laden

1. Fenster → Perspektive → Andere... → SVN Repository Exploring → OK
2. Klick auf Dreiecke vor Repository-Namen und zugehörigen Unterverzeichnissen → Projekt im Repository wählen (Rechstklick) → Checkout

Ein bestehendes Projekt unter Repository-Verwaltung stellen

1. Projektansicht herstellen (rechts oben im Drop-Down-Menü auf Flex Development klicken) und Projekt anlegen bzw. auswählen.
2. Rechtsklick auf das Projekt → Team → Share Project → SVN → Next → Repository wählen → Use specific folder name → Projekt in geeignetes Unterverzeichnis des Repositories eintragen (z.B. https://praktikum.multimedia.hs-augsburg.de/svn/ACCOUNT/, wobei ACCOUNT durch die HSA-RZ-Kennung ersetzt werden muss) → Finish