View source for Getting Started/Sources/Subversion (de)

{{Template:I18n/Language Navigation Bar|Getting Started/Sources/Using Subversion with KDE}}

{{TutorialBrowser (de)|

series=Anfang|

name=Subversion mit KDE benutzen|
}}

== Zusammenfassung ==

Der folgende Text ist eine schnelle kde-spezifische Einführung, wie man Subversion benutzt, um auf Dateien und Software im KDE Repository zuzugreifen. Für einen vollständigen Überblick über die Fähigkeiten von Subversion verweisen wir auf das Buch "[http://svnbook.red-bean.com/ Version Control with Subversion (englisch)]".

== Am Anfang ==

Um das KDE Subversion Repository benutzen zu können, benötigen Sie zwei Dinge:

# Ein Subversion Client Programm
# Einen Zugang zu unserem Repository

Beachte: Für einen anonymen nur-lesen Zugriff benutzen Sie das Protokoll "svn", kein "yourname@" den Server "anonsvn.kde.org" statt dem unten genannten.

'''Subversion installieren:''' Eine Anleitung zur Installtion des Client Programms wird hier nicht gegeben. Sehen Sie in den Installtionsanleitungen Ihres Systems nach, um herauszufinden, wie man Subversion installiert. Sie benötigen mindesten Version 1.1. Wenn Sie Subversion selber compilieren und Sie auf das Repository per https (und nicht über svn+ssh) zugreifen wollen, benötigen Sie SSL und ZLIB Unterstützung und müssen daher die <tt>--with-ssl --with-zlib</tt> Option übergeben. 

Alternativ können Sie auch einen der zahlreich vefügbaren graphischen Clients installieren. Diese Anleitung wendet sich an personen, die nur das <tt>svn</tt> Programm benutzen und bezieht sich dabei auf Dinge die mit dem alten <tt>cvs</tt> Programm erledigt wurden.

'''Ein Benutzerkonto bekommen:''' Hatten Sie vorher ein CVS Benutzerkonto, wurde dieses zum neuen Subversion Client migriert. Wenn nicht, sehen Sie in der  [[Contribute/Get_a_SVN_Account|entsprechenden Anleitung]] nach, wie man eines bekommt. 

