Das Handbuch zu KAppTemplate. Anne-Marie Mahfouf Übersetzung: Burkhard Lück

Transkript

1 Anne-Marie Mahfouf Übersetzung: Burkhard Lück

2 2

3 Inhaltsverzeichnis 1 Einleitung 5 2 Arbeiten mit KAppTemplate 6 3 Welche Vorlage brauchen Sie? Die C++-Vorlage für eine grafische KDE4-Anwendung Die C++-Vorlage für eine KDE4-KPart-Anwendung Das Plasma-Miniprogramm Die PyQT4-Anwendung Die PyKDE4-Anwendung Die Ruby-KDE-Anwendung Danksagungen und Lizenz 13 A Installation 14 A.1 Wie Sie KAppTemplate erhalten A.2 Kompilierung und Installation

4 Zusammenfassung KAppTemplate erstellt Vorlagen für KDE4-Programme.

5 Kapitel 1 Einleitung KAppTemplate erstellt Vorlagen für KDE-Programme, um den Einstieg in die Programmierung für KDE zu erleichtern. KAppTemplate stellt einige grundlegende Vorlagen für Projekte zur Verfügung, benutzt aber auch Vorlagen von KDevelop, wenn sie auf ihrem Rechner installiert sind. Als Standard sind hier enthalten: Eine Vorlage für ein einfaches KDE 4 Programm mit grafischer Benutzeroberfläche (GUI) Eine Vorlage für eine KDE4-KPart-Anwendung Eine Vorlage für eine Qt4-Anwendung Eine Vorlage für eine PyQt4-Anwendung Eine Vorlage für eine PyKDE4-Anwendung Eine Vorlage für Ruby (korundum4) Eine Vorlage für ein Plasma-Miniprogramm Füllen Sie auf jeder Seite des Assistenten alle Felder aus, damit erstellen Sie Ihre Vorlage. ANMERKUNG Jede Vorlage enthält eine README-Datei mit Anleitungen zum Erstellen Ihres Projektes und Verknüpfungen zu weiteren Anleitungen für diesen Projekttyp. Mit der Generierung des Projekts ist die Aufgabe von KAppTemplate beendet, jetzt müssen Sie allein das Projekt kompilieren und erstellen. 5

6 Kapitel 2 Arbeiten mit KAppTemplate KAppTemplate ist ein Assistent zur Erstellung von Projekten aus Vorlagen. Dies wird auf der ersten Seite des Assistenten als Aufgabe von KAppTemplate genannt. Klicken Sie auf Weiter um mit der Generierung Ihres Projekts zu beginnen. Abbrechen beendet das Programm, Hilfe zeigt dieses Handbuch im KDE-Hilfezentrum Die zweite Seite zeigt alle verfügbaren Vorlagen an. Rechts sehen Sie eine Vorschau der Vorlage, darunter die Beschreibung. Nachdem Sie eine Vorlage ausgewählt haben, geben Sie den Projektnamen im unten im Feld ein. 6

7 Auf der dritten Seite geben Sie die Version, das Installationsverzeichnis und Ihren Namen sowie die adresse ein. Wenn Sie Ihre persönlichen Daten in den Systemeinstellungen eingetragen haben, werden diese als Voreinstellung übernommen. Auf der vierten und letzten Seite des Assistenten werden Ihnen Informationen über die Generierung des Projekts gegeben. 7

8 Klicken Sie dann auf Fertigstellen, um KAppTemplate zu beenden. 8

9 Kapitel 3 Welche Vorlage brauchen Sie? Diese Kapitel beschreibt alle Vorlagen, um Ihnen eine Hilfe für die Auswahl der Projektart für Ihre Anforderungen zu geben. 3.1 Die C++-Vorlage für eine grafische KDE4-Anwendung Dies ist eine Vorlage für eine grafische KDE4-Anwendung auf der Basis von CMake und verwendet KXMLGuiWindow und KConfig XT. Das ist die Vorlage für ein KDE4-Standardprogramm. Diese Vorlage zeigt wie KDE-Menüs mit XMLGui erstellt werden und wie KConfig XT genutzt werden kann, um Einstellungen mit Einstellungen <ProgrammName> einrichten... zu ändern. Bitte lesen Sie die Datei README im Projektordner. Sie finden viele weitere Informationen auf Die C++-Vorlage für eine KDE4-KPart-Anwendung Dies ist eine Vorlage für eine CMake basierende KDE4-KPart-Anwendung und demonstriert, wie KPart zu verwenden ist. 9

