Benutzerhandbuch zu KDevelop: Installation

Weiter Zurück Inhaltsverzeichnis

### 2. Installation

### 2.1 Verfügbarkeit von KDevelop

KDevelop kann entweder auf der KDE Applikations-Seite ( http://www.kde.org/current.html) oder auf der KDevelop Homepage ( http://www.kdevelop.org) bezogen werden. Ebenso ist KDevelop auf Linux-Distributionen vorhanden, wie z.B. SuSE Linux 6.1.

Wir bieten außerdem wöchentliche Snapshots des KDevelop CVS Repositories auf unserer Homepage an für die, die auf dem aktuellen Stand von KDevelop sein wollen. Für gewöhnlich sind die Snapshots jedoch nicht zur Produktion geeignet, sondern zum Testen neuer Features und zum Einblick in den Entwicklungsfortschritt des KDevelop Teams. Außerdem bieten wir verschiedene Software von dritter Seite an, die von KDevelop benötigt werden wie KDoc und KDbg.

Wenn Sie Probleme mit der Compilierung oder Benutzung von KDevelop haben, lesen Sie bitte das Kapitel Fragen und Antworten dieses Handbuchs oder die FAQ-Datei, die im KDevelop-Paket enthalten ist. Sollte Ihr Problem nicht behandelt sein, tragen Sie sich in die KDevelop Mailingliste kdevelop-request@barney.cs.uni-potsdam.de ein, indem Sie eine Email mit leerer Kopfzeile und "subscribe ihrer-email-addresse" als Inhalt an obige Adresse senden. Anfragen und Problemberichte sollten sich jedoch nur auf die Benutzung der KDevelop Entwicklungsumgebung beziehen und nicht auf ein Implementierungsproblem, das bei der Codierung Ihrer eigenen Applikation entstanden ist.

Auch sollten alle Mails, die an diese Mailingliste gerichtet sind, in Englisch gehalten sein, damit alle Teilnehmer sich an der Diskussion beteiligen können und eine bessere Hilfe bereitstellen können. Die Mailingliste ist ebenso dazu gedacht, Benutzern, die zum KDevelop Projekt beitragen möchten, ein Forum zu bieten; auch solche Mails sind willkommen, die Lösungen zu Problemen enthalten, die bei der Benutzung entstanden, damit wir Fehler korrigieren und dies integrieren können, um Anfängern eine noch qualifizierte Hilfe aus erster Hand zu bieten.

Ein guter Weg, Probleme zu berichten, ist das übersenden der Ausgabe, die Sie beim Starten von KDevelop aus einer Konsole heraus erhalten, oder den Inhalt des "Meldungen" Fensters von KDevelop in Ihren Bericht zu kopieren.

### 2.2 Anforderungen

Um KDevelop erfolgreich zu compilieren und zu benutzen muß Ihr System die folgenden Programme und Bibliotheken enthalten, die auf den meisten Plattformen als Pakete enthalten sind und daher einfach zu installieren sind.

Benötigt:

- g++ 2.7.2/g++ 2.8.1/egcs 1.1 (oder kompatibler Compiler), erhältlich auf http://www.gnu.org
- GNU make (or compatible), erhältlich auf http://www.gnu.org
- perl 5.004, erhältlich auf http://www.perl.com
- autoconf 2.12, erhältlich auf http://www.gnu.org
- automake 1.2, erhältlich auf http://www.gnu.org
- flex 2.5.4,
- GNU gettext, erhältlich auf http://www.gnu.org
- Qt 2.2.x, erhältlich auf http://www.trolltech.com
- KDE 2.1, erhältlich auf http://www.kde.org

Optional:

- enscript zur Nutzung der Druckfunktionen
- ghostview oder kghostview zur Druckvorschau
- glimpse 4.0 für die Nutzung des Suchindexes, erhältlich auf http://glimpse.cs.arizona.edu
- sgmltools 1.0, erhältlich auf http://www.sgmltools.org
- KDE-SDK (KDE Software Development Kit)with KDoc, KSgml2Html, KTranslator (erhältlich auf http://developer.kde.org)
- KDbg, erhältlich auf http://members.telecom.at/~johsixt/kdbg.html
- Qt Designer and uic which come along with Qt 2.2.x.
- KIconEdit (erhältlich auf http://www.kde.org)

KDevelop wurde getestet mit SuSE Linux 7.0.

Soweit den Autoren bekannt ist, enthält SuSE Linux und FreeBSD alle benötigten Programme, inklusive enscript als Pakete oder RPM's, so daß Sie keine Probleme haben sollten, die benötigte zusätzliche Software zu installieren.

Dokumentation:

Um die KDE Bibliotheks-Dokumentation zu erstellen, benötigen Sie das kdelibs Paket im Quellcode, wie es vom KDE Projekt bereitgestellt wird oder in den Quellpaketen ihrer Distribution enthalten ist und KDoc (enthalten im KDE-SDK).

Zusätzlich bieten wir eine C/C++ Referenz auf unserer Homepage auf http://www.kdevelop.org an, die nach ihrer Installation im Dokumentationsbrowser verfügbar ist. Laden Sie das Paket herunter und kopieren Sie es als `root` in Ihr KDE Verzeichnis und entpacken Sie es mit `tar zxvf c_c++_reference.tar.gz`. Bei Nichtinstallation zeigt die Auswahl der Referenz im Dokumentationsbaum eine Fehlerseite an mit der URL der KDevelop Homepage, auf der Sie das Paket erhalten können, und beschreibt den Installationsvorgang.

### 2.3 Compilierung und Installation

Um KDevelop auf Ihrem System zu compilieren und installieren, geben Sie folgendes im Hauptverzeichnis der KDevelop Distribution ein:

> `

>             % ./configure
>             % make

>             (als root)

>             % make install

> `

Da KDevelop `autoconf` benutzt, sollten Sie keine Probleme haben, es zu übersetzen.

Um KDevelop CVS Snapshots zu compilieren, geben Sie folgendes ein:

> `

>             % make -f Makefile.cvs
>             % ./configure
>             % make

>             Wechseln Sie auf <tt/root/ und geben Sie ein:

>             % make install

> `

Wenn das make-Kommando Ihres Systems `gmake` lautet, geben Sie `gmake` anstatt `make` ein.

### 2.4 Starten von KDevelop

Wenn Sie KDE als Window-Manager benutzen, können Sie KDevelop starten, indem Sie "K"->"Entwicklung"->"KDevelop 1.2" auswählen. Da KDevelop die KDE-Mime Typen unterstützt, können Sie KDevelop auch mit einem Projekt starten, indem Sie eine KDevelop Projektdatei ("*.kdevprj", dargestellt mit dem Projekt-Icon) im KDE Dateimanager (kfm) auswählen.

Unter anderen Winow-Managern öffnen Sie eine Konsole und geben ein:

> `

>     % kdevelop

> `

Um KDevelop mit einem bestehenden Projekt zu starten, wechseln Sie in das Projekt-Verzeichnis und geben ein:

> `

>     % kdevelop  <yourProject>.kdevprj

> `

Unter jedem Benutzerzugang wird KDevelop einen automatischen Installationsvorgang beim ersten Start aufrufen, der eine Schnellkonfiguration für die benötigten Einstellungen vornimmt. Wenn Ihre Installation verloren gehen sollte, können Sie KDevelop jederzeit rekonfigurieren, indem Sie

> `

>     % kdevelop  --setup

> `

eingeben, oder, wenn Sie KDE benutzen,"K"->"Entwicklung"->"KDevelop Setup" auswählen.

### 2.5 Das Installationsprogramm

KDevelop enthält ein automatisches Installationsmodul, das aufgerufen wird wenn KDevelop zum ersten Mal gestartet wird oder die Benutzer-Konfigurationsdatei kdeveloprc nicht existiert. Wir raten, die folgenden Installationsschritte mit der Auswahl von "Weiter" durchzuführen, um Ihr System zu prüfen und KDevelop einzurichten.

Die Tasten des Installationsdialoges führen folgende Aktionen aus:

Hilfe: Öffnet KDEHelp.

Weiter: Dies started den Installationsprozess und führt folgendes aus:

1. Prüfen nach make/gmake, autoconf, autoheader, automake und Perl um neue Applikationen, die mit KDevelop erstellt wurden zu erzeugen und zu compilieren. Wenn gmake installiert ist, wird das make-Kommando automatisch auf gmake eingestellt. Andere Kommandozeilenoptionen zu ihrem Erstellungsprogramm können Sie später im Setup Dialog, der über das "Einstellungen"-Menü zu erreichen ist, vornehmen; eine Einführung zu Entwicklung unter Unix befindet sich im Abschnitt Programme.
2. Prüfen nach KDoc und Glimpse. Diese werden das Erzeugen einer neuen KDE-Bibliotheks Dokumentation und eines Suchindexes in einem späteren Einstellungsschritt ermöglichen, wenn sie gefunden werden.
3. Prüfen nach enscript, um sicherzustellen, das die Druckfunktionen verfügbar sind. Eines dieser Programme muß installiert sein, um korrektes Drucken zu ermöglichen. Wenn keines installiert ist, können Sie dies jederzeit nachholen um das Drucken zu ermöglichen, ohne das Setup erneut durchzuführen.
4. Prüfen nach KDbg, KIconedit und KTranslator. Wir ermutigen Sie, diese Programme zu installieren, da sie gute Helfer bei der Erstellung von vollständigen KDE-Applikationen sind. Beachten Sie, das KDbg direkt zum Debuggen Ihres aktuellen Projekts innerhalb von KDevelop verwendet wird; KIconedit wird benötigt, um Pixmaps, die in den Dateibäumen ausgewählt werden zu betrachten und zu bearbeiten. Die Programme KDbg, KIconedit und KTranslator werden gleichzeitig im "Werkzeuge"-Menü der Menüleiste von KDevelop eingerichtet. Andere Werkzeuge können später hinzugefügt werden, indem Sie "Werkzeuge..." im Einstellungen-Menü aufrufen.
5. Zusammenfassung der geprüften Programme: Das Installationsprogramm listet diese Programme mit -gefunden oder -nicht gefunden auf. Zusätzliche Hinweise signalisieren Ihnen, wenn ein benötigtes Programm erforderlich ist.
6. Erkennung des Pfades zur Qt-Online Dokumentation: Dies prüft verschiedene Standardpfade in Ihrem System nach der Dokumentation und setzt den Pfad automatisch. Wenn Ihre Qt-Dokumentation nicht gefunden wurde, weil sie nicht installiert ist oder sich an einem anderen Ort befindet, werden Sie aufgefordert, entweder den korrekten Pfad manuell zu setzen oder fortzufahren. Bei Auswahl zum Setzen des Pfades wird im Haupt-Installationsfenster eine Editierleiste mit einem Ordner-Knopf auf der rechten Seite angezeigt, mit dem Sie den Pfad auswählen können. Normalerweise ist dies das qt/html Verzeichnis. Nach Beendigung können Sie mit der Auswahl von "Weiter" mit der Installation fortfahren.
7. Wenn KDoc gefunden wurde, werden Sie zur Erzeugung/Update Ihrer KDE-Bibilotheks-Dokumentation aufgefordert. Dazu benötigen Sie die KDE-Bibliotheken als Quellpaket. Linux-Benutzer, die KDE mit Ihrer Distribution installiert haben, sollten das zugehörige kdelibs-Quellpaket auf Ihr System kopieren und entpacken; FreeBSd Benutzer sollten nach dem zugehörigen Distfile Package in der Ports-Collection suchen. Wenn dieses bei Ihnen nicht zutrifft, sollten Sie das Quellpaket durch Download von http://www.kde.org beziehen und auf Ihrem System entpacken. Wenn Sie das Dokumentations-Paket, das auf http://developer.kde.org bereitgestellt wird, benutzen möchten, beenden Sie die Generierung mit "Abbrechen" und fahren Sie mit der Erstellung des Suchindexes fort. Nach Beendigung der Installation und dem Start von KDevelop setzen Sie dann den Pfad zum extrahierten Dokumentationssatz im KDevelop Setup Dialog und erzeugen dann den Suchindex erneut. Alle erforderlichen Einstellungen dazu finden Sie im Setup Dialog. Der "KDE-Biblotheks-Dokumentation aktualisieren" Dialog ist voreingestellt, die Dokumentation im Verzeichnis $(HOME)/.kde/share/apps/kdevelop/KDE-Documentation zu erstellen. Das einzige, was Sie tun müssen, ist den Pfad zum entpackten Quellpaket der Bibliotheken mit dem Auswahl-Knopf im oberen Teil des Dialoges anzugeben und mit "OK" zu bestätigen. Als Beispiel sei angenommen, das Sie die Bibliothek als kdelibs.tar.gz Paket von http://www.kde.org bezogen und in Ihrem Home-Verzeichnis haben. Öffnen Sie eine Konsole oder Terminal und geben Sie dort "tar zxvf kdelibs.tar.gz" ein. Dies wird das Quellpaket in ein Verzeichnis $HOME/kdelibs entpacken, das dann die Quelldateien jeder Bibliothek in einem Unterverzeichnis enthält, z.B. wäre dies für kdecore /home/rnolden/kdelibs/kdecore. Der Pfad, den Sie im Aktualisierungs-Dialog angeben müssen, wäre dann der zu allen Bibliotheken, hier also /home/rnolden/kdelibs. Nachdem Sie "OK" gewählt haben, wird Ihnen im Installationsfenster angezeigt, das die Erstellung der Dokumentation durchgeführt wird. Warten Sie dann bis zur nächsten Meldung.

   Anmerkung: Auf Multi-User Systemen oder Systemen mit Disk-Quotas für Benutzeraccounts würde die Installation einer kompletten HTML-Dokumentation separat für jeden Benutzer unnötig Plattenplatz verbrauchen. Fragen Sie in diesem Fall Ihren Systemadministrator, KDevelop unter dem root-Account laufen zu lassen, um Schreibzugriff auf das Wurzelverzeichnis des Systems zu erhalten. Dann installieren Sie die Dokumentation im KDE-Verzeichnis unter $KDEDIR/share/apps/kdevelop/KDE-Documentation. Der korrekte Pfad für Einzelbenutzer kann dann später im KDevelop Setup Dialog über das "Einstellungen" Menü gesetzt werden.

8. Wenn die Systemprüfung das Programm Glimpse gefunden hat, wird Ihnen die Erstellung einer Suchdatenbank angeboten. Die Suchdatenbank kann mit der Option erstellt werden, die KDE- und Qt-Dokumentation einzubeziehen (Standardeinstellung). Zusätzlich ist die KDevelop Dokumentation inbegriffen und wird indiziert. Wenn Sie weitere Dokumentationen besitzen, die Sie ebenfalls indizieren möchten, können Sie die Verzeichnisse auswählen und der Indexerstellung hinzufügen.
9. Während der Erstellung des Suchindexes zeigt das Installationsfenster Ihnen eine Nachricht, daß dies ausgeführt wird. Warten Sie danach bis zur Aufforderung zum nächsten Schritt.
10. Wenn alle Installationsschritte erfolgreich durchgeführt wurden, zeigt Ihnen eine abschließende Dialogbox an, das KDevelop gestartet wird, nachdem Sie "OK" wählen. Beachten Sie, das Sie zusätzliche Optionen wie automatisches Speichern im KDevelop Setup Dialog, der über das "Einstellungen" Menü aufgerufen wird, einstellen können.

Abbrechen: Zeigt einen Warnhinweis an, das der Installationsprozess abgebrochen wird. Diese Warnung erlaubt es Ihnen, nochmals zur Installation zurückzukehren ("Zurück") oder KDevelop mit den Standardeinstellungen zu starten ("Fortfahren"). Bedenken Sie, das Sie in diesem Fall alle Optionen mit Hilfe der Konfigurationsdialoge des "Einstellungen" Menüs selbst vornehmen müssen.

Weiter Zurück Inhaltsverzeichnis