Languages: عربي | Asturianu | Català | Česky | Kaszëbsczi | Dansk | Deutsch | English | Esperanto | Español | Eesti | فارسی | Suomi | Français | Galego | Italiano | 日本語 | 한국어 | Norwegian | Polski | Português Brasileiro | Română | Русский | Svenska | Slovenčina | Slovenščina | српски | Türkçe | Tiếng Việt | Українська | 简体中文 | 繁體中文
| Anleitungsserie | Anfang |
| Voriges Kapitel | None |
| Nächstes Kapitel | n/a |
| Weiterführende Texte | n/a |
| Navigation | Deutsche Startseite |
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 "Version Control with Subversion (englisch)".
Um das KDE Subversion Repository benutzen zu können, benötigen Sie zwei Dinge:
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 --with-ssl --with-zlib Option übergeben.
Alternativ können Sie auch einen der zahlreich vefügbaren graphischen Clients installieren. Diese Anleitung wendet sich an personen, die nur das svn Programm benutzen und bezieht sich dabei auf Dinge die mit dem alten cvs 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 entsprechenden Anleitung nach, wie man eines bekommt.
 |
|---|
| Anmerkung |
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:
Man kann das Repository durchforgsten über http://websvn.kde.org/
Das /trunk 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 www Modul, welches die Webpages rund um KDE beinhaltet.
/trunk ist unterteilt in folgende Unterverzeichnisse:
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 /tags/KDE/3.4.0/ gefunden werden.
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 — derjenige der in /trunkg/ entwickelt wird — 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 /branches/ zu finden sind.
So kann zum Beispiel der KDE 3.4.x Zweig unter /branches/KDE/3.4/ gefunden werden.
Die Unterverzeichnisse die Sie in /branches finden, sie die Unterverzeichnisse der Aplikationen wie akregator/, amarok/, arts/, k3b/, etc. Sie finden hier auch ein KDE/ Unterverzeichnis, welches die offiziellen KDE Veröffentlichung beinhalten.
Es gibt ein spezielles Unterverzeichnis in /branches namens work/. 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 /branches/work/, doch für einzelne Applikationen finden sich Arbeitszweige im jeweiligen Unterverzeichnis. Diese Entscheidung liegt bei den Entwicklern.
Um entwas aus Subversion auszuchecken benutzt man das Unterkommando checkout:
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 <protocol>://<username>@svn.kde.org/home/kde/trunk/KDE/kdevelop
Um zu aktualisieren, benutzen Sie das update 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 svn update Kommando (oder kürzer svn up).
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 svn status aufrufen, um den Status der Dateien zu ermitteln.
Um Änderungen hochzuladen ruft man, ähnlich wie bei CVS, die Unterkommandos commit oder checkin (Kurzversion davon ci) 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 svn den in $SVN_EDITOR eingetragenen Texteditor aufrufen, damit Sie das Änderungsprotokoll ausfüllen können. Wenn Sie es vorziehen, können Sie svn auch über die -m Option eine vollständige Mitteilung übergeben:
svn ci -m "Updating protocol to conform to HTTP/1.1"
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 ~/.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
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 cvs up aufrufen um den Rest der Dateien zu aktualisieren.
Möchten Sie eine bestimmte Revsision eine Dateie haben, können Sie den -r Schalter benutzen. Neben der Revisions-Nummer akzeptiert -r eine Anzahl von weiteren Möglichkeiten:
The following illustrates the evolution of the keywords:
Those keywords are useful to retrieve logs and diffs for commits to the repository.
If you want to see the difference between your working copy and BASE, you can run:
svn diff
This is a very fast operation, since Subversion keeps a local copy of BASE. It doesn't need a network connection to accomplish this operation.
If you want to see the difference between your local copy and the latest available on the server, you will run:
svn diff -r HEAD
If you want to see what has changed in the repository since you've last updated, you can use:
svn diff -r BASE:HEAD
If you want to see the last change to a file before BASE, you can use:
svn diff -r PREV:BASE # or svn diff -r PREV:COMMITTED
That is also valid for the svn log command.
It can happen you would like to include a copy of a subdirectory from another place, but just for convenience, not for developing the code in there. Of course it should be updated automatically whenever the original changes. Subversion can help you. You need to edit the property svn:external of the directory the subdirectory should be added to. So for the current directory you use
svn propedit svn:externals .
and then enter lines of the form
libkhalkhi svn://anonsvn.kde.org/home/kde/trunk/playground/pim/khalkhi
Updating will now fetch /trunk/playground/pim/khalkhi into the subdirectoy libkhalkhi.
 |
|---|
| Warnung |
You use svn://anonsvn.kde.org and not another protocol, because anonsvn.kde.org is accessible to everyone. Using https: or svn+ssh: would only work for users of that protocol. There are still some small disadvantage with anonsvn.kde.org: It is not always in synchronization with svn.kde.org, so updates in the original branch may take a while to appear on anonsvn.kde.org. And some strict firewalls are blocking the svn: protocol.
A special case in KDE 3 is the subdirectory admin, containing the KDE 3 build utilities. It is linked in to the top directory in all modules, and maintained in /branches/KDE/3.5/kde-common. For admin the KDE subversion server is configured to allow readonly access for everyone, so if you see
admin https://svn.kde.org/home/kde/branches/KDE/3.5/kde-common/admin
there is no need to change this.
Siehe auch the KDE wiki für mehr Informationen über Subversion in KDE
KDE TechBase 