Quelltext der Seite Subversion (SVN)

[[Kategorie:Tools]]
Subversion ist ein Tool zur Versionsverwaltung und stellt sicher, dass mehrere Personen gleichzeitig und parallel an einem Projekt arbeiten können. Hauptaufgaben sind:
*Jeder Stand eines Projektes wird archiviert, je nach Programm nur die Änderungen: Dadurch ist es jederzeit möglich, auf alte Versionen zurückzugreifen.
*Koordinierung des gemeinsamen Zugriffs von mehreren Entwicklern auf die Dateien: Konflikte bei gleichzeitigem Speichern werden automatisch gelöst oder für manuelle Bearbeitung gemeldet.
*Gleichzeitige Entwicklung mehrerer Entwicklungszweige (engl. Branches) eines Projektes: Die unterschiedlichen Zweige können wieder zusammengeführt werden.
Subversion besteht aus einem Server, der die verschiedenen Versionen und Entwicklungszweige im {{Tooltip|Repository|Projektarchiv}} speichert und verwaltet, und Clients zur {{Tooltip|Checkout|Erstellung}}/{{Tooltip|Update|Erneuerung}} und {{Tooltip|Commit|Übergabe}} von Arbeitskopien.

== Eigenschaften ==
Automatische Übernahme der Eigenschaften wird erreicht, in dem in '''config''' {{Eingabe|1=enable-auto-props = yes}} eingetragen wird und im Abschnitt <nowiki>[auto-props]</nowiki> ausgewählt wird, welche Datei welche Eigenschaft übernimmt. Dann werden beim Hinzufügen (und nur dann) einer Datei zur Versionskontrolle die Eigenschaften übernommen.
<br />'''config''' findet man unter:
*Windows7: ...\Anwendungsdaten\Subversion\
*Linux: /etc/subversion (global) oder ~/.subversion (nutzerspezifisch).
Die Eigenschaften können nur in der Arbeitskopie geändert werden, eine Änderung fügt die Datei der {{Tooltip|Commit|Übergabe}}liste hinzu.
=== Schlüsselwörter ===
in einer Datei werden bei der Übergabe durch einen entsprechenden Text ersetzt. Mögliche Schlüsselwörter sind
* $Author$
* $Date$
* $Revision$
* $URL$
* $Id$: eine verkürzte Zusammenfassung der obigen.
Indem ein doppelter Doppelpunkt (::) nach dem Namen des Schlüsselwortes geschrieben wird, dem eine Anzahl von Leerzeichen folgt, definieren diese eine feste Breite. Falls der ersetzte Wert zu lang ist, wird er mit einem speziellen Nummernzeichen (#) unmittelbar vor dem letzten Dollarzeichen abgeschnitten<ref group="svnbook">[http://svnbook.red-bean.com/de/1.6/svn.advanced.props.special.keywords.html Subversion Book -> Ersetzung von Schlüsselwörtern]</ref>.

Um für eine Datei unter Versionsverwaltung die Schlüsselwörter zu aktivieren, müssen in die Eigenschaft svn:keywords die gewünschten Schlüsselwörter eingetragen werden<ref name="EigenschaftOrdner" />. Wenn in svn:keywords die Schlüsselwörter fehlen, wird der Schlüsselwortinhalt gelöscht und damit doch die Datei verändert.

== Globale Versionsnummer ==
Die letzte (höchste) Versionsnummer aller Dateien einer Arbeitskopie kann mit dem Komandozeilen-Tool '''svnversion'''<ref>Hilfe: <code>svnversion -h</code></ref> abgefragt werden. Nur nach einem Update wird eine eindeutige Nummer ausgegeben, sonst ein Bereich aus aktualisierten und übertragenen Versionen (168:171).<ref name="inDatei" /><ref>[[Erstellen einer Anwendung (Qt)#Build automatisieren| Automatisieren mit Qt Creator]]</ref>

== Ein lokales Repository ==
Es macht durchaus Sinn, auch auf einem Einzelplatzrechner ein {{Tooltip|Archiv|Repository}} anzulegen, zB. um ältere Stände leicht zu rekonstruieren, Änderungen erst mal in Parallelzweigen auszuprobieren oder für ein einfaches Backup.
<br />Für dieses {{Tooltip|Archiv|Repository}} benötigen wir keine sichere Passwortabfrage, aber es soll der Autor der Änderung gespeichert werden, also kein anonymer Zugriff.
<br />Aber wir benötigen einen Server. Bei '''TortoiseSVN''' ist dieser Server im Paket enthalten, unter Linux reicht uns '''svnserve''' aus dem Paket '''Subversion'''.
=== svnserve ===
'''svnserve''' muss manuell<ref>Es kann natürlich auch über die Startscripts gestartet werden, siehe [http://wiki.ubuntuusers.de/Subversion#svnserve Ubuntuusers]. Aber so häufig werden wir es nicht benutzen, das sich ein ständiger Daemon lohnt.</ref> im Terminal gestartet werden mit
{{Bsyn|lang=bash|code=svnserve -d -r /Wurzelpfad/der/Repository/}}
Voreinstellung ist, das Passwörter in KWallet<ref>bzw. gnome-keyring bei Ubuntu</ref> gespeichert werden. Das ist für ein lokales {{Tooltip|Archiv|Repository}} eher lästig (wer will schon ständig seinen Passwort-Save öffnen), deshalb erlauben wir das Speichern eines Klartext-Passworts mit <code>store-plaintext-passwords = yes</code> in /etc/subversion/servers oder ~/.subversion/servers.

== Dateien unter Versionsverwaltung stellen ==
# Ein leeres {{Tooltip|Repository|Projektarchiv}} erstellen.
# Eine Arbeitskopie erstellen (checkout).
# Dateien in die Arbeitskopie verschieben oder neu erstellen.
# Dateien zum Repository hinzufügen (add).

== Benutzung Kommandozeile ==
=== Projektarchiv erstellen ===
{{Isyn|lang=bash|code=svnadmin create file:///Pfad/zum/Archiv/}} legt das Projektarchiv ohne Unterordner an.
<br />{{Isyn|lang=bash|code=svn mkdir -m "trunk anlegen" file:///Pfad/zum/Archiv/trunk}} legt Unterordner '''trunk''' an, für Verzweigungen entsprechend Ordner '''branches''' anlegen usw.

Alternativ kann in das leere Archiv auch eine vorhandene Ordnerstruktur inkl. Dateien importiert werden:
{{Isyn|lang=bash|code=svn import -m "Projektname importieren" file:///Pfad/zum/Archiv/}}. Der importierte Ordner sollte die Struktur mit '''trunk''', '''branches''' bereits enthalten und nicht im  vorgesehenem Arbeitsordner liegen, besser irgendwas mit tmp.
=== Arbeitskopie anlegen ===
{{Isyn|lang=bash|code=svn checkout file:///Pfad/zum/Archiv/trunk Zielordner}} kopiert das {{Tooltip|Repository|Projektarchiv}} nach {{Platz|Zielordner}}, auch '.' für aktuellen Ordner. Wenn {{Platz|Zielordner}} fehlt, wird ein Ordner '''trunk''' im aktuellem Ordner angelegt. Es können statt dem {{Tooltip|trunk|Hauptpfad}} '''trunk''' auch {{Tooltip|branches|Verzweigungen}} ausgescheckt werden.
=== Status ===
{{Isyn|lang=bash|code=svn status}} gibt den aktuellen Status geänderter Dateien aus. Die Buchstaben der Ausgabe bedeuten:
*'''?''' Die Datei, das Verzeichnis oder der symbolische Link item ist nicht unter Versionskontrolle.
*'''A''' Die Datei, das Verzeichnis oder der symbolische Link item ist zum Hinzufügen in das Projektarchiv vorgemerkt.
*'''C''' Die Datei item befindet sich in einem Konfliktzustand. D.h., Änderungen, die vom Server bei einer Aktualisierung empfangen wurden, überlappen sich mit lokalen Änderungen, die Sie in Ihrer Arbeitskopie haben (und konnten beim Aktualisieren nicht automatisch aufgelöst werden). Sie müssen den Konflikt auflösen, bevor Sie Ihre Änderungen in das Projektarchiv übergeben können.
*'''D''' Die Datei, das Verzeichnis oder der symbolische Link item ist zum Löschen im Projektarchiv vorgemerkt.
*'''M''' Der Inhalt der Datei ist geändert worden.
=== Übergeben ===
{{Isyn|lang=bash|code=svn commit -m "Kommentar"}} {{Tooltip|commits|übergibt}} die Änderungen an das {{Tooltip|Repository|Projektarchiv}}. Es muss mit der Option -m ein {{Tooltip|Kommentar zur Revision|Log-Eintrag}} mitgegeben werden, oder es wird Editor<ref>Unter Linux zB. '''nano'''.</ref> für die Eingabe geöffnet. Dann einfach in die 1. Zeile den Kommentar schreiben und speichern. In der temporären(?) Datei stehen auch der [[#Status|Status]] der zu übergebenden Dateien.

== Benutzung TortoiseSVN (MS-Windows<ref>Windows7</ref>) ==
'''Gilt nicht mehr ab Version 1.7.4:''' Enthält keine Komandozeilen-Tools, bei Bedarf muss ein zusätzliches Paket installiert werden, zB. [http://www.sliksvn.com Slik SVN].

TortoiseSVN integriert SVN in die MS-Windows-Oberfläche. Im Datei-Explorer wird der Status der Dateien durch kleine Symbole angezeigt und das Kontextmenü enthält alle SVN-Befehle.
=== Zugangsberechtigungen ===
Unter Windows speichert der Subversion-Client Passwörter im Verzeichnis %APPDATA%/Subversion/auth/. Unter Windows 2000 und dessen Nachfolger verwendet der Subversion-Client die Standard-Kryptographiedienste von Windows, um das Passwort auf der Festplatte zu verschlüsseln. Da der Schlüssel durch Windows verwaltet wird und mit den benutzereigenen Zugangsdaten verknüpft ist, kann nur der Benutzer selbst das zwischengespeicherte Passwort entschlüsseln. (Beachten Sie, dass beim Zurücksetzen des Windows-Benutzerkonto-Passworts durch einen Administrator alle zwischengespeicherten Passwörter nicht mehr zu entschlüsseln sind. Der Subversion-Client verhält sich dann so, als wären sie nicht vorhanden und fragt die Passwörter gegebenenfalls ab.)<ref group="svnbook">[http://svnbook.red-bean.com/de/1.6/svn.serverconfig.netmodel.html#svn.serverconfig.netmodel.credcache Subversion Book]</ref>
=== Änderungen rückgängig machen ===
# Alle nicht abgegebene Änderungen in der Arbeitskopie entfernen (zurück auf die letzte Version im Repository):
#* Auf Datei mit rechter Maustaste -> TortoiseSVN -> Revert
# Auf eine vorherige Version zurückgehen:<br />Die Datei wird auf den alten Inhalt zurückgeändert und als geändert markiert, dh. sie hat jetzt den neuesten Revisionsstand. Die Änderung kann mit [[Subversion (SVN)#Revert|<code>Revert</code>]] rückgängig gemacht werden.
#* Auf Datei mit rechter Maustaste -> TortoiseSVN -> Show log
#* Auf gewünschte Version mit rechter Maustaste -> Revert to this Revision -> Yes
=== Alte Versionen ansehen ===
# Eine vorherige Version laden:<br />Die Datei wird nicht als geändert gekennzeichnet und somit beim nächsten Update wieder überschrieben. Nur zum Ansehen, muss hinterher mit <code>Update</code> wieder auf aktuellen Stand gebracht werden. Änderungen nicht möglich. Besser ist <code>Save revision to ..</code>.
#* Auf gewünschte Version mit rechter Maustaste -> Update to Revision -> Version eingeben
# Eine vorherige Version speichern:
#* Auf Datei mit rechter Maustaste -> TortoiseSVN -> Show log
#* Auf gewünschte Version mit rechter Maustaste -> Save revision to ..

== Benutzung kdesvn (Linux<ref>Kubuntu 12:04</ref>) ==
Als Client und Bedieneroberfläche benutzen wir '''kdesvn''' aus dem gleichnamigen Paket.
=== Repository anlegen: ===
{{Menüaktion|Datei -> Subversion-Admin -> Erstelle und öffne ein neues Repository}}.
<br />Dieses noch leere {{Tooltip|Archiv|Repository}} checken wir dann in unsere Arbeitskopie aus und fügen die gewünschten Dateien hinzu.
*Im Dateimanager: Im Arbeitkopieordner mit rechtem Mausklick -> Checkout (kdesvn)
*In '''kdesvn''': Entweder Werkzeugleistensymbol '''Auschecken''' oder besser mit '''Subversion->Repository->Checke aktuellen Repository-Pfad''' im Menü.<br />Es öffnet sich immer ein Fenster. Zu beachten ist, das in dem Feld URL die Adresse mit '''ksvn+file:''' beginnt, sonst gibt es die Fehlermeldung '... ist kein Repository'. Bei der Menüvariante wird dies automatisch gesetzt, auch der ausgewählte Zweig (zB. trunk), bei 'Dateiauswahl' nicht. Trunk kann dann manuell an die URL angehängt werden, um nur den Hauptpfad auszuchecken.<br />Wenn die Checkbox mit dem eigenartigem Text "Füge Quell-URL an das Unterverzeichnis an" gesetzt ist (Default-Einstellung), wird der ausgewählte Zweig an den Ordnernamen der Arbeitskopie angehängt. Ich will das eher nicht, wenn ich 'trunk' auschecke, also Häkchen entfernen.
<br />Voreinstellung für ein neues {{Tooltip|Archiv|Repository}} in {{Platz|/Pfad/zu/Repository}}/conf/svnserv.conf ist: anonyme Nutzer können lesen (<code>anon_access = read</code>), authorisierte Lesen und Schreiben (<code>auth_access = write</code>). Das soll auch so bleiben, wenn wir anonymen Nutzern Schreibzugriff gewähren, wird kein Autor eingetragen. Aber wir müssen eine Passwort-Datei festlegen mit <code>password-db = passwd</code> und in der Passwort-Datei (hier {{Platz|/Pfad/zu/Repository}}/conf/passwd) müssen wir einen Nutzer mit seinem Passwort eintragen mit <code>{{Platz|user}} = {{Platz|pass}}</code>. In svnserv.conf tragen wir auch noch einen  {{Tooltip|Bereich(?)|realm}} ein: <code>realm = {{Platz|zB. Programmtitel}}</code>.

== Benutzung Qt Creator (Linux<ref>Wahrscheinlich auch unter Windows, aber nicht getestet.</ref>) ==
Wenn der Projektordner eine Arbeitsplatzkopie eines Repository ist, bietet der Qt Creator unter {{Menüaktion|Extras -> Subversion}} die gängigsten Befehle. Voraussetzung ist natürlich, dass Subversion installiert ist und das unter {{Menüaktion|Extras -> Einstellungen -> Versionskontrolle -> Subversion}} der richtige Befehl 'svn', unter Umständen mit vollständigem Pfad, eingetragen ist.
Am besten den Ordner ohne Dateien auschecken und dann das Projekt in diesem Ordner anlegen. Es kann auch nachträglich der Projektordner zur Arbeitskopie gemacht werden, Extras->Subversion wird aber anscheinend erst nach Neustart sichtbar. 
== Fußnoten ==
<references>
<ref name="inDatei">Versionsnummer in eine Datei schreiben: {{Isyn|lang=bash|code=svnversion > Dateiname}} oder anhängen: {{Isyn|lang=bash|code=svnversion >> Dateiname}}</ref>
<ref name="EigenschaftOrdner">Es können für alle Dateien in einem Ordner die Eigenschaft geändert werden. Dazu muß im Kontextmenü des Ordners Eigenschaften->Subversion->Properties ausgewählt werden. Im Eigenschaften-Editor (geöffnet nach "new" oder "edit") muß dann "... recursively" angekreuzt werden.</ref>
</references>
== Qellen ==
*TortoiseSVN
<references group="Tortoise" />
*Version Control with Subversion
<references group="svnbook" />