Wie benutzt man TortoiseSVN

Transkript

1 Wie benutzt man TortoiseSVN 1

2 Inhaltsverzeichnis 1.Benötigte Vorkenntnisse Benötigte Software Schritt 1 Software installieren Schritt 2 einen Ordner anlegen Schritt 3 Projekt auschecken Schritt 4 Nach dem bearbeiten wieder übertragen Dateien Sperren...8 2

3 1. Benötigte Vorkenntnisse Um diese Anleitung zu verstehen muss man folgendes können/wissen. Grundkenntnisse der Installation von Software auf einem Windows System. Anlegen eines Verzeichnisses im Explorer. Englischkenntnisse sind von Vorteil aber nicht zwingend nötig. 2. Benötigte Software TortoiseSVN Es bietet sich an neben dem Programmpaket auch die Sprachdatei und den Spellchecker herunterzuladen. Windows inkl. einer gültigen Lizenz 3. Schritt 1 Software installieren Wie man genau Software installiert möchte ich an dieser Stelle nur mit dem Satz an den PoolRanger erklären: Ja wie? Windows- Klicki-Bunti! Doppelklick drauf und es geht.. Man sollte allerdings erst nur das Programmpaket installieren. Nach der Installation verlangt das Setup nach einem Neustart der nötig ist. Das Sprachpaket und den Spellchecker sollte man erst nach dem Neustart installieren. Diese Programmteile brauchen keinen Neustart nach der Installation. 4. Schritt 2 einen Ordner anlegen Um ein Projekt aus dem Subversion auszuchecken, muss man einen Ordner anlegen der die Daten aufnimmt. Er sollte auch einen Namen haben, sodas man ihn wiederfinden kann. 3

4 5. Schritt 3 Projekt auschecken Nachdem man den Ordner angelegt hat, kann man das Projekt auschecken (engl. Checkout) Nach einem klick auf SVN Auschecken... (in der englischen Sprachversion analog dazu SVN Checkout) erscheint ein Dialogfenster zum einstellen der Optionen zum auschecken. In diesem Beispiel befinden wir uns im FS-LAN, sollte man von zuhause aus oder per Uni- WLAN versuchen über etwas auszuchecken, wird man nur eine Fehlermeldung erhalten. britzel muss dann selbstverständlich durch de ersetzt werden. Die in diesem Beispiel angegebene URL bezieht sich auf das Spannungs- 4

5 quelle Repository das über sq zu erreichen ist. Der Zielordner ist automatisch auf den Ordner gestellt auf dem man das Kontextmenü aufgerufen hat. Das Repository der Spannungsquelle enhält mehrere Ordner die Unterversionen sog. Branches enthalten oder anderweitig speziell markiert sind. Damit man nicht am Ende zig mal den nahezu gleichen Inhalt auf der Festplatte hat, muss man über das Projektarchiv auswählen was man auschecken will. Man erreicht es über einen Klick auf den Button neben dem Feld zur Eingabe der URL des Projektarchivs. Es erscheint dann ein Fenster das das Projektarchiv als Baumstruktur darstellt. Über das kleine + Zeichen kann man wie im Explorer den Baum aufklappen und im Falle der Spannungsquelle den Branch wählen den man auschecken möchte. Nach dem Bestätigen mit OK landet man wieder auf dem vorhergehenden Dialog zum auschecken. 5

6 Wie auf dem Screenshot zu sehen ist, wurde die URL erweitert und der Pfad zum Branch hinzugefügt. Wenn man nun nochmal mit OK bestätigt, wird man im Regelfall nach Benutzernamen und Passwort gefragt. Wie bei fast allem ist das dann der Fachschftslogin. Anschließend beginnt der Checkout. Wenn er fertig ist, wird der OK Button aktiviert. 6

7 Anschließend sollte man alles in seinem lokalen Verzeichnis haben. 6. Schritt 4 Nach dem bearbeiten wieder übertragen Wenn man neue Dateien hinzugefügt hat, oder bestehende geändert muss man alles ja wieder auf den Server übertragen. In der englischen Version nennt sich das dann Commit. Nach einem Klick auf den Eintrag im Kontextmenü erscheint ein Dialog, der im unteren Bereich die Änderungen anzeigt, es sind ebenfalls noch nicht im Repository hinterlegte Dateien aufgeführt. Wenn man sie hinzufügen möchte muss man sie mit einem Häkchen markieren. Oben ist die Möglichkeit geben kurz zusammenfassend anzugeben was man geändert hat. Das erleichtert später das finden der Version wenn irgendwo ein Fehler gemacht wurde, der aber erst später erkannt wird. 7

8 7. Dateien Sperren Es bietet sich an bestehende Dateien bevor man sie bearbeitet mit einem Lock (auf deutsch Sperre) zu versehen. Durch das Lock wird verhindert das andere Benutzer, solange die Sperre aktiv ist, Änderungen an der Datei auf den Server übertragen können. 8

9 Dieses Feature ist sehr praktisch um Konflikten aus dem Weg zu gehen wenn 2 oder mehr Benutzer gleichzeitig eine Datei ändern und dann übertragen wollen. Allerdings kann ein vergessener Lock die Arbeit von anderen behindern. Deshalb sollte man zum einen, einen guten Grund für den Lock angeben, evtl mit dem voraussichtlichen Zeitpunkt des Entsperrens. Sollte man beim Übertragen den Haken bei Sperren erhalten gesetzt haben ist es wichtig die Dateien wenn man die Sperre nicht mehr benötigt wieder freizugeben. 9