{{Note (de)|Wenn Sie ihr CVS Passwort verloren haben, gibt es einfache Wege, dieses zu ermitteln. Benutzen Sie [http://ktown.kde.org/~coolo/cvspwd.c cvspwd.c] pder [http://kdab.net/~dfaure/cvs-unscramble cvs-unscramble] (Perl).}}

== Die Struktur des KDE Repository  ==

 svn.kde.org/home/kde

ist die Adresse des KDE Subversion Repositorys. Das Repository wird über das HTTPS oder SVN-SSH Protokoll angesrochen, was bedeutet, dass Ihr Passwort sicher gegenüber Abhörversuche dritter ist. 

Der SSL certificate md5 fingerprint für die Repositorys ist:
 F6BF EDE2 D016 D1B2   4F18 742E 2C8F B7EF

Der SSL certificate sha1 fingerprint für die Repositorys ist:
 e1:e6:41:96:3c:eb:ae:78:e2:73:0d:a2:32:2f:6b:21:13:bf:3d:0f

Für Personen, die svn+ssh benutzen ist hier der Fingerprint des RSA Schlüssels des Servers:
 86:f3:66:06:20:74:81:d0:1b:b4:2f:25:03:f7:8e:fb

Das Repository ist in Hauptverzeichnisse organisiert:

# /branches
# /tags
# /trunk

Man kann das Repository durchforgsten über [http://websvn.kde.org/ http://websvn.kde.org/]


=== Das Unterverzeichnis /trunk ===

Das <tt>/trunk</tt> Hauptunterverzeichnis ist dasjenige, in dem die Hauptentwicklung an KDE stattfindet. Was Sie hier finden, wird als nächstes als KDE und assoziierte Programme veröffentlicht. Hier finden Sie auch das <tt>www</tt> Modul, welches die Webpages rund um KDE beinhaltet.

<tt>/trunk</tt> ist unterteilt in folgende Unterverzeichnisse:

*<tt>KDE/</tt><br/>KDE selber, welches die nächste Veröffentlichung werden wird. Es besteht aus folgenden Modulen:
**'''kdelibs''' - KDE Hauptbibliotheken, die von allen KDE Programmen benutzt werden
**'''kdebase''' - KDE Basisprogramme, wie das KDE Control Center, Plasma (die Oberfläche) und Konqueror (der Web Browser)
**'''kdeaccessibility''' - Accessibility Dateien
**'''kdeadmin''' - KDE Administrationsprogramme
**'''kdeartwork''' - Bilder, Themen, Sounds und andere künstlerische Dateien
**'''kdebindings''' - Bindungen für andere Sprache außer C++
**'''kdeedu''' - Erzieherische und Wissenschaftliche Programme für KDE
**'''kdegames''' - KDE Spiele
**'''kdegraphics''' - KDE Graphikapplicationen
**'''kdemultimedia''' - KDE Multimediaapplicationen
**'''kdenetwork''' - KDE Netzwerkapplicationen
**'''kdepim''' - KDE Personal Information Management Applicationen 
**'''kdepimlibs''' - Biblotheken, die von KDE-PIM Applicationen benötigt werden.
**'''kdesdk''' - KDE Software Development Kit Applicationen
**'''kdetoys''' - KDE Spielzeug Applicationen
**'''kdeutils''' - Allgemeine KDE Werkzeuge
**'''kdevelop''' - Das KDevelop Programm
**'''kdevplatform''' - Die Entwicklerplatform auf der KDevelop basiert
**'''kdewebdev''' - Eine KDE Webentwicklungsapplikation
*<tt>kde-common</tt>
:Allgemeines admin/ Verzeichnis
*<tt>bugs/</tt>
:[http://bugs.kde.org/ Bugzilla] Dateien
*<tt>developer.kde.org/</tt>
:Der Inhalt von developer.kde.org
*<tt>extragear/</tt>
:KDE Programme die sich außerhalb der Haupt KDE Veröffentlichungen aufhalten
*<tt>kdereview/</tt>
:Vorübergehende Heimat für all die KDE Applikationen, von denen geglaubt wird, daß sie reif für eine Veröffentlichung sind. Von hier aus werden die Applikationen entweder nach <tt>/trunk/KDE/</tt> oder nach <tt>/trunk/extragear/</tt> verschoben, sobald die größten Probleme ausgeräumt sind.
*<tt>kdesupport/</tt>
:Unterstützende Programme und Bibliotheken für KDE
*<tt>koffice/</tt><br/>Das KDE Office Paket, welches folgende Programme beinhaltet:
**'''karbon'''
**'''kchart'''
**'''kexi'''
**'''kformula'''
**'''kivio'''
**'''koshell'''
**'''kplato'''
**'''kpresenter'''
**'''krita'''
**'''kspread'''
**'''kugar'''
**'''kword'''
*<tt>konstruct/</tt>
:Konstruct, das KDE build Programm
*<tt>l10n-kde3/</tt>
:Übersetzungen für die "unstabilen" Module von KDE 3 (extragear, playground)
*<tt>l10n-kde4/</tt>
:Übersetzungen für KDE 4
*<tt>playground/</tt>
:Der KDE Spielplatz: Applications die gerade entwickelt werden aber noch keine Veröffentlichungsqualität erreicht haben.
*<tt>qt-copy/</tt>
:Zu Vereinfachung eine Kopie von  [http://www.trolltech.com/ Trolltechs] Qt Bibliothek, auf welcher KDE basiert.
*<tt>tests/</tt>
:khtml, KOffice und ksvg Testfälle
*<tt>valgrind/</tt>
:Die Valgrind Application, welche im KDE Repository betreut wird jedoch kein Teil von KDE selber ist. Neuere Versionen von Valgrind werden in einem eigenen Repository entwickelt. Das KDE Valgrind Modul beinhaltet nur Valgrind bis zur Version 2.4.
*<tt>www/</tt>
:Webpages für die KDE Site (und verwandte Sites). Schreibzugriff auf dieses Verzeichnis ist beschränkt.

=== Das Unterverzeichnis <tt>/tags</tt> ===

Dieses Verzeichnis beinhaltet die offiziellen Veröffentlichung von den Programmen die im KDE Repository verwaltet und entwickelt werden. Jede einzelne Applikation hat hier ein Unterverzeichnis, innerhalb von diesem finden Sie die Release-Nummern.

So kann zum Beispiel der Code für KDE 3.4.0 unter <tt>/tags/KDE/3.4.0/</tt> gefunden werden.

=== Das Unterverzeichnis <tt>/branches</tt> ===

Dieses Verzeichnis beinhaltet die Zweig-versionen von Applikationen nach einer Hauptveröffentlichung. 

Die meisten KDE Applikationen halten sich an die Philosophie, dass neue Features (ebenso wie neue Zeichneketten für den Benutzer) erst im nächsten Veröffentlichungszyklus &#8212; derjenige der in <tt>/trunkg/</tt> entwickelt wird &#8212; einfließen. Fehlerbereinigungen werden jedoch auf alle Applikationen angewandt, auch nach einer Veröffentlichung.

Um das zu bewerkstelligen, wird ein Zwei in dem Moment der Veröffentlichung erzeugt und zeigt damit den Status dieser Dateien zu diesem Zeitpunkt an. Fehlerbereinigungn werden dann in diese Dateien eingepflegt. Diese Zweige sind dann diejenigen die unter <tt>/branches/</tt> zu finden sind. 

So kann zum Beispiel der KDE 3.4.x Zweig unter <tt>/branches/KDE/3.4/</tt> gefunden werden.

Die Unterverzeichnisse die Sie in <tt>/branches</tt> finden, sie die Unterverzeichnisse der Aplikationen wie <tt>akregator/</tt>, <tt>amarok/</tt>,
<tt>arts/</tt>, <tt>k3b/</tt>, etc. Sie finden hier auch ein <tt>KDE/</tt>
Unterverzeichnis, welches die offiziellen KDE Veröffentlichung beinhalten.

Es gibt ein spezielles Unterverzeichnis in <tt>/branches</tt> namens <tt>work/</tt>. Dieses Unterverzeichnis wird als "Arbeitszweig" berzeichnet und beinhaltet Zweige bei denen an neuen Features gearbeitet wird. Manchmal sind diese sehr experimentell. Arbeitszweige für mehrere Applikationen finden sich in <tt>/branches/work/</tt>, doch für einzelne Applikationen finden sich Arbeitszweige im jeweiligen Unterverzeichnis. Diese Entscheidung liegt bei den Entwicklern. 

== Auschecken und Aktualisieren ==

=== Auschecken ===
Um entwas aus Subversion auszuchecken benutzt man das Unterkommando <tt>checkout</tt>:

'''WARNUNG:''' Wenn Sie trunk/KDE oder branches/KDE/foo auschecken werden Sie auch die komplette kde-i18n herunterladen!

Angenommen Sie wollen nur KDevelop aus dem KDE Repository auschecken, würden Sie folgende Kommandos eingeben:

CVS Kommando:
 cvs -d :pserver:yourname@cvs.kde.org:/home/kde login
 cvs -d :pserver:yourname@cvs.kde.org:/home/kde checkout kdevelop

Subversion Kommando:

CVS Benutzer die einen ssh Zugang besitzen, sollten das Protokoll svn+ssh,
CVS Benutzer, die einen Passwortzugang benutzen sollten das Protokoll https im folgenden benutzen.

 svn checkout &lt;protocol&gt;://&lt;username&gt;@svn.kde.org/home/kde/trunk/KDE/kdevelop

=== Aktualisieren ===
Um zu aktualisieren, benutzen Sie das <tt>update</tt> Unterkommando.

Hier gibt es keinen Unterschied zu CVS: Sie wechseln in ihre ausgecheckte lokale Kopie (für diejenigen, für die das alles neu ist: die ausgecheckte Kopie sollte sich in Ihrem Heimatordner befinden) und geben ein <tt>svn update</tt> Kommando (oder kürzer <tt>svn up</tt>). 

== Den Status einer Datei ermitteln ==

Um herauszufinden welche lokalen Dateien verändert wurden, haben die meisten unter CVS das Kommando cvs up aufgerufen und dann diejenigen Dateien gesucht, die mit einem '''M''' markiert waren. Das funktioniert unter svn nicht, daher müssen Sie das Kommando <tt>svn status</tt> aufrufen, um den Status der Dateien zu ermitteln.

== Ins Repository hochladen ==

Um Änderungen hochzuladen ruft man, ähnlich wie bei CVS, die Unterkommandos <tt>commit</tt> oder <tt>checkin</tt> (Kurzversion davon <tt>ci</tt>) auf.

CVS Kommando:
 cvs commit
 # oder
 cvs ci
 # oder
 cvs ci filename.cpp

Subversion Kommando:
 svn commit
 # oder
 svn ci
 # oder
 svn ci filename.cpp

Auf diese Weise wird <tt>svn</tt> den in <tt>$SVN_EDITOR</tt> eingetragenen Texteditor aufrufen, damit Sie das Änderungsprotokoll ausfüllen können. Wenn Sie es vorziehen, können Sie <tt>svn</tt> auch über die -m Option eine vollständige Mitteilung übergeben:

 svn ci -m "Updating protocol to conform to HTTP/1.1"

== Dateien ignorieren ==

Subversion speichert die zu ignorierenden Dateien für jedes Verzeichnis. Um diese Liste für das aktuelle Verzeichnis zu bearbeiten, rufen Sie einfach
  svn propedit svn:ignore .
auf. Damit wird der eingestellte Editor aufgerufen, in dem Sie die Namen der Dateien eintragen können, die ignoriert werden sollen, eine Datei pro Zeile. Wenn Sie fertig sind, einfach ein commit ausführen, damit die Dateien auf dem Server aktualisiert werden.

Eine Menge Dateien wurden bei CVS mit Hilfe der globalen Ignorierliste ignoriert, diese Liste wird von SVN nicht unterstützt. Sie können auf svn 1.3 warten oder Sie müssen die Ignorierliste in die Sammelgruppe in ihrer {{path|~/.subversion/config}} einfügen (alle in einer Zeile):

 global-ignores = *.o *.lo *.la .*.rej *.rej .*~ *~ .#* #*# .DS_Store *.moc
 *.moc.cc *.moc.cpp config.log config.status config.cache *.gmo .deps .libs
 SunWS_cache *.lo *.la *.rpo *.la.closure *_la_closure.cpp *_la_closure.cc
 *_la_closure.cxx *.all_cc.cc *.all_cpp.cpp *.all_C.C *.all_cxx.cxx
 *_meta_unload.cc *_meta_unload.h *_meta_unload.cpp *_meta_unload.C
 *_meta_unload.cxx index.cache.bz2 .memdump Makefile.rules.in Makefile.calls.in
 Makefile.rules Makefile.calls autom4te.cache *.kidl

== Mit verschiedenen Revisionen und Branches arbeiten ==

Andes als CVS erzeugt Subversion keine Revisions-Nummer für jede veränderte Datei. Statt dessen wird das gesamte Repository als ganzes mit einer Revisions-Nummer versehen. Auf diese Art bezeichnet eine Revisions-Nummer einen bestimmten Status, den das Repository zu einem bestimmten Zeitpunkt hatte. In anderen Worten: Die Revisions-Nummer ist wie ein Zeitstempel (tatsächlich benutzt der Subversion-Server diesen Umstand, um schneller nach Daten im Repository zu suchen)

Wenn Sie also einen Check-out machen, teilt Ihnen Subversion das folgende (als Beispiel) mit:

 Updated to revision 403821.

Das bedeutet, dass die letzte verfügbare Revision zu dem Zeitpunkt der Operation die Nummer 403821 ist. Wenn Sie eine Änderung vornehmen und abschicken (per commit), wird Subversion serverseitig die Revision aktualisiert und Sie davon in Kenntnis setzen. Wie in CVS werden nur die veränderten Dateien aktualisiert: Sie müssen <tt>cvs up</tt> aufrufen um den Rest der Dateien zu aktualisieren.

Möchten Sie eine bestimmte Revsision eine Dateie haben, können Sie den <tt>-r</tt> Schalter benutzen. Neben der Revisions-Nummer akzeptiert -r eine Anzahl von weiteren Möglichkeiten:
  
* Die Revision-Nummer: Benutzen Sie beispielsweise -r 403819 um diese Version zu erhalten
* '''BASE''': Die Revision zu der Sie aktualisiert haben
* '''COMMITTED''': Die Revision an der eine Datei vor BASE zuletzt verändert wurde.
* '''PREV''': Die Revision des vorigen commits vor COMMITTED
* '''HEAD''': Die akuellste Revision die auf dem Server verfügbar ist
* '''{ date }''': Zwischen den geschwungenen Klammern kann ein Datum angegeben werden, damit die daran nähsten Änderungen gesucht werden

Das folgende dienst der Darstellung der verschiedenen Bedeutungen der Schlüsselworte:

# Wenn mann <tt>svn up</tt> aufruft, aktualisiert man zur neusten Revision. Angenommen Subversion teilt einem mit, dass man auf Revision 403821 aktualisiert hat, dann bedeutet das, dass HEAD und BASE die Revision 403821 haben.
# Wenn man die Datei README bearbeitet und hochläd (commit), teilt einem Subversion mit, dass man die Revision 403822 hochgeladen hat. Das bedeutet HEAD, BASE und COMMITTED sind 403822.
# Jetzt wird README erneut bearbeitet und hochgeladen (via commit). Jetzt ist PREV 403822 aber HEAD, BASE und COMMITTED sind zu einem neueren Wert aktualisiert (sagen wir zum Beispiel 403823)
# Nun verändert jemand anderes das Repsitory und man selber führt ein update der Arbeitskopie durch. Subversion teilt einem mit, dass man auf 403824 aktualisiet hat, das bedeutet, dass HEAD und BASE nun auf 403824 aktualisert wurden (doch PREV und COMMITTED bleiben gleich)
# Wenn nun jemand README bearbeitet, HEAD wird verändert. Die anderen Schlüsselworte bleiben für einen selber jedoch gleich, bis man ein update durchführt. Zu diesem Zeitpunkt haben wir HEAD bei 403825 (die neuste verfügbare Revision), BASE = 403824 (die Revision, auf die zuletzt aktualisiert wurde), COMMITTED = 403823 (die Revision der letzten Änderung an der Datei als man zuletzt aktualisiert hat) und PREV = 403822 (die Revision der Änderung vor COMMITTED)

Diese Schlüsselworte sind auch nützlich um logs und diffs für Aktualisieirungen des Repositorys zu erhalten.

Wenn man sich den Unterschied zwischen der Arbeitskopie und BASE ansehen möchte, kann man 

 svn diff

aufrufen. Das ist eine sehr schnelle Operation, da Subversion eine lokale Kopie von BASE bereithält. Man benötigt keine Netzwerkverbindung um diese Operation durchzuführen.

Möchte man den Unterschied zwischen der lokalen Kopie und der letzten verfügbaren Version auf dem Server betrachten, ruft man

 svn diff -r HEAD

auf. Möchte man sehen, was sich seit dem letzten Update am Repository geändert hat, ruft man 
 svn diff -r BASE:HEAD

auf. Möchte man die letzte Änderung an einer Datei vor BASE sehen, kann man 
 svn diff -r PREV:BASE
 # oder
 svn diff -r PREV:COMMITTED

aufrufen. Das gleiche gilt auch für das <tt>svn log</tt> Kommando.

== Unterverzeichnisse von anderen Orten verlinken ==

Es kann vorkommen, dass man eine Kopie eines Unterverzeichnissen von einem anderen Ort einfügen möchte. Das geschieht dann aus Bequemlichkeit und nicht um in diesem Verzeichnis Code zu schreiben. Natürlich sollte dieses Verzeichnis automatisch aktualisiert werden wann immer das Original sich ändert. Subversion kann einem dabei helfen. Man muss die Eigenschaft <tt>svn:external</tt> des Verzeichnisses bearbeiten und das Verzeichniss sollte hinzugefügt werden. Für das aktuelle Verzeichnisse benutzt man den Befehl 

 svn propedit svn:externals .
und gibt die Zeile
 libkhalkhi svn://anonsvn.kde.org/home/kde/trunk/playground/pim/khalkhi
ein. Ein Update wird nun <tt>/trunk/playground/pim/khalkhi</tt> in das Unterverzeichnis <tt>libkhalkhi</tt> holen.

{{warning (de)|Es können jedoch keine Änderungen an der lokalen Kopie des externen Verzeichnisses hochgeladen werden, denn es ist eine nur-lesen Kopie.}}

Man kann <tt>svn://anonsvn.kde.org</tt> und kein anderes Protokoll verwnden, denn <tt>anonsvn.kde.org</tt> ist für jeden zugreifbar. Das <tt>https:</tt> oder <tt>svn+ssh:</tt> Protokoll wird nur für Benutzer funktionieren, die damit arbeiten. Es gibt noch ein paar kleine Nachteile mit <tt>anonsvn.kde.org</tt>: 
Es ist nicht immer mit <tt>svn.kde.org</tt> synchronisiert, daher brauchen aktualisierungen im Originalast eine Zeit bis sie auf <tt>anonsvn.kde.org</tt> erscheinen. Außerdem blockieren eine strenge Firewalls das <tt>svn:</tt> Protokoll.

Ein spezieller Fall in KDE 3 ist das Unterverzeichnis <tt>admin</tt>, welches die KDE 3 build Werkzeuge beinhaltet. Es ist mit dem Hauptverzeichnis in allen Modulen verzeichnet und wird in <tt>/branches/KDE/3.5/kde-common</tt> bearbeitet. Für <tt>admin</tt> ist der KDE subversion Server so konfiguriert, dass es für alle einen nur-lesen Zugriff gestattet. Wenn man also 
 admin https://svn.kde.org/home/kde/branches/KDE/3.5/kde-common/admin
sieht, besteht kein Anlass das zu ändern.

== Mehr Informationen im KDE Wiki ==

Siehe auch [http://wiki.kde.org/tiki-index.php?page=KDE%20Subversion%20HOWTO the KDE wiki] für mehr Informationen über Subversion in KDE