Benutzerhandbuch zu KDevelop: CVS Integration

Weiter Zurück Inhaltsverzeichnis

### 13. CVS Integration

KDevelop unterstützt auch die Verwaltung Ihrer Projekte mit Hilfe von CVS Archiven. CVS (Concurrent Version System) hat zum Ziel, Gruppen von Entwicklern das voneinander unabhängige Arbeiten am gleichen Quellcode zu ermöglichen und die Änderungen im Repositorium zu verschmelzen. Normalerweise befindet sich das Repositorium auf einem Server. Das anfängliche Archiv enthält einen Grundstock an Dateien; die Verzeichnisse und Dateien werden dann von den Entwicklern dem CVS hinzugefügt oder aus ihm entfernt.

Der Entwickler arbeitet lokal mit seiner Kopie des CVS Baumes. Er nimmt die Änderungen an seinen Dateien vor und testet, ob sein Projekt weiterhin arbeitet, wenigstens insoweit, daß unvollständige Quellen nicht die Arbeit der anderen Entwickler, die seine Änderungen erhalten, behindern oder unmöglich machen.

### 13.1 Erzeugen eines CVS Archivs

Wenn Sie ein neues Projekt mit KDevelop erstellen, können Sie dieses Projekt direkt als CVS-Modul importieren. Um dies einzuschalten, muß CVS installiert sein ( das sollte bereits der Fall sein, wenn nicht, passen Sie Ihre Systeminstallation an oder kontaktieren Sie Ihren Systemadministrator).

Wählen Sie "CVS" auf der dritten Seite des Application Wizard (VCS Unterstützung). Dadurch werden die Eingabefelder auf dieser Seite aktiviert und Sie können die Importparameter eingeben. Der AppWiz wird daraufhin Ihr Projekt als Modul in das CVSROOT Verzeichnis importieren und Ihr Projekt als lokale Kopie des zugehörigen CVS Verzeichnisses erstellen, d.h. Sie arbeiten immer mit einer Kopie Ihres Projektes.

Achtung: Damit Sie ein Archiv erstellen können, benötigen Sie Schreibrechte im CVSROOT Verzeichnis ! Außerdem muß sich das Rootverzeichnis auf derselben Maschine wie KDevelop befinden ! Wenn Sie Ihr Archiv auf einem Remote Server haben wollen, müssen Sie entweder Kontakt mit dem Systemadministrator aufnehmen, damit dieser ein Archiv auf dem Server anlegt, oder Sie führen die folgenden Schritte aus:

- Erstellen Sie Ihr Projekt lokal
- Importieren Sie das Projekt als Modul auf den CVS Server
- Löschen Sie den lokalen Projektverzeichnisbaum
- Checken Sie das Modul vom CVS Server aus
- Schalten Sie, nachdem Sie das Projekt geladen haben, die CVS-Unterstützung in den Projektoptionen ein. Wie Sie die Unterstützung einschalten können, wird weiter unten beschrieben.

Für weitere Details zu den CVS Kommandos, konsultieren Sie bitte Ihre Systemhilfe, z.B. indem Sie `man cvs` eingeben.

Im folgenden, werden wir die Optionen beschreiben, die zur Verfügung stehen, wenn Sie ein Archiv mit dem KAppWizard erzeugen.

VCS Verzeichnis:

  Dies ist das CVS Rootverzeichnis, in das der Projektverzeichnisbaum importiert wird, und in dem Commits, Checkouts und Updates ausgeführt werden.

Archiv in VCS

  Dies ist der Modulname für Ihr Projekt. Da es der Name Ihres Projektverzeichnisses ist, können Sie ihn nicht ändern.

Vendor Zeichen

  Dies ist das Zeichen für den kompletten Zweig.

Log Nachricht

  ist die erste Log-Nachricht des neuen Moduls. Wenn Sie Dateien zum Archiv hinzufügen oder commiten, werden Sie jedesmal nach einer Log-Meldung gefragt, um die Änderungen zu dokumentieren.

Release Zeichen

  Dies gibt an, unter welchem Zeichen Ihr Projekt gefunden werden kann. Das bedeutet, Sie können mehrere Module mit dem gleichen Namen im CVS haben, die sich aber in diesem Zeichen unterscheiden, Sie haben also verschiedene Zweige Ihres Projekts. Beispiel: KDE 2 wird unter dem HEAD (Standardzweig) entwickelt, KDE 1.1.2 hat das Zeichen (den Tag) KDE_1_1_2_RELEASE.

Nachdem Sie Ihr Projekt mit dem Applicattion Wizard erstellt haben, ist die CVS Unterstützung für Ihr Projekt eingeschaltet (wenn Sie dies ausgewählt haben), Sie können also Änderungen, wie im Abschnitt "Verwendung von CVS Kommandos" beschrieben, commiten und hinzufügen.

### 13.2 Einschalten der CVS Unterstützung

Da CVS Unterstützung im allgemeinen nur von professionellen Entwicklern oder Firmen, sowie von KDE Entwicklern, die Ihre Projekte über den KDE CVS Server verwalten benötigt wird, ist die Verwendung der CVS Kommandos in KDevelop optional. Die CVS Unterstützung kann eingeschaltet werden, indem Sie im Projekt Optionen Dialog die Einstellung für Versionskontrolle auf "CVS" ändern.

### 13.3 Verwendung von CVS Kommandos

Damit stehen Ihnen die folgenden Kommandos unter LFV und RFV zur Verfügung:

Für Dateien die nicht im Archiv sind:

- Zum Archiv hinzufügen: Fügt die Datei zum Archiv hinzu. Die Datei wird als hinzuzufügen markiert, wird aber erst beim nächsten `Änderungen einspielen` tatsächlich dem Archiv hinzugefügt.

Für Dateien die bereits im Archiv sind:

- Aktualisieren: Update der ausgewählten Datei von der CVS Version
- Änderungen einspielen: Führt ein "commit" der ausgewählten Datei in das CVS Archiv aus
- Vom Archiv entfernen: Entfernt die Datei aus dem Repositorium

Für Verzeichnisse:

- Zum Archiv hinzufügen: Fügt den Order zum Repositorium hinzu
- Vom Archiv entfernen: Entfernt das Verzeichnis aus dem Repositorium
- Aktualisieren: Synchronisiert das Verzeichnis rekursiv mit dem CVS Archiv
- Änderungen einspielen: Führt ein rekursives "commit" in das CVS Archiv aus

Die CVS Kommandos benötigen eine funktionierende Netzverbindung zum CVS Server. Wenn Sie ein Kommando aufrufen, sehen Sie einen Dialog der Ihnen anzeigt, welches Kommando gesendet wurde und wie die Antwort des Servers war. Dadurch haben Sie eine Kontrolle darüber, welche Aktionen tatsächlich durchgeführt wurden, und ob Ihr Kommando erfolgreich abgeschlossen werden konnte.

Da die CVS Kommandos von KDevelop nur mit dem `cvs` System Kommando und dessen Kommandozeilenoptionen arbeiten, sollten Sie keine Probleme haben CVS zu benutzen.

Weiter Zurück Inhaltsverzeichnis