10 Bitte lesen Sie die Datei README im Projektordner. 3.3 Das Plasma-Miniprogramm Diese Vorlage generiert ein einfaches Plasma-Miniprogramm mit einem Symbol und Text. Sie brauchen mindestens KDE4.1, um diese auf CMake basierende Vorlage zu erstellen. Weitere Informationen darüber finden Sie unter Development/Tutorials/Plasma/GettingStarted, alle Methoden sind dort weiter erklärt. Um Ihr Miniprogramm zu laden, starten Sie Plasma mit dem Befehl kquitapp plasma && plasma neu oder benutzen Sie plasmoidviewer IhrMiniprogramm. 3.4 Die PyQT4-Anwendung Diese Vorlage erstellt folgende Anwendung: 10

11 Dazu benötigen Sie PyQt4 aus Ihrer Distribution. Generieren Sie zuerst das Pythonmodul aus Ihrer Designerdatei meinkalender.ui durch die Eingabe von pyuic4 -o meinkalender.py meinkalender.ui in Ihrem Projektordner. Dann können Sie das Programm mit python meinkalender.py starten. 3.5 Die PyKDE4-Anwendung Diese Vorlage erstellt folgende Anwendung: Dazu benötigen Sie PyKDE 4 aus Ihrer Distribution. Generieren Sie zuerst das Pythonmodul aus Ihrer Designerdatei meinkalender.ui durch die Eingabe von pyuic4 -o meinkalender.py meinkalender.ui in Ihrem Projektordner. Dann können Sie das Programm mit python meinkalender.py starten. 11

12 3.6 Die Ruby-KDE-Anwendung Diese Vorlage erstellt folgende Anwendung: Sie benötigen korundum4 von KDE 4 aus dem Modul kdebindings oder von Ihrer Distribution, um diese Vorlage verwenden zu können. Um nach dem Erstellen und Installieren des Projekts (siehe README) diese Vorlage zu starten, geben Sie auf der Konsole ein: krubyapplication ihr-programm/main.rb. 12

13 Kapitel 4 Danksagungen und Lizenz Programm Copyright Kurt Granroth Programm Copyright Anne-Marie Mahfouf Programm Copyright 2008 Beat Wolf Mitwirkende: Programmierung: Beat Wolf asraniel@fryx.ch Ruby Vorlage: Cyrille Berger cberger@cberger.net Ruby-Vorlage: Richard Dale Richard_Dale@tipitina.demon.co.uk > PyKDE4-Vorlage: Christoph Burgmer chrislb@gmx.de Dokumentation Copyright 2008 Anne-Marie Mahfouf annma@kde.org Übersetzung Burkhard Lücklueck@hube-lueck.de Diese Dokumentation ist unter den Bedingungen der GNU Free Documentation License veröffentlicht. Dieses Programm ist unter den Bedingungen der GNU General Public License veröffentlicht. 13

14 Anhang A Installation A.1 Wie Sie KAppTemplate erhalten KAppTemplate ist Teil des KDE-Projekts KAppTemplate finden Sie im kdesdk-paket auf ftp://ftp.kde.org/pub/kde/, dem Haupt-FTP- Server des KDE-Projekts. A.2 Kompilierung und Installation Ausführliche Anleitungen, um KDE-Programme auf Ihrem System zu kompilieren und zu installieren, finden Sie unter KDE aus dem Quelltext installieren Da KDE cmake benutzt, sollte es dabei keine Schwierigkeiten geben. Sollten dennoch Probleme auftauchen, wenden Sie sich bitte an die KD inglisten. 14