KDE TechBase - User contributions [en]

Development/Tutorials/Debugging/Debugging with GDB

2008-10-03T09:12:01Z

Sschloenvoigt: Made a Note for the important information about --nofork

{{Template:I18n/Language Navigation Bar|Development/Tutorials/Debugging/Debugging with GDB}}
This is a short tutorial on debugging KDE applications. Throughout this
tutorial I will use "kedit" as an example application.

==Debugging with GDB==

The recommended version of gdb to use is version 4.95 or higher; older
versions have problems generating proper backtraces.

There are three ways to debug an application with gdb:

# You can start the application from within gdb.
# You can attach gdb to an already running application.
# You can run gdb after an application has crashed using a core file.

==Starting applications from within gdb==

To start an application with gdb you can start gdb as follows:

> gdb kedit
GNU gdb 4.95.0
Copyright 2000 Free Software Foundation, Inc.
GDB is free software, covered by the GNU General Public License, and you are
welcome to change it and/or distribute copies of it under certain conditions.
Type "show copying" to see the conditions.
There is absolutely no warranty for GDB. Type "show warranty" for details.
This GDB was configured as "i686-pc-linux-gnu"...
(gdb)

You can now set the command line arguments that you want to pass to kedit with
the gdb command "<tt>set args</tt>":

(gdb) set args myfile.txt
(gdb)

gdb has loaded the kedit executable on startup but it hasn't loaded any of
the libraries yet. This means that you can't set any breakpoints in the
libraries yet. The easiest way to do that is to set a breakpoint in the
first line of main and then start the program:

(gdb) break main
Breakpoint 1 at 0x804855c
(gdb) run
Starting program: /ext/kde2.0/bin/kedit myfile.txt
Breakpoint 1 at 0x4002cf18: file kedit.cpp, line 1595.

Breakpoint 1, main (argc=2, argv=0xbffff814) at kedit.cpp:1595
1595 bool have_top_window = false;
Current language: auto; currently c++
(gdb)

You can now set breakpoints everywhere. For example lets set a breakpoint
in the KApplication constructor. Unfortunately, gdb is not very good in
handling C++ names, so it is not really possible to specify the constructor
directly after the break command. Instead we look up a line of source
code where we want to place the breakpoint. An external editor is of great
use at this point. With the list command we can select the source file we
are interested in and verify that we have found the correct source line:

(gdb) list kapp.cpp:220
215 parseCommandLine( argc, argv );
216 }
217
218 KApplication::KApplication( bool allowStyles, bool GUIenabled ) :
219 QApplication( *KCmdLineArgs::qt_argc(), *KCmdLineArgs::qt_argv(),
220 GUIenabled ),
221 KInstance( KCmdLineArgs::about),
222 d (new KApplicationPrivate)
223 {
224 if (!GUIenabled)
(gdb) break 224
Breakpoint 2 at 0x4048aa7e: file kapp.cpp, line 224.
(gdb)

We can now continue the execution of kedit. Execution will stop when it hits
a breakpoint or when the program exits. In this case execution will stop
in the first line of the KApplication constructor:

(gdb) continue
Continuing.
Qt: gdb: -nograb added to command-line options.
Use the -dograb option to enforce grabbing.

Breakpoint 2, KApplication::KApplication (this=0xbffff6a8, allowStyles=true,
GUIenabled=true) at kapp.cpp:224
224 if (!GUIenabled)
(gdb)

{{Note|
Important: many applications use "KUniqueApplication" to ensure that only one instance can exist at a given time in a given KDE session. This is the case for kwin, kontact, konsole, plasma, etc. To debug those applications, attach to them while they're running (see next session) or use <code>set args --nofork</code>
}}

==Attaching gdb to already running applications==

Sometimes it is not practical to start an application from within gdb.
E.g. in those cases where you didn't know the application was about to
crash :-) When you get the friendly DrKonqi dialog informing you about
a crash you are just in time to start your debugger.

First lets attach gdb to an application that hasn't crashed (yet).

You start with finding the process of the application with e.g. "ps -aux":

> ps -aux | grep kedit
bastian 21570 15.1 6.8 13740 8800 pts/6 S 15:34 0:01 kedit
bastian 21582 0.0 0.3 1132 412 pts/6 R 15:34 0:00 grep kedit

From this you learn that kedit has process id 21570. Now you can start gdb as
follows:

> gdb kedit 21570
GNU gdb 4.95.0
Copyright 2000 Free Software Foundation, Inc.
GDB is free software, covered by the GNU General Public License, and you are
welcome to change it and/or distribute copies of it under certain conditions.
Type "show copying" to see the conditions.
There is absolutely no warranty for GDB. Type "show warranty" for details.
This GDB was configured as "i686-pc-linux-gnu"...
/home1/bastian/21570: No such file or directory.
Attaching to program: /ext/kde2.0/bin/kedit, Pid 21570
Reading symbols from /ext/kde2.0/lib/kedit.so.0...done.
Loaded symbols for /ext/kde2.0/lib/kedit.so.0
...
Reading symbols from /lib/ld-linux.so.2...done.
Loaded symbols for /lib/ld-linux.so.2
Reading symbols from /lib/libnss_compat.so.2...done.
Loaded symbols for /lib/libnss_compat.so.2
Reading symbols from /lib/libnsl.so.1...done.
Loaded symbols for /lib/libnsl.so.1
0x40c3d88e in __select () from /lib/libc.so.6
(gdb)

You will usually end up in the middle of a select() call from the event-loop.
This is the place where a KDE application spends most of its time, waiting
for things to happen.

A backtrace will typically look something like this:

(gdb) bt
#0 0x40c3d88e in __select () from /lib/libc.so.6
#1 0x40a22844 in __DTOR_END__ () at fam.c++:356
#2 0x407293bf in QApplication::enter_loop (this=0xbffff6e8)
at kernel/qapplication.cpp:2552
#3 0x406b1d7b in QApplication::exec (this=0xbffff6e8)
at kernel/qapplication_x11.cpp:2217
#4 0x4002d500 in main (argc=1, argv=0xbffff854) at kedit.cpp:1662
#5 0x40bbba5e in __libc_start_main (main=0x8048568 <main>, argc=1,
argv=0xbffff854, init=0x8048514 <_init>, fini=0x80486cc <_fini>,
rtld_fini=0x4000aa20 <_dl_fini>, stack_end=0xbffff84c)
at ../sysdeps/generic/libc-start.c:92
(gdb)

==Debugging core files with GDB==

Debugging process requires much memory. If you have to inspect crash, you can debug core files. It's much faster and requires less memory. First limit the maximum size of core files and run the application:
ulimit -c 100000
kedit --nocrashhandler
Don't forget to use '--nocrashhandler' option. Core file would be created if the application crashed, so you can use gdb with created core file:
gdb kedit ./core-file #in my system it is core.PID

==Improving your gdb experience for KDE/Qt applications==

In the SVN path named "kdesdk", you will find the file [http://websvn.kde.org/trunk/KDE/kdesdk/scripts/kde-devel-gdb kdesdk/scripts/kde-devel-gdb].
This file contains a few macros that help looking into some Qt objects (for instance QString).
See the beginning of the file for instructions on how to use it.

If you want to go even further, you can apply those [http://developer.kde.org/documentation/other/gdb-patches patches to the gdb source],
to fix a few annoyancies in gdb:

* source.c: don't try to open a directory in "." that has the same name as the executable we want to open (not needed for gdb-6.0 and above)
* symfile.c: no prompting at end of page while opening shared libraries (not needed for gdb-6.2 and above)
* solib.c: less output when opening shared libraries

Those patches are maintained by [mailto:faure@kde.org David Faure].

Have fun with gdb! Hmm, ok, the definition of 'fun' is very relative...

Development/Tutorials (de)

2008-01-15T22:03:13Z

Sschloenvoigt: Übernahme der restlichen Einträge von der englischen Seite

{{Template:I18n/Language Navigation Bar|Development/Tutorials}}

Tutorials sind der schnellste Weg um herauszufinden, was man mit KDE anstellen kann und wie man das macht. Es folgt eine Liste der verfügbaren Tutorials '''für KDE4'''. Tutorials und Anleitungen zu KDE3 und KDE2 finden Sie am Ende dieser Seite.

== Einführung in die KDE4 Programmierung ==
Sind Sie an der Entwicklung von Programmen für KDE 4 interesiert? Wenn ja sind Sie hier genau richtig. Diese Artikelserie richtet sich an alle, die noch nie mit KDE programmiert haben.
;[[Development/Tutorials/First program (de)|Hallo Welt!]]
:''Einführung in die Grundlagen der KDE Programmierung''

;[[Development/Tutorials/Using KXmlGuiWindow (de)|Erstellen eines Hauptfensters]]
:''Dieser Artikel erklärt, wie der wichtigste Teil eines grafischen Programmes erstellt wird: das Hauptfenster.''

;[[Development/Tutorials/Using KActions (de)|Die Verwendung von KActions]]
:''In diesem Artikel erfahren Sie, wie Aktionen und Werkzeugleisten (Toolbars) im Menü hinzugefügt werden können.''

;[[Development/Tutorials/Saving and loading (de)|Laden und Speichern von Dateien]]
:''Dieser Artikel führt die KIO Bibliothek ein und erklärt wie man Dateien laden und speichern kann.''

;[[Development/Tutorials/KCmdLineArgs (de)|Befehlszeilen Argumente (todo)]]
:''In diesem Artikel werden Sie lernen Ihrer Anwendung zu ermöglichen, Dateien über die Befehlszeile oder sogar unter Dolphin mit 'Öffnen mit' zu laden''

== Grundlagen ==
;[[Development/Tutorials/KDE4 Porting Guide (de)|Ihre Applikation nach KDE 4 portieren]]
:''Anleitungen Qt3/KDE3 Applikationen nach Qt4/KDE4 zu portieren''

;[[Development/Tutorials/CMake (de)|Einführung in CMake]]
:''Wie man CMake in KDE 4 benutzt''

;[[Development/Tutorials/Common Programming Mistakes (de)|Häufige Programmierfehler]]
:''Einige häufige Fehler die man während der Entwicklung von Qt und KDE Applikationen machen kann und wie man sie vermeidet.''

;[[Development/Tutorials/Using Qt Designer (de)|Den Qt Designer benutzen um Benutzerschnittstellen zu erzeugen]]
:''Wie man UI Dateien mit dem Designer erzeugt und wie man diese in einem KDE Programm integriert.''

== Testen und Fehler beheben ==

;[[Development/Tutorials/Debugging (de)|Debugging Ihrer Applikation]]
:''Tips, Tools und Techniken zum Debuggen von KDE Applikationen''

;[[Development/Tutorials/Unittests|Schreiben von Unit-Tests für Qt4 und KDE4 mit QTestLib]] ([http://developer.kde.org/documentation/tutorials/writingunittests/writingunittests.html Original link])
:''Tutorial von [mailto:bradh@frogmouth.net Brad Hards] das beschreibt, wie man Unit-Tests mit dem QTestLib Framework erstellt. Das Tutorial wird anhand eines Beispiels beschrieben und befindet sich zur Zeit noch in Entwicklung.''

;[[Development/Tutorials/Code_Checking|Halbautomatische Werge zur Erkennung von Programmierfehlern]]
:''Techniken um Fehler in KDE Code aufzuspüren''

== Konfigurationen mit KConfig verwalten ==
;[[Development/Tutorials/KConfig|Einführung in KConfig]]
:''Eine Übersicht über die zu KConfig gehörenden Klassen und wie Sie diese in Ihre Anwendung einbinden können''

;[[Development/Tutorials/Using KConfig XT|Benutzung von KConfig XT]]
:''Tutorial über das effiziente Benutzen des KConfig XT Frameworks.''

;[[Development/Tutorials/Updating KConfig Files|Update von KConfig Dateien]]
:''Tutorial das beschreibt, wie man ein Update-Skript erstellt, dass Veränderungen am Format der Konfiguration Ihrer Anwendung mit den bereits vorgenommenen Einstellungen des Anwenders abgleicht.''

== Dienste: Applikationen und Plugins ==
;[[Development/Tutorials/Services/Introduction (de)|Einführung in das Dienst-Framework]]
:''Eine Einführung über das Dienst-Framework in KDE und was es dem Applikationsentwickler zur Verfügung stellen kann. Beschäftigt sich mit dem system configuration cache (SyCoCa), den benötigten Dateien und wie indizierte Informationen benutzt werden.

;[[Development/Tutorials/Services/Traders (de)|Dienste über Trader Queries finden]]
:''Wie man mit der Trader Query Syntax Dienste wie Plugins oder Mimetypes findet, die im SyCoCa zwischengespeichert wurden. ''

;[[Development/Tutorials/Services/Plugins|Erstellen und Laden von Plugins mit KService]]
:''Zeigt, wie man eigene Plugintypen definiert, installiere Plugins findet (einschließlich denen von anderen Herstellern) und wie man diese einfach und portabel läd, indem man KService benutzt.''

== Lokalisierung ==
;[[Development/Tutorials/Localization/Unicode (de)|Einführung in Unicode]]
:''Eine Einführung was Unicode ist und wie KDE Applikationen damit umgehen.''

; [[Development/Tutorials/Localization/i18n (de)|Beim Schreiben der Applikation an die Lokalisierung denken]]
:''Diese Anleitung beschäftigt sich damit, was Lokalisation ist, warum sie wichtig ist und wie man sicherstellt, dass die eigene Applikation bereit ist, lokalisiert zu werden. Jeder Applikationsentwickler sollte das lesen.''

; [[Development/Tutorials/Localization/i18n Mistakes (de)|Häufige Fehler vermeiden]]
:''Es gibt einige häufige Fehler, die es verhindern, dass eine Applikation angemesssen übersetzt werden kann. Diese Anleitung zeigt diese Fehler auf und zeigt, wie man sie vermeidet.''

; [[Development/Tutorials/Localization/Building KDE's l10n Module|Erstellen von KDE's Lokalisierungs Modul]]
:''Das Erstellen und Installieren der Sprachunterstützung mit KDE's Lokalisierungs-Modul (l10n) ist ratsam für alle, die an Anwendungen im KDE Haupt-Repository arbeiten. Hierdurch erreichen Sie, das Sie Ihre Anwendung in anderen Sprachen testen und somit auftauchende Probleme erkennen können. Dieses Tutorial bringt Ihnen genau das bei.''

; [[Development/Tutorials/Localization/i18n Build Systems|Einbeziehen von i18n in das Build System]]
:''Sobald Ihre Anwendung bereit dazu ist lokalisiert zu werden, ist es der nächste Schritt sicherzustellen, dass die Übersetzungsdateien automatisch erstellt und aktuell gehalten werden. Dieses Tutorial behandelt die nötigen Änderungen an den CMakeFile.txt Dateien sowie den Prozess um den resultierenden Nachrichten-Katalog mit Ihrer Applikation zu verteilen.''

; [[Development/Tutorials/Localization/i18n Challenges|i18n - Herausforderungen and Lösungen]]
:''Dieses Tutorial behandelt die Aufgaben und Fallstricke, die bei der Lokalisierung auftreten wie das Übersetzen von Handbüchern und anderen Daten die ausserhalb des Quellcodes auftreten, das Behandeln von nicht mehr gültigen .po-Dateien, das Umgehen mit Freezes, programmieren in anderen Sprachen als Englisch und Erstellung unabhängiger Releases oder das Verschieben von Anwendungen zwischen KDE Modulen.''

; [[Development/Tutorials/Localization/i18n_Semantics|Semantisches Markup für Nachrichten]]
:''Um eine konsistente und semantisch korrekte Darstellung von Nachrichten in Anwendungen sicherzustellen, können semantische Kommentare zu den Nachrichten, die übersetzt werden sollen, mit dem KUIT System hinzugefügt werden. Dieses Tutorial beschreibt die Funktionsweise dieses Systems.''

; [[Development/Tutorials/Localization/i18n Krazy|Automatisierte i18n Codeüberprüfung]]
:''Der Krazy Code-Checker durchsucht KDE's Code und meldet häufige i18n Fehler.''

; [[Development/Tutorials/Localization/Language Change (de)|Mit Sprachänderungen umgehen]]
:''Wie man seiner Applikation beibringt beim nächsten Start oder zur Laufzeit eine andere Sprache zu benutzen.''

== Dokumentation ==

;[[Development/Tutorials/API_Documentation|API Dokumentation]]
:''Dieses Tutorial erklärt, wie Sie Ihre APIs korrekt dokumentieren.''

;[[Development/Tutorials/Man_Pages|Man Seiten]]
:''Das Schreiben und Erstellen von Referenz-Handbüchern.''

== Anwendungsautomatisierung und Skripting ==

=== D-Bus ===
; [[Development/Tutorials/D-Bus/Introduction|Einführung in D-Bus]]
:''Eine
:''Eine unkomplizierte Einführung in die Kernkonzepte von D-Bus aus der Sicht eines Anwendungs-Programmierers. Dieses Tutorial behandet was D-Bus ist, und wie Sie es in Ihren Anwendungen einsetzen können.''

; [[Development/Tutorials/D-Bus/Accessing Interfaces|Zugriff auf D-Bus Schnittstellen]]
:''Eine Schrittweise Anleitung zum Aufruf von D-Bus-Methoden und zur Verbindung mit D-Bus-Signalen unter Verwendung von QtDBus.''

; [[Development/Tutorials/D-Bus/Intermediate_D-Bus|D-Bus für Fortgeschrittene]]
:''Tips zur Verwendung von QtDBus wenn sie mit problematischen Realwelt-Schnittstellen konfrontiert werden.''

; [[Development/Tutorials/D-Bus/Creating Interfaces|Erstellen von D-Bus Schnittstellen]]
:''Lernen Sie, wie sie Funktionalität Ihrer Applikationen bereit stellen, indem Sie eigene D-Bus Schnittstellen erstellen und benutzen. Beschreibt das Erstellen von XML-Beschreibungen, die Bereitstellung von Schnittstellen zur Laufzeit und das Aufsetzen des Build-Systems mit CMake.''

; [[Development/Tutorials/D-Bus/Autostart Services|D-Bus Autostart Dienste]]
:''Machen Sie mit diesem Tutorial aus Ihrer Anwendung einen D-Bus-Autostart-Dienst. Dieses Feature, dass auch als "D-Bus Dienst Aktivierung" bekannt ist, ermöglicht es, dass D-Bus Aufrufe zu Ihrer Applikation selbst dann funktionieren, wenn sie gerade nicht läuft indem sie den D-Bus-Daemon Ihre Applikation starten lassen, wenn deren Funktionen benötigt werden.''

; [[Development/Tutorials/Porting_to_D-Bus|Portieren von DCOP nach D-Bus]]
: ''Portieren Sie mit Hilfe dieser Anleitung Ihre Anwendungen von DCOP nach D-Bus.''

=== Konqueror ===
; [[Development/Tutorials/Creating Konqueror Service Menus|Erstellung von Konqueror Dienstmenus]]
:''Dieses Tutorial zeigt Ihnen wie Sie MIME-Typ-spezifische Aktionen in Konquerors Kontextmenu bereitstellen.''

=== Kross ===
; [[Development/Tutorials/Kross/Introduction|Einführung in Kross]]
:''Eine Einführung in das Kross Scripting Framework.''

; [[Development/Tutorials/Kross/Hello_World|Hallo Welt]]
:''Eine erste Anwendung mit funktionierendem Kross Code.''

; [[Development/Tutorials/Kross/Connecting_Signals_and_slots_in_Kross|Verbinden von Signalen und Slots in Kross]]
:''Einfache Demonstration, wie man Signale von Objekten mit Slots von Skripten verbindet.''

; [[Development/Tutorials/Kross/Scripts-as-Plugins|Skripte als Plugins mit Kross]]
:''Dieses Tutorial bietet eine schrittweise Einführung, wie Sie Skripte als Plugins in eine KDE Anwendung integrieren.''

=== KOffice ===
; [[Development/Tutorials/KOffice Overview|KOffice Übersicht]]
:''Dieses Dokument zeigt eine Übersicht über die verschiedenen KOffice Plugin Typen sowie ihren jeweiligen Nutzen und Stärken.'' Wenn KOffice Plugins neu für Sie sind, ist dieses Tutorial für Sie geeignet.

; [[Development/Tutorials/Write a Flake Plugin|Erstellen von KOffice Flake Plugins]]
:''Dieses Tutorial zeigt Ihnen wie Sie ein Plugin für KOffice Anwendungen erstellen das Ihnen mit Hilfe von Flake erlaubt, Inhalte in ODF-Dokumente einzubetten.''

; [[Development/Tutorials/KWord Scripting|KWord Scripting]]
:''Dieses Tutorial zeigt, wie man KWord mit Skriptsprachen wie Python, Ruby oder JavaScript über Kross anspricht.''

; [[Development/Tutorials/KSpread Scripting|KSpread Scripting]]
:''Dieses Tutorial zeigt, wie man KSpread mit Skriptsprachen wie Python, Ruby oder JavaScript über Kross anspricht.''

; [[Development/Tutorials/Krita Scripting|Krita Scripting]]
:''Dieses Tutorial zeigt, wie man Krita mit Skriptsprachen wie Python, Ruby oder JavaScript über Kross anspricht.''

=== SuperKaramba ===
; [[Development/Tutorials/SuperKaramba|SuperKaramba Tutorial]]
:''Dieses Tutorial bietet einen Einblick in SuperKaramba, Themen-Dateien und das Skripten mit Python, Ruby und JavaScript.

== Suche und Meta-Daten ==

=== Strigi ===

; [[Development/Tutorials/Writing file analyzers|Schreiben von Datei-Analysierern]]
:''Datei-Analysierer extrahieren Daten aus Dateien um Sie in Datei-Dialogen und Datei-Managern anzeigen können. Die Daten die auf diesem Weg erhalten werden, werden auch für die Suche nach Dateien verwendet. KDE4 erlaubt die Benutzung von mehreren Analysierern pro Dateityp. Dieses Tutorial beschreibt, wie Sie neue Analysierer schreiben können.''

=== Nepomuk ===

; [[Development/Tutorials/Metadata/KMetaData first steps|Erste Schritte mit Nepomuk]]
:''Nepomuk ist die KDE-Bibliothek die einfachen Zugriff auf Metadaten im [http://nepomuk-kde.semanticdesktop.org Nepomuk-KDE] System erlaubt. Lernen Sie, wie Ihre Applikation mit Hilfe von Nepomuk Metadaten bereitstellen und verwenden kann.''

== Ansprechen von Hardware (Solid) ==

;[[Development/Tutorials/Solid_Tutorials|Einführung in Solid]]
:''Eine Einführung in die Benutzung der Solid Hardware-Erkennung und -Verwendung in KDE Applikationen.''

;[[Development/Tutorials/Solid_Network_Tutorial|Zugriff auf Netzwerk-Informationen]]
:''Wie man Solid benutzt um Informationen über das Netzwerk herauszufinden''

== Multimedia (Phonon) ==

;[[Development/Tutorials/Phonon/Introduction|Phonon]]
:''Erste Schritte mit der Multimedia API''

:''Erstellung und Benutzung von Phonon und seinem GStreamer Backend unter Linux mit Qt 4.3.x''
::''Dieser Artikel gibt Ihnen eine kurze Anleitung wie Sie Phonon und sein GStreamer Backend unter GNU/Linux mit lediglich Qt 4.3.x beziehen, kompilieren und benutzen können. Gegen Ende beschreibt der Artikel zusätzlich, wie ein Entwickler Phonon benutzen kann um einfache Audio- und Video-Spieler zu erstellen. Sie können den Artikel [http://www.vcreatelogic.com/oss/docs/CompilingPhononOnLinux.pdf hier] lesen.
Sie können die editierbare OpenDocumentText Datei von [http://www.prashanthudupa.com/phonon/CompilingPhononOnLinux.odt hier]. herunterladen''

== Plasma ==

;[[Development/Tutorials/Plasma/GettingStarted|Erste Schritte mit Plasmoids]]
:''Erstellung Ihres ersten Plasma-Widgets oder Plasmoids in C++ mit einem SVG Hintergrund, einem Icon und etwas Text''

;[[Development/Tutorials/Plasma/DataEngines|Schreiben einer DataEngine]]
:''DataEngines bieten eine standardisierte Schnittstelle zur Darstellung von Daten aus verschiedenen Datenquellen. Lernen Sie was eine DataEngine ist und wie Sie selbst ein schreiben können.''

;[[Development/Tutorials/Plasma/UsingDataEngines|Benutzung von DataEngines in Plasmoids]]
:''Mit einer DataEngine ist es möglich, Daten auf einfache und standardisierte Art und Weise zu empfangen und darzustellen. Dieses Tutorial behandelt das Thema, wie man DataEngines zu diesem Zweck in Plasma einsetzt.''

;[[Development/Tutorials/Plasma/AbstractRunner|Erstellen von Runners]]
:''Runners sind Plugins die Aktions-basierte Suchfunkionalität im Plasma Ausführen-Dialog erlauben. Diese Plugins können von jeder Applikation verwendet werden, die libplasma einbindet.''

== Kate / Kwrite ==

;[[Development/Tutorials/Kate/KTextEditor Plugins|Erste Schritte mit KTextEditor Plugins]]
:''Erstellung Ihres ersten KTextEditor Plugins''

== Drucken ==

;[[Development/Tutorials/Printing Hello World|Hallo Welt]]
:''Einführung in das KDE Drucksystem''

;[[Development/Tutorials/Printing Print Dialog|Druckdialog]]
:''Benutzung des KDE Druckdialogs''

== Neue Dinge herunterladen ==
; [[Development/Tutorials/Introduction to Get Hot New Stuff|Einführung in "Neue Dinge herunterladen"]]
:''Eine Einführung in das Entwickler-freundliche Netzwerk-Update-System das KDE Applikationen erlaubt, neue Anwendungsdaten zur Laufzeit auf benutzerfreundliche Weise herunterzuladen.''

;[[Development/Tutorials/KNewStuffSecure|Sicherheit mit KNewStuff]] ([http://developer.kde.org/documentation/tutorials/knewstuffsecure/index.html Original Link])
:''Tutorial das zeigt, wie man Ressourcen auf sichere Weise teilt (KDE 3.4 und später).'' Geschrieben von András Mantia <amantia@kde.org>.

== Schnelle Anwendungsentwicklung ==

=== Python ===

;[[Development/Tutorials/Python introduction to signals and slots|101 Einführung in Signale und Slots]]
:''Eine einfache Einführung in Qt's Signal- und Slot-Architektur.''

=== Ruby ===

;[http://developer.kde.org/language-bindings/ruby/kde3tutorial/index.html KDE Ruby Korundum Tutorial]
:''Eine Ruby-Version von Antonio Larossa Jiménezs KDE Tutorial von Richard Dale. Sehen Sie sich for Qt Tutorials und andere Informationen auch die [http://developer.kde.org/language-bindings/ruby/index.html Ruby Developers Corner] an.''

;[[Development/Tutorials/Qt4_Ruby_Tutorial|Qt4 Ruby Tutorial]]
:''Trolltechs sagenhaftes Einstiegstutorial in Qt, übersetzt für Ruby.''

=== Shell ===

;[[Development/Tutorials/Shell_Scripting_with_KDE_Dialogs|Shell Scripting mit KDE Dialogen]] ([http://developer.kde.org/documentation/tutorials/kdialog/t1.html Original Link])
:''Tutorial von [mailto:bradh@frogmouth.net Brad Hards] das beschreibt, wie man KDE Dialoge mit Hilfe von kdialog in Shell-Skripten verwendet. Das Tutorial wird anhand eines Beispiels durchgeführt.''

== Andere Tutorials ==

=== Benutzung der KDE Games Bibliothek ===
;[[Development/Tutorials/Games/KStandardGameAction| KStandardGameAction]]
:''Benutzung von libkdegames um Ihr Spiel dem kdegames Standard anzupassen''
;[[Development/Tutorials/Games/Highscores| Highscores]]
:''Implementierung einer einfachen Highscore-Tabelle in Ihrem Spiel''
;[[Development/Tutorials/Games/Theme Selector| Themen-Auswahl]]
:'' Benutzung des libkdegames Themen-Auswahl-Dialogs''

=== 2D Plotting (KPlotWidget) ===
;[[Development/Tutorials/KPlotWidget|Benutzen des KDE Daten-Plotting Widgets]]
:''Dieses Tutorial führt KPlotWidget ein, welches zum plotten zweidimensionaler Daten verwendet werden kann. Es enthält Informationen zu einfachen Benutzung des Widgets (inklusive Hinzufügen und Änderung von Datensätzen sowie Anpassung der Koordinatenachsen und deren Beschriftung) sowie erweiterten Anwendungsfällen (inklusive Erweiterung des Widgets durch Vererbung).''

=== Rechtschreib- und Grammatikprüfung (Sonnet) ===
;[[Development/Tutorials/Sonnet/SonnetTutorial|Rechtschreib- oder Grammatikprüfung in KDE Applikationen einbinden]]
:''Diess Tutorial führt in Sonnet ein und wie man es benutzt um Sprachkorrekturen in der eigenen KDE Anwendung zu verwenden. Sonnets Hilffunktionen sollen in einem weiteren Tutorial beschrieben werden.''

=== Pixmap cache (KPixmapCache) ===
;[[Development/Tutorials/KPixmapCache|Benutzung des KDE Pixmap Caches]]
:''Dieses Tutorial demonstriert die Benutzung von KPixmapCache zum Zwischenspeichern von beispielsweise Pixmaps die aus SVGs oder Daten erstellt wurden.''

== Material für KDE2 und KDE3 ==

;[[Development/Tutorials/KDE3|KDE3 Tutorials]]
:''Diese Tutorials behandeln Themen im Bezug auf KDE3.''

;[[Development/Tutorials/KDE2|KDE2 Tutorials]]
:''Diese Tutorials behandeln Themen im Bezug auf KDE2.''

[[Category:KDE4]]

Development/Tutorials/Debugging (de)

2008-01-15T21:44:30Z

Sschloenvoigt: Übersetzung ins Deutsche

{{Template:I18n/Language_Navigation_Bar|Development/Tutorials/Debugging}}

Das Debuggen von KDE Applikationen kann auf verschiedene Weise erfolgen. Die meisten Applikationen "reden" unsichtbar über Debug-Ausdrücke während sie laufen. Das Betrachten dieser Informationen gibt Ihnen meist genug Informationen um herauszufinden was schief läuft. Zu weiteren Details lesen Sie bitten den zugehörigen Artikel über [[Development/Tutorials/Debugging/Using Error Messages|Fehlermeldungen]].

Auf anderer Ebene gibt es das Debuggen nach dem Crash. Dies wird verwendet, nachdem die Applikation, vermutlich wegen eines Programmierfehlers, abgestürtzt ist. Der drkonqi Dialog erlaubt Ihnen das Erstellen eines '''Backtrace''' um möglicherweise herauszufinden wo etwas schief gelaufen ist.

Es gibt Debugger wie GDB, die wesentlich mehr tun können als herauszufinden wo es passiert ist. Sie sollten die man-Seite von GDB lesen, um mehr dazu herauszufinden, und eventuell 'kdbg', 'ddd' oder 'inspire' herunterladen, die die Benutzung von GDB stark vereinfachen. Lesen sie hierzu das detailierte Tutorial [[Development/Tutorials/Debugging/Debugging with GDB|Debugging mit GDB]].

== Verwandte Seiten ==
*[[Development/Tutorials/Debugging/Shared Memory Usage in KDE|Verwendung von Shared Memory in KDE]]
*[[Development/Tutorials/Debugging/Using Error Messages|Benutzung von Fehlermeldungen (kDebug)]]
*[[Development/Tutorials/Debugging/Debugging with GDB|Debugging mit GDB]]
*[[Development/Tutorials/Debugging/Debugging IOSlaves|Debugging von IOSlaves]]
*[[Development/Tutorials/Debugging/Debugging on MS Windows|Debugging in MS Windows]]
*[[Development/FAQs/Debugging_FAQ|Debugging FAQ]]
*[[Development/Tutorials/Debugging/How to create useful crash reports|Wie man nützliche Absturzmeldungen erstellt]]
*Zu Informationen über Debugging Tools wie Valgrind und [http://kdbg.org/ KDbg], besuchen Sie die [[../../Tools|Tools Seite]].

[[Category:Programming]]

User:Sschloenvoigt

2008-01-15T18:52:25Z

Sschloenvoigt: New page: Trying to translate some pages to get in touch with KDE ;-)

Trying to translate some pages to get in touch with KDE ;-)

KDE TechBase:Contributors

2008-01-15T18:51:33Z

Sschloenvoigt: /* German Team */

Welcome to the contributors page.

'''This site contains a list of ''active'' contributors. It should help to build teams which maintain KDE TechBase's content. If you have questions about KDE TechBase you can ask/email the corresponding person.'''

Please add yourself to the list where appropriate. If you are inactive, please remove yourself again.

== Administrators ==

This is a list of KDE TechBase administrators.

* [[User:Danimo|Danimo]]
* [[User:Dhaumann|Dhaumann]], <dhaumann at kde dot org>

== Reviewers and Article Writers ==

If you are continuously reviewing KDE TechBase changes or writing articles add yourself to the list.

* [[User:Dhaumann|Dhaumann]], <dhaumann at kde dot org>
* [[User:Milliams|Milliams]]
* name, <email>

== Translation Teams ==

KDE TechBase is [[Help:Wiki Translation|translated]] into many languages. If you translate pages please add yourself to the right translation team.

=== Chinese(simplified) Team ===
* [[User:Liangqi|Liangqi]], cavendish.qi at gmail dot com
* name, <email>

=== Spanish Team ===
* [[User:Mjp ttc|Mjp ttc]], mjp_ttc at yahoo dot com
* name, <email>

=== German Team ===
* [[User:DrSlowDecay|DrSlowDecay]], kde at metalhorde dot de
* [[User:Rememberme|rememberme]] redict dot info at gmx dot net
* [[User:sschloenvoigt|Steffen Schloenvoigt]], steffen at schloenvoigt dot de
* name, <email>

=== Italian Team ===
* [[User:Thunder Teaser|Thunder Teaser]], totokid at gmail dot com
* name, <email>

=== ... Team ===
* name, <email>

Getting Started/Set up KDE 4 for development (de)

2008-01-14T13:08:45Z

Sschloenvoigt: Typo korrigiert

{{Template:I18n/Language Navigation Bar|Getting_Started/Set_up_KDE_4_for_development}}
{{TutorialBrowser|

series=Getting Started|

name=Set up KDE 4 for development|

pre=[[Getting_Started/Build/KDE4|Build KDE 4]]|

next=[[Development|Other development topics]]|

}}

{{note|Diese Seite setzt voraus, dass Sie bereits kdelibs, kdepimlibs und kdebase anhand der der Anleitung unter [[Getting Started/Build/KDE4]] erstellt haben}}

== KDE 4 Anwendungen & Sitzungen starten ==

Um mit der Entwicklung für KDE 4 zu beginnen, gibt es folgende drei Möglichkeiten:
* Sie können [[Getting_Started/Set_up_KDE_4_for_development_(de)#KDE_4_Anwendungen_starten|KDE 4 Anwendungen neben anderen Anwendungen]] in Ihrer aktuellen Desktop Umgebung ausführehn.
* Sie können in Ihre aktuelle Desktop Umgebung [[Getting_Started/Set_up_KDE_4_for_development_(de)#Eingebettete_KDE_4_Sitzung|eine KDE 4 Sitzung einbetten]].
* Sie können [[Getting_Started/Set_up_KDE_4_for_development_(de)#Eigenständige_KDE_4_Sitzung|KDE 4 als eigene Sitzung]] ausführen.

Alle drei Optionen werden nachfolgend beschrieben.

{{Note|
Wenn Sie beim ausführen von KDE 4 Anwendungen Fehler wie den folgenden erhalten:
Qt: Session management error: Could not open network socket
QMutex::lock: Deadlock detected in thread -1241241936
Oder wenn Sie startkde ausführen und es hängenbleibt, lesen Sie [http://www.nabble.com/QMutex::lock:-Deadlock-detected---running-KDE4-apps-%22using-the-normal-shell%22-t3584446.html this article] für einen möglichen Ausweg.
}}

=== KDE 4 Anwendungen starten ===
==== Auf der normalen Shell mit sux ====

Für diese Methode wird das Tool '''sux''' (http://fgouget.free.fr/sux/sux-readme.shtml) benötigt. '''sux''' ist in den meisten Distributionen bereits enthalten. Anderenfalls können Sie auf die unten beschriebene Methode ''Normale Shell ohne sux'' zurückgreifen. '''sux''' erlaubt Ihnen, zu einem anderen Nutzer zu wechseln und konfiguriert dabei automatisch das X Forwarding (Authentifizierung und Export der DISPLAY Variable).

Um sich anzumelden, geben Sie <code bash>sux - kde-devel</code> ein.

Alle Umgebungsvariablen und alles sonstige sollten korrekt von Ihrer {{path|[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]]}}
gesetzt werden. Um eine Applikation zu starten, geben Sie einfach ihren Namen ein; zum Beispiel: <code bash>kwrite</code>
{{Note|
Wenn Sie Fehlermeldungen über fehlende MIME-Typen oder ähnliches erhalten, versuchen Sie folgendes:
* führen Sie <code bash>unset XDG_DATA_DIRS ; kbuildsycoca4</code> aus.
}}

==== Normal Shell ohne sux ====
Die einfachste Methode um KDE 4 Anwendungen zu starten, ist es <tt>su</tt> zur Anmeldung als <tt>kde-devel</tt> Benutzer zu benutzen und dann einfach die gewünschten KDE 4 Anwendung von der Shell aufzurufen. Um sich anzumelden, geben Sie <code bash>su - kde-devel</code>
ein und nachdem Sie Ihr Passwort eingegeben haben führen Sie
<code bash>export DISPLAY=:0</code> aus.
{{Note|Das Exportieren der <tt>DISPLAY</tt> Variable ist nötig, damit die KDE 4 Anwendungen auf Ihrem normalen KDE 3 Desktop erscheinen.}}
Alle Umgebungsvariablen und alles sonstige sollte bereits von Ihrer {{path|[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]]}} korrekt gesetzt worden sein. Um eine Anwendung zu starten, geben sie einfach ihren namen ein; zum Beispiel: <code bash>kwrite</code>
{{Note|
Wenn Sie Fehlermeldungen über fehlende MIME-Typen oder ähnliches erhalten, versuchen Sie folgendes:
* führen Sie <code bash>unset XDG_DATA_DIRS ; kbuildsycoca4</code> aus
}}
{{Note|
Wenn Sie eine Fehlermeldung erhalten, dass Sie sich nicht mit einem X-Server verbinden können, versuchen Sie
<code bash>sudo xhost +local:kde-devel</code>
unter Ihrem normalen KDE 3 Account auszuführen um sicher zu gehen das die Anwendung sich mit der gerade laufenden X-Sitzung verbinden kann.

Obwohl Ihr X-Server ankommende TCP Verbindungen akzeptieren sollte, ist dies oft von Distributionsseite her deaktiviert (so etwa unter Kubuntu Feisty). Wenn Sie <tt>kdm</tt> benutzen, müssen Sie die Datei <tt>/etc/kde3/kdm/kdmrc</tt> als root bearbeiten und überprüfen, das sie nicht folgendes enthält:
<code>ServerArgsLocal=-nolisten tcp</code>
Wenn Sie dies geändert haben, müssen Sie den X-Server neu starten.
Der <tt>xhost</tt> Befehl sollte nun nicht mehr die Meldung "unable to open display" ausgeben.

Aus Bequemlichkeit sollte dies automatisch beim Anmelden ihres normalen Benutzers geschehen. Um dies zu erreichen, erstellen Sie eine neue Datei unter <tt>$HOME/.kde/Autostart</tt> Ihres normalen Benutzers mit dem folgenden Inhalt:
<code bash>
#! /bin/sh
xhost +local:kde-devel
</code>
Stellen Sie sicher, das die neue Datei ausführbar ist, indem Sie <tt>chmod +x</tt> für die Datei ausführen.

Wenn Sie mehr über die '''Sicherheitsrisiken''' in Bezug auf <tt>xhost</tt> erfahren möchten, lesen Sie [http://bau2.uibk.ac.at/matic/xsecur.htm diesen Artikel]
}}

==== Benutzung von SSH ====

Der einfachste Weg um eine KDE 4 Anwendung über SSH auf Ihrem aktuellen Desktop auszuführen, ist es auf folgendem Weg eine Shell mit X-Forwarding zu bekommen:
<code bash>ssh -X kde-devel@localhost</code>
Jetzt können Sie KDE Anwendungen wie gewöhnlich ausführen, zum Beispiel:
<code bash>kwrite</code>
Diese zwei Zeilen können auf einfache Weise kombiniert werden:
<code bash>ssh -X kde-devel@localhost kwrite</code>

{{Note|
Falls Sie Fehlermeldungen erhalten, probieren Sie die Tips aus dem vorhergehenden Abschnitt aus.
}}

===== Anmeldung ohne Passwort =====
Bevor Sie vorherige Methode sinnvoll benutzen können, müssen Sie eine Anmeldung ohne Passwort einrichten. Dafür führen Sie folgenden Befehl unter Ihrem normalen Benutzeraccount aus:
<code bash>ssh-keygen -t rsa</code>
Drücken Sie drei mal RETURN um den Pfad {{path|~/.ssh/id_rsa}} zu akzeptieren und ein leeres Passwort zu vergeben. Anschliessen kopieren Sie die einzelne Zeile aus {{path|~/.ssh/id_rsa.pub}} die Ihnen die Ausgabe von
<code bash>cat ~/.ssh/id_rsa.pub</code> liefert, in die Zwischenablage.
Wechseln Sie nun mit <tt>ssh</tt> zurück zum <tt>kde-devel</tt> Benutzer öffnen Sie die Datei {{path|$HOME/.ssh/authorized_keys}} auf folgende Weise:
ssh -X kde-devel@localhost $HOME/kde/bin/kwrite \
$HOME/.ssh/authorized_keys
Fügen Sie dort die zuvor kopierte Zeile ein, speichern Sie die Datei und beenden Sie KWrite. Versuchen Sie nun nochmal KWrite mit dem gleichen SSH-Befehl auszuführen; Sie sollten nun kein Passwort mehr benötigen:
<code bash>ssh -X kde-devel@localhost $HOME/kde/bin/kwrite</code>

{{warning|Das Anmelden per SSH ohne Passwort birgt gewisse '''Sicherheitsrisiken'''. Vergewissern Sie sich deshalb, dass Ihre <tt>~/.ssh/id_rsa</tt> Datei geschützt ist, indem Sie den Zugriff auf sie mit
<code bash>chmod og-xrw ~/.ssh/id_rsa</code> einschränken (Die Datei sollte diese Rechte eigentlich bereits bei der Erstellung erhalten haben)}}

===== Die SSH desktop Datei =====
Wenn Sie Anwendungen einfacher benutzen wollen, als Sie per SSH-Befehl von der Shell zu starten, besteht ein Weg darin, <tt>.desktop</tt> Dateien zu erstellen die automatisch per <tt>ssh</tt> zum anderen Benutzer wechseln.
{{Note|Dies ist nur dann nützlich, wenn Ihre Desktop-Umgebung .desktop Dateien unterstützt. Immerhin KDE und GNOME tuen dies.}}

Sie können eine existierenden .desktop Datei als Vorlage verwenden (Etwa eine von Ihrem Desktop) oder eine neue erstellen. Die Idee dahinter ist, dem auszuführenden Kommando die SSH-Verbindung auf folgende Weise voranzustellen:
<code bash>
ssh -X kde-devel@localhost $HOME/kde/bin/
</code>

Eine einfache .desktop Datei die KWrite ausführt würde folgenden Inhalt haben:

<code ini>
[Desktop Entry]
Categories=Qt;KDE;TextEditor;
Comment=
DocPath=kwrite/index.html
Encoding=UTF-8
Exec=ssh -X kde-devel@localhost /home/kde-devel/kde/bin/kwrite %U
GenericName=Text Editor
Icon=kwrite
InitialPreference=8
MimeType=text/plain
Name=KWrite (kde-devel)
Path=
StartupNotify=false
Terminal=false
TerminalOptions=
Type=Application
X-DBUS-StartupType=Multi
X-DCOP-ServiceType=non
X-KDE-StartupNotify=true
X-KDE-SubstituteUID=false
X-KDE-Username=
</code>

{{tip|Anwendung, die wie hier über SSH gestartet werden, lösen nicht die korrekten Startereignisse aus, so dass Sie besser die "Startrückmeldung" für Ihre .desktop Dateien deaktivieren sollten.}}

{{note|Um auf diese Weise eine .desktop-Datei für KDE 4 Anwendungen zu erstellen, muss das Paket der Anwendung mit <tt>cmakekde</tt> in <tt>~/kde/bin</tt> installiert worden sein.}}

=== Starten von KDE 4 Sitzungen ===
==== Eingebettete KDE 4 Sitzung ====
{|align="right"
|[[image:Snapshot1.png|right|thumb|200px|Nested]]
|}
Anstatt für die Software-Entwicklung einen vollständigen virtuellen X-Server zu benutzen, können Sie Xephyr zur Einbettung Ihrer KDE 4 Sitzung in Ihr KDE 3 oder eine andere X11-Umgebung verwenden.

Sie können dies auch mit xnest erreichen aber da xnest nicht mit Erweiterungen wie Render umgehen kann, bevorzugen viele Leute Xephyr.

Wenn Sie eine minimale KDE Sitzung verwenden wollen, führen Sie einfach Xephyr aus: (in Kubuntu als xserver-xephyr verfügbar; Gentoo Benutzer kompilieren x11-base/xorg-server mit USE="kdrive"):

Xephyr :1&

Sie können KDE nun ausführen:

export DISPLAY=:1
/path/to/kde4/bin/startkde-modified &

startkde-modified ist eine Kopie des startkde-Skripts welches die folgenden Zeilen am Anfang enthält:

<code bash>
export KDEDIR=`kde4-config --prefix`
export LD_LIBRARY_PATH=$KDEDIR/lib
export PATH=$KDEDIR/bin/:$PATH
export KDEHOME=~/.kde4
</code>

Sie können Xephyr auch mit KDM über das Xdmcp Protokoll benutzen und einfach eine neue KDE 4 Sitzung zu KDM hinzufügen.

Unter Kubuntu können Sie das erreichen indem Sie

<code ini>
[Xdmcp]
# Whether KDM should listen to incoming XDMCP requests.
# Default is true
Enable=false
</code>

in {{path|/etc/kde3/kdm/kdmrc}} zu

<code ini>
[Xdmcp]
# Whether KDM should listen to incoming XDMCP requests.
# Default is true
Enable=true
</code>

verändern und Ihre {{path|/etc/kde3/kdm/Xaccess}} anpassen um ihrem lokalen System Zugriff zu gewähren. Zusätzlich sollten Sie eine Blockierende Regel für alle Ihre externen Schnittstellen für den Xdmcp Port einrichten falls Sie dies auf einem Laptop oder einem PC in einer unsicheren Umgebung verwenden.

Wenn Sie soweit sind, führen Sie einfach Xephyr aus:

Xephyr -query localhost :1 -host-cursor -screen 1024x768&

wobei <tt>-host-cursor</tt> versucht den Cursor des Hosts zu benutzen und <tt>-screen</tt> die Auflösung des Bildschirms festlegt.

Hinweis: Wenn Sie viele Fehlermeldungen bezüglich abgewiesener Verbindungen erhalten, sollten Sie die Option -ac an Xephyr übergeben:

Xephyr -ac :1&

Eine andere Möglichkeit die Sie versuchen können, wenn Sie diese Meldungen erhalten, ist es dem kde-devel Benutzer Zugriff auf den X-Server zu geben. Als root oder mit sudo führen Sie dazu folgenden Befehl aus:

xhost +local:kde-devel

Falls Ihnen Xephyr nicht zur Verfügung steht, können Sie auch Xnest benutzen:

Xnest -ac :1& export DISPLAY=:1

 
-----
{{improve}}
[[User:Sping|Sping]] 00:25, 9 April 2007 (CEST) 
I use this for my start script ''nested_kde4.sh'':

#! /bin/bash
NESTED_KDE_DISPLAY_BACKUP=$DISPLAY
export DISPLAY=:0
Xephyr :1 -screen 1024x768 &
export DISPLAY=:1
$HOME/kde/bin/startkde-modified &
export DISPLAY=${NESTED_KDE_DISPLAY_BACKUP}

Falls Sie folgende Fehlermeldung erhalten:

"Call to lnusertemp failed (temporary directories full?).
Check your installation."

versuchen Sie folgendes:

mkdir /var/tmp/kde-devel-kde4

Der obige Code setzt voraus das sie als Benutzer ''kde-devel'' arbeiten.
{{Note|In den meisten Fällen müssen Sie ''startkde-modified'' mit ''startkde'' ersetzen}}
-----

==== Eigenständige KDE 4 Sitzung ====
{|align="right"
|[[image:solitary.png|right|thumb|200px|Solitary]]
|}
Um eine eigenständige KDE 4 Sitzung auszuführen, können Sie sie entweder, wie gewöhnlich, auf folgende Weise von der Kommandozeile starten:

X :1 & export DISPLAY=:1
startkde

{{Note|Wenn der X-Server die Verbindung verweigert und dabei folgendes ausgibt: <tt>Xlib: connection to ":1.0" refused by server</tt>, versuchen Sie <tt>X -ac :1</tt> stattdessen.}}

oder Sie können KDE 4 zu Ihrem Login Manager hinzufügen. Wenn Sie KDM (oder einen kompatiblen Login Manager) benutzen, wird dies durch Erstellen einer .desktop Datei in entweder {{path|`kde-config --prefix`/share/apps/kdm/sessions/}} oder in {{path|/usr/share/xsessions/}} erreicht. Der einfachste Weg führt dabei über das kopieren einer existierenden {{path|kde.desktop}}-Datei nach {{path|kde4.desktop}}. Öffnen Sie diese neue .desktop-Datei in einem Texteditor und ändern Sie die Einträge zu <tt>Exec</tt>, <tt>TryExec</tt> und <tt>Name</tt> auf folgende Weise:

<code ini>
Exec=$HOME/kde/bin/startkde
TryExec=$HOME/kde/bin/startkde
Name=KDE4
</code>

Ersetzen Sie {{path|$HOME/kde}} in obigem Beispiel mit dem Pfad unter dem Sie KDE 4 installiert haben.

Nach dem Neustart des Login Managers (<tt>Alt+e</tt> in KDM) sollte dieser neue Eintrag im Sitzungs-Menu erscheinen.

{{Note|Sie sollten den Pfad zum 'qdbus' Programm (normalerweise ist dies $QTDIR/bin) in Ihrer $PATH Variable haben um sich erfolgreich anzumelden. Falls es dort nicht ist, werden Sie eine Fehlermeldung "Could not start DBus. Check your installation." erhalten.}}

== Entwicklungs Aufgaben ==
=== KDevelop ===

Dieser Abschnitt wird Ihnen erklären, wie sie KDevelop 3.4 benutzen um KDE 4 Anwendungen zu entwickeln. Wenn sie Fragen, Korrekturen oder Bedenken zu diesem Abschnitt haben, notieren Sie diese bitte auf der Diskussions-Seite.

==== Voraussetzungen ====

Sie benötigen hierfür mindestens KDevelop 3.4, das immernoch eine KDE 3 Anwendung ist. Versionen vor 3.4 haben unter anderem keine Qt 4 Unterstützung. Die KDE 4 Version von KDevelop ist für den produktiven Einsatz noch nicht geeignet. Sie erhalten KDevelop auf der [http://www.kdevelop.org/index.html?filename=3.4/download.html KDevelop Homepage]. Installieren Sie KDevelop wie alle anderen KDE 3 Anwendungen unter Ihrem normalen Benutzer und '''nicht''' mit Ihrem ''kde-devel'' Benutzer.

Sie benötigen ausserdem die neueste ''GDB'' Version. Die aktuelle ist 6.6.0.

Weiterhin müssen Sie die kdelibs API Dokumentation lokal vorliegend haben, was unter [[Getting_Started/Build/KDE4#Generating_local_API_documentation|Anleitung zum Erstellen]] beschrieben wird.

Ausserdem benötigen Sie noch ''ctags'', ''htdig'', ''htmerge'' und ''htsearch''. ''valgrind'' und ''callgrind'' könnten auch nützlich sein.

Stellen Sie sicher, das sie den Schritten unter KDE 4 [[Getting_Started/Build/KDE4|Anleitung zum Erstellen]] befolgt und eine funktionierende KDE 4 Umgebung erstellt haben. Prüfen Sie, ob sich einfache KDE 4 Anwendungen wie ''Konsole'' oder ''KWrite'' von der Kommandozeile des kde-devel Benutzers ohne Probleme starten lassen.

Die folgenden Schritte werden alle mit dem '''kde-devel''' Benutzer ausgeführt. Sie müssen sich mit <code bash>su - kde-devel</code> unter diesem Benutzer anmelden.

==== Die Umgebung aufsetzen ====

KDevelop hat keine native Unterstützung für CMake Projekte. Glücklicherweise hat CMake die Fähigkeit selbst KDevelop Projekt Dateien zu erstellen. Um dies zu erreichen, müssen Sie CMake den Parameter ''-GKDevelop3'' übergeben. Dies bewegt CMake dazu, Projektdateien für KDevelop neben den normalen Makefiles zu erstellen. Der beste Weg dazu ist es, die '''cmakekde ''' Funktion in Ihrer [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|{{path|.bashrc}}]] anzupassen. Ändern Sie einfach
<code bash>
cmake $srcFolder -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull&& \
make && \
make install;
</code>
in
<code bash>
cmake $srcFolder -GKDevelop3 -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull&& \
make && \
make install;
</code>

Nachdem Sie das getan haben, melden Sie sich erneut an, damit sich die Veränderungen an der {{path|.bashrc}} Datei auswirken. Dann müssen Sie ''cmakekde'' erneut im (Wurzel) build Verzeichnis des Projekts an dem Sie mit KDevelop arbeiten wollen (wenn sie vorher nicht ''-GKDevelop3'' im [[Getting_Started/Build/KDE4#Setting_up_the_environment|Erstellungsschritt]] ausgeführt haben). Wenn Sie zum Beispiel an Konsole, welches in ''kdebase'' liegt, arbeiten möchten, müssen Sie cmakekde im {{path|$KDE_BUILD/KDE/kdebase}} Verzeichnis ausführen. Dies erstellt unglücklicherweise alles erneut, aber nur einmal wenn Sie den Generator ändern.

Da alle Umgebungsvariablen des kde-devel Benutzers KDE 4 spezifisch sind, müssen diese zurückgesetzt werden, um der KDE 3 Umgebung zu entsprechen bevor KDevelop gestartet wird. Am einfachsten wird dies erreicht, indem Sie folgende Funktion zu Ihrer {{path|.bashrc}} hinzufügen:

<code bash>
function start3app {
mkdir -p /tmp/$USER-kde
export PATH=/opt/kde3/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/bin/X11:/usr/games
export LD_LIBRARY_PATH=
export KDETMP=/tmp/$USER-kde
export KDEVARTMP=/var/tmp/$USER-kde
export KDEHOME=$HOME/.kde
export KDEDIR=/usr
export KDEDIRS=$KDEDIR
export DISPLAY=:0
eval "$@"
source $HOME/.bashrc #Reset environment variables again
}
</code>

Die ''PATH'' und ''LD_LIBRARY_PATH'' Variable werden vom KDE 3 Benutzer übernommen, und sie könnten auf Ihrem System abweichen, Geben Sie <code bash>echo $PATH</code> und <code bash>echo $LD_LIBRARY_PATH</code> als normaler KDE 3 Benutzer ein, um diese Werte zu erhalten. Die obigen Funktion nimmt an, das KDE 3 im {{path|/usr}} Verzeichnis installiert ist, wie es unter Debian-Systemen der Fall ist. Falls Ihr KDE 3 in einem anderen Verzeichnis installiert ist, müssen Sie die Zeile die ''KDEDIR'' setzt entsprechend anpassen. Hier ist ein Beispiel, wie sie herausfinden unter welchem Verzeichnis KDE installiert ist; in diesem Beispiel ist es /opt/kde3:

<code bash>
kde-config --prefix
/opt/kde3
</code>

Jetzt sollten Sie KDevelop starten können, indem Sie <tt>start3app kdevelop</tt> eingeben. Machen sie dies jetzt.

{{tip|
Sie können jede KDE 3 Anwendung mit der <tt>start3app</tt> Funktion starten. Nützlich ist das zum Beispiele für ''Kompare'' und ''kdesvn''.

Sie können jedoch auf diesem Weg nicht ''KDbg'' starten umd KDE 4 Anwendungen zu debuggen, da sonst die die Umgebungsvariablen für die debuggte Anwendung falsch sind.
}}


===== TroubleShooting =====

'''Symptom:''' kdevelop meldet "cannot talk to klauncher". Sie können keine Datei öffnen.

'''Lösung:''' fügen Sie Ihren KDE Bibliotheks-Pfad zum LD_LIBRARY_PATH hinzu, e.g.:
export LD_LIBRARY_PATH=/opt/kde3/lib

==== Einrichten von KDevelop ====

Jetzt, da KDevelop gestartet ist, müssen Sie einige Einstellung vornehmen.
Gehen Sie dafür nach ''Einstellungen->KDevelop einrichten...->Dokumentation''. Entfernen Sie alle Einträge die für KDE 4 nicht relevant sind.

{{note| Obwohl Umgebungsvariablen wie $HOME in diesem Abschnitt verwendet werden, sollten Sie diese mit echten Pfaden ersetzen, da KDevelop keine Umgebungsvariablen auflöst.}

Optional können Sie die kdelibs API Dokumentation hinzufügen. Sie müssen sie [[Getting_Started/Build/KDE4#Generating_local_API_documentation|zuvor erstellen]]. Dann fügen sie die Dokumentation durch Klick auf ''Hinzufügen...'' hinzu. In diesem Dialog verwenden Sie folgende Einstellungen:
* ''Typ'': Doxygen Documentation Collection (muss zuerst eingestellt werden)
* ''Ort'': {{path|$KDE_SRC/KDE/kdelibs/kdelibs-apidocs/index.html}}

Fügen Sie nun die Qt API Dokumentation hinzu, indem Sie folgende Einstellungen verwenden:
* ''Typ'': Qt Documentation Collection (muss zuerst eingestellt werden)
* ''Ort'': {{path|$HOME/qt-copy/doc/html/qt.dcf}}

Nachdem Sie die Dokumentation für kdelibs und die Qt API hinzugefügt haben, stellen sie sicher das alle Checkboxen (''TOC'',''Index'' und ''Suche'') aktiviert sind. Dann gehen Sie auf den Tab ''Volltextsuche'' und stellen sicherm das die Pfade zu den Programmen ''htdig'', ''htmerge'' und ''htsearch'' korrekt sind. Sie können den Einstellungs-Dialog nun schliessen.

Jetzt ist es an der Zeit das Projekt an dem Sie arbeiten möchten zu öffen indem sie auf ''Projekt->Projekt öffnen'' klicken. Die Projektdateien befinden sich im build-Verzeichnis. Für Konsole müssen Sie zum Beispiel die Datei {{path|$KDE_BUILD/KDE/kdebase/apps/konsole/konsole.kdevelop}} öffnen. Sie müssen nun einige Projektspezifische Einstellungen unter ''Projekt->Projekt Optionen'' vornehmen. Sie müssen das für jedes Projekt machen, an dem Sie arbeiten möchten.

{{note|
Manchmal ist keine KDevelop Projektdatei für das Verzeichnis in dem Sie arbeiten möchten verfügbar.

Dies kann verschieden Gründe haben, es hängt davon ab wie die CMake-Dateien geschrieben wurden. Für gewöhnlich sollten CMake-Dateien, die eine <tt>project(projectname)</tt> Anweisung enthalten gut funktionieren. Wenn Sie mit CMake vertraut genug sind, können Sie versuchen, diese Anweisung hinzuzufügen.

Ein Workaround dafür ist es, einfach die KDevelop Projektdatei eines darüberliegenden Ordners zu verwenden. In diesem Fall müssen Sie den <tt>Make Active Directory</tt> Eintrag im Kontextmenu des <tt>File Selectors</tt> in der Sidebar benutzen. Damit können Sie die anderen, unerwünschten Verzeichnisse beim erstellen und installieren ignorieren.
}}

* ''C++ Unterstützung->Codevervollständigung''
:Hier müssen Sie die Vervollständigungs-Datenbanken für Qt und kdelibs hinzufügen und natürlich noch mehr wenn Sie mögen. Zum Beispiel könnten Sie eine Datenbank für ''kdepimlibs'' benötigen wenn sie an ''kdepim'' arbeiten.

:Für kdelibs klicken Sie den ''Hinzufügen...'' Button und wählen ''KDevelop Custom Directory PCS Importer'', dann fügen Sie Ihr KDE include Verzeichnis ({{path|$HOME/kde/include}}) zur Liste hinzu und fahren fort. Sie können den Dateiauswahldialog und den ''Hinzufügen...'' Button benutzen um es hinzuzufügen.

:Jetzt fügen Sie die Datenbank für Qt 4 hinzu indem Sie ''KDevelop Qt4 PCS Importer'' auswählen. Sie müssen das Qt 4 include-Verzeichnis welches Sie unter {{path|$HOME/qt-copy/include}} finden hinzufügen.

{{note|Der Qt4 PCS Importer wird nur benötigt wenn Qt4 nicht installiert wurde, sie es also zum Beispiel direkt aus dem build-Verzeichnis heraus nutzen. Der Nachteil ber der Benutzung des Qt4 Importers ist das er während des Imports keinen Fortschritt anzeigt und die Applikation zu hängen scheint. Die Alternative ist es den Custom Directory PCS Importer dafür zu benutzen}}

* ''C++ Unterstützung->Qt Optionen''
:Aktivieren Sie ''Qt Options aktivieren'' und wählen Sie Qt4 als Ihre Version. Setzen Sie den ''QMake Binary'' Pfad auf {{path|$HOME/qt-copy/bin/qmake}}. Dann wählen Sie ''Qt 4 style'' als ''Qt include syntax''. Benutzen Sie {{path|$HOME/qt-copy/bin/designer}} für ''Designer Binary''. Benutzen Sie den ''Pluginpfade ändern'' Dialog um das Plugin-Verzeichnis von KDE hinzufügen und so die KDE widgets im Designer zu sehen. Um das zu erreichen fügen Sie {{path|$HOME/kde/lib/kde4/plugins}} in das Textfeld ein und klicken den ''Hinzufügen''-Button.

* ''Ausführungs Optionen''
:Stellen Sie sicher das für ''Executable'' der korrekte Wert eingestellt ist. Wenn Sie zum Beispiel Konsole ausführen wollen, geben Sie {{path|$KDE_BUILD/KDE/kdebase/apps/konsole/src/konsole}} an. Sie sollten ''--nofork'' zu den ''Debug Parametern'' hinzufügen oder das Debuggen von einigen Anwendungen wie ''KMail'' wird fehlschlagen.

:Da die ''start3app'' Funktion einige Umgebungsvariablen anpasst, müssen Sie diese hier zurücksetzen damit KDE 4 Anwendungen problemlos aus KDevelop heraus ausgeführt werden können.
:Für einige Anwendungen, wie Konsole, ist dies nicht unbedingt nötig aber andere wie KMail werden abstürzen wenn Sie die Variablen nicht anpassen.
:Klicken Sie einfach auf den ''Hinzufügen / Kopieren'' Button um neue Umgebungsvariablen hinzuzufügen. Sie werden die folgenden brauchen, die die selben wie in Ihrer [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|{{path|.bashrc}}]] sind:

:{| border="1"
|-
! Name
! Value
|-
| KDEHOME
| $HOME/.kde4
|-
| PATH
| $KDEDIR/bin:$QTDIR/bin:/usr/local/bin:$PATH
|-
| LD_LIBRARY_PATH
| $KDEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH
|-
| KDETMP
| /tmp/$USER-kde4
|-
| KDEVARTMP
| /var/tmp/$USER-kde4
|-
| KDEDIR
| $HOME/kde
|-
| KDEDIRS
| $KDEDIR
|-
| LD_BIND_NOW
| 42
|}

* ''Erstellungs Optionen->Erstellung''
:Stellen Sie sicher das hier das korrekte build-Verzeichnis eingetragen ist. Für Konsole ist es wiederum dieses: {{path|$KDE_BUILD/KDE/kdebase/apps/konsole}}.

* ''Erstellungs Optionen->Make''
:Sie sollten ''Abruch bei erstem Fehler'' aktivieren. Ausserdem sollten Sie ''VERBOSE='' oder ''VERBOSE=1'' zu ''Weitere Make Optionen'' hinzufügen um Aussagekraft des Erstellungsprozesses zu steuern.

:Wenn Sie mehr als einen Prozessor haben oder Sie Zugriff auf einen icecream cluster besitzen, sollten Sie die Option ''Mehrere Jobs ausführen'' aktivieren u nd die ''Anzahl der gleichzeitigen Prozesse'' auf die Anzahl der verfügbaren Prozessoren einstellen. Dies erhöht die Kompilierungsgeschwindigkeit. Es ist dsa gleiche wie die <tt>-j</tt> Option für ''Make''.

* ''Formatierung''
:Sie sollten alle Optionen hier so setzen, das sie zu dem Coding-Stil des Projekts an dem Sie arbeiten passen.

* ''CTags->Allgemein''
:Sie müssen den ''Pfad zur CTag Binary'' korrekt setzen, die sich in Debian unter {{path|/usr/bin/ctags}} befindet.

:Am besten aktivieren Sie noch die Option <tt>Bei mehr als einem Treffer, direkt zum Ersten gehen</tt>.

Jetzt sind Sie damit fertig Ihre Projekt-spezifischen Einstellungen zu konfigurieren. Sie sollten nun unter ''Einstellungen->Plugins konfigurieren...'' einige Plugins entfernen, die Sie nicht benötigen. Ich deaktiviere beispielsweise folgende Plugins:

Abbreviation Expansion, Code Snippets, Doxygen Support, Embedded Konsole, File Tree, '''Final Packaging Support''', "Open with" Menu Addon, QuickOpen, Regular Expression Tester, Scripting, '''Security Checker''', Shell Filtering and Insertion, Text Structure and Tools Menu Addition.

Sie sollten zumindest die Fettgedruckten entfernen.

Jetzt öffnen Sie, falls noch nicht geschehen, irgendeine Quelldatei. Dies aktiviert den Menueintrag ''Einstellungen->Editor konfigurieren...'', wo Sie die Tabulatoroptionen so einstellen müssen wie Sie im Projekt an dem Sie arbeiten benutzt werden. Die wichtigsten Einstellungen sind:
* ''Erscheinungsbild->Rahmen->Zeilennummern anzeigen'': Sollte aktiviert sein.
* ''Erscheinungsbild->Rahmen->Symbolränder anzeigen'': Sollte aktiviert sein.
* ''Bearbeiten->Tabulatoren''
* ''Bearbeiten->Statischer Zeilenumbruch->Markierung anzeigen'': Sollte aktiviert sein
* ''Einrückung->Automatische Einrückung->Einrückungs-Modus'': Sollte ''C Style'' sein
* ''Einrückung'' insgesamt

Im Hauptfenster klicken Sie auf den Tab ''CTags'' in der unteren Tableiset, dann klicken Sie auf ''Neu erstellen'' um eine CTags-Datenbank zur einfacheren Navigation im Quellcode zu erstellen.

Jetzt haben Sie alle wesentlichen Einstellunge vorgenommen, Gratulation!

==== KDevelop benutzen ====

Wenden Sie sich an das [http://docs.kde.org/development/en/kdevelop/kdevelop/ KDevelop Handbuch (englisch)] um generell Hilfe zu Ihrer Arbeit mit KDevelop zu erhalten. Der folgende Abschnitt wird nur Spezialfälle im Bezug auf KDE 4 enthalten.

===== Debugging =====

KDE Anwendungen haben viele Symbole, was bedeutet, dass sie viel Speicher benötigen um eine angemessene Ladezeit beim Debuggen zu erreichen. Um einen GDB Entwickler zu zitieren: "
KDE apps have many symbols, which means that you need a lot of memory to get a decent loading times for debugging. To quote a GDB developer: "Ich würde mich weigern KDE auf etwas mit unter 1 GB RAM zu debuggen."
Wenn die Schrittfunktion des Debuggers zu langsam für Sie ist, versuchen Sie folgende Tips:
* Lokale Variablen verstecken. Der <tt>Lokal</tt> Teil im linken Variablen Tab verursacht einen erheblichen Geschwindigkeitsrückgang bei der Schrittweisen Ausführung wenn Sie viele lokale Variablen haben. Klappen sie einfach den <tt>Lokal</tt> Teil des Baums zu, die lokalen Variablen werden nun nicht bei jedem Schritt aktualisiert. Sie können immernoch die Variablen untersuchen indem sie die <tt>Ausdruck evaluieren</tt> Funktion benutzen.
* Benutzen Sie den Patch unter http://bugs.kde.org/show_bug.cgi?id=143977. Es verhindert die Aktualisierung des Framestack-Widgets bei jedem Schritt und beschleunigt damit die Schrittweise Ausführung erheblich. Der Patch führt zu einigen kleineren Ungereimtheiten weshalb er bisher noch nicht commited wurde.

{{Note|
KDevelop unterstützt bisher keine Änderungen am CMake build System. Das bedeutet, das Sie KDevelop nicht dazu benutzen können, Dateien zum Projekt hinzuzufügen oder zu entfernen oder irgend einen anderen Aspekt des Buildprozesses Ihres Projekts zu modifizieren.

Sie müssen stattdessen die CMake Dateien per Hand anpassen und dann erneut <tt>cmakekde</tt> ausführen. Lesen Sie das [[Development/Tutorials/CMake|CMake Tutorial]] um zu lernen wie man das macht.
}}

{{tip|Wenn Sie an Bibliotheken arbeiten, müssen Sie diese zuerst installieren bevor Sie Ihre Änderungen an diesen testen oder debuggen können.
Da this lästig und zeitverschlingend ist, sollten Sie für alle betreffenden Bibliotheken Symlinks erstellen ''(ln -s)'', die aus dem Build-Verzeichnis auf das Installations-Verzeichnis verweisen.

Oft benutzen selbst einfache Programme interne Bibliotheken, zum Beispiel ist der Einstellungsdialog von Konsole in Wirklichkeit eine Bibliothek,}}

[[Category:KDE4]]

Getting Started/Set up KDE 4 for development (de)

2008-01-14T13:08:03Z

Sschloenvoigt: Übersetzung ins Deutsche

{{Template:I18n/Language Navigation Bar|Getting_Started/Set_up_KDE_4_for_development}}
{{TutorialBrowser|

series=Getting Started|

name=Set up KDE 4 for development|

pre=[[Getting_Started/Build/KDE4|Build KDE 4]]|

next=[[Development|Other development topics]]|

}}

{{note|Diese Seite setzt voraus, dass Sie bereits kdelibs, kdepimlibs und kdebase anhander der Anleitung unter [[Getting Started/Build/KDE4]] erstellt haben}}

== KDE 4 Anwendungen & Sitzungen starten ==

Um mit der Entwicklung für KDE 4 zu beginnen, gibt es folgende drei Möglichkeiten:
* Sie können [[Getting_Started/Set_up_KDE_4_for_development_(de)#KDE_4_Anwendungen_starten|KDE 4 Anwendungen neben anderen Anwendungen]] in Ihrer aktuellen Desktop Umgebung ausführehn.
* Sie können in Ihre aktuelle Desktop Umgebung [[Getting_Started/Set_up_KDE_4_for_development_(de)#Eingebettete_KDE_4_Sitzung|eine KDE 4 Sitzung einbetten]].
* Sie können [[Getting_Started/Set_up_KDE_4_for_development_(de)#Eigenständige_KDE_4_Sitzung|KDE 4 als eigene Sitzung]] ausführen.

Alle drei Optionen werden nachfolgend beschrieben.

{{Note|
Wenn Sie beim ausführen von KDE 4 Anwendungen Fehler wie den folgenden erhalten:
Qt: Session management error: Could not open network socket
QMutex::lock: Deadlock detected in thread -1241241936
Oder wenn Sie startkde ausführen und es hängenbleibt, lesen Sie [http://www.nabble.com/QMutex::lock:-Deadlock-detected---running-KDE4-apps-%22using-the-normal-shell%22-t3584446.html this article] für einen möglichen Ausweg.
}}

=== KDE 4 Anwendungen starten ===
==== Auf der normalen Shell mit sux ====

Für diese Methode wird das Tool '''sux''' (http://fgouget.free.fr/sux/sux-readme.shtml) benötigt. '''sux''' ist in den meisten Distributionen bereits enthalten. Anderenfalls können Sie auf die unten beschriebene Methode ''Normale Shell ohne sux'' zurückgreifen. '''sux''' erlaubt Ihnen, zu einem anderen Nutzer zu wechseln und konfiguriert dabei automatisch das X Forwarding (Authentifizierung und Export der DISPLAY Variable).

Um sich anzumelden, geben Sie <code bash>sux - kde-devel</code> ein.

Alle Umgebungsvariablen und alles sonstige sollten korrekt von Ihrer {{path|[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]]}}
gesetzt werden. Um eine Applikation zu starten, geben Sie einfach ihren Namen ein; zum Beispiel: <code bash>kwrite</code>
{{Note|
Wenn Sie Fehlermeldungen über fehlende MIME-Typen oder ähnliches erhalten, versuchen Sie folgendes:
* führen Sie <code bash>unset XDG_DATA_DIRS ; kbuildsycoca4</code> aus.
}}

==== Normal Shell ohne sux ====
Die einfachste Methode um KDE 4 Anwendungen zu starten, ist es <tt>su</tt> zur Anmeldung als <tt>kde-devel</tt> Benutzer zu benutzen und dann einfach die gewünschten KDE 4 Anwendung von der Shell aufzurufen. Um sich anzumelden, geben Sie <code bash>su - kde-devel</code>
ein und nachdem Sie Ihr Passwort eingegeben haben führen Sie
<code bash>export DISPLAY=:0</code> aus.
{{Note|Das Exportieren der <tt>DISPLAY</tt> Variable ist nötig, damit die KDE 4 Anwendungen auf Ihrem normalen KDE 3 Desktop erscheinen.}}
Alle Umgebungsvariablen und alles sonstige sollte bereits von Ihrer {{path|[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]]}} korrekt gesetzt worden sein. Um eine Anwendung zu starten, geben sie einfach ihren namen ein; zum Beispiel: <code bash>kwrite</code>
{{Note|
Wenn Sie Fehlermeldungen über fehlende MIME-Typen oder ähnliches erhalten, versuchen Sie folgendes:
* führen Sie <code bash>unset XDG_DATA_DIRS ; kbuildsycoca4</code> aus
}}
{{Note|
Wenn Sie eine Fehlermeldung erhalten, dass Sie sich nicht mit einem X-Server verbinden können, versuchen Sie
<code bash>sudo xhost +local:kde-devel</code>
unter Ihrem normalen KDE 3 Account auszuführen um sicher zu gehen das die Anwendung sich mit der gerade laufenden X-Sitzung verbinden kann.

Obwohl Ihr X-Server ankommende TCP Verbindungen akzeptieren sollte, ist dies oft von Distributionsseite her deaktiviert (so etwa unter Kubuntu Feisty). Wenn Sie <tt>kdm</tt> benutzen, müssen Sie die Datei <tt>/etc/kde3/kdm/kdmrc</tt> als root bearbeiten und überprüfen, das sie nicht folgendes enthält:
<code>ServerArgsLocal=-nolisten tcp</code>
Wenn Sie dies geändert haben, müssen Sie den X-Server neu starten.
Der <tt>xhost</tt> Befehl sollte nun nicht mehr die Meldung "unable to open display" ausgeben.

Aus Bequemlichkeit sollte dies automatisch beim Anmelden ihres normalen Benutzers geschehen. Um dies zu erreichen, erstellen Sie eine neue Datei unter <tt>$HOME/.kde/Autostart</tt> Ihres normalen Benutzers mit dem folgenden Inhalt:
<code bash>
#! /bin/sh
xhost +local:kde-devel
</code>
Stellen Sie sicher, das die neue Datei ausführbar ist, indem Sie <tt>chmod +x</tt> für die Datei ausführen.

Wenn Sie mehr über die '''Sicherheitsrisiken''' in Bezug auf <tt>xhost</tt> erfahren möchten, lesen Sie [http://bau2.uibk.ac.at/matic/xsecur.htm diesen Artikel]
}}

==== Benutzung von SSH ====

Der einfachste Weg um eine KDE 4 Anwendung über SSH auf Ihrem aktuellen Desktop auszuführen, ist es auf folgendem Weg eine Shell mit X-Forwarding zu bekommen:
<code bash>ssh -X kde-devel@localhost</code>
Jetzt können Sie KDE Anwendungen wie gewöhnlich ausführen, zum Beispiel:
<code bash>kwrite</code>
Diese zwei Zeilen können auf einfache Weise kombiniert werden:
<code bash>ssh -X kde-devel@localhost kwrite</code>

{{Note|
Falls Sie Fehlermeldungen erhalten, probieren Sie die Tips aus dem vorhergehenden Abschnitt aus.
}}

===== Anmeldung ohne Passwort =====
Bevor Sie vorherige Methode sinnvoll benutzen können, müssen Sie eine Anmeldung ohne Passwort einrichten. Dafür führen Sie folgenden Befehl unter Ihrem normalen Benutzeraccount aus:
<code bash>ssh-keygen -t rsa</code>
Drücken Sie drei mal RETURN um den Pfad {{path|~/.ssh/id_rsa}} zu akzeptieren und ein leeres Passwort zu vergeben. Anschliessen kopieren Sie die einzelne Zeile aus {{path|~/.ssh/id_rsa.pub}} die Ihnen die Ausgabe von
<code bash>cat ~/.ssh/id_rsa.pub</code> liefert, in die Zwischenablage.
Wechseln Sie nun mit <tt>ssh</tt> zurück zum <tt>kde-devel</tt> Benutzer öffnen Sie die Datei {{path|$HOME/.ssh/authorized_keys}} auf folgende Weise:
ssh -X kde-devel@localhost $HOME/kde/bin/kwrite \
$HOME/.ssh/authorized_keys
Fügen Sie dort die zuvor kopierte Zeile ein, speichern Sie die Datei und beenden Sie KWrite. Versuchen Sie nun nochmal KWrite mit dem gleichen SSH-Befehl auszuführen; Sie sollten nun kein Passwort mehr benötigen:
<code bash>ssh -X kde-devel@localhost $HOME/kde/bin/kwrite</code>

{{warning|Das Anmelden per SSH ohne Passwort birgt gewisse '''Sicherheitsrisiken'''. Vergewissern Sie sich deshalb, dass Ihre <tt>~/.ssh/id_rsa</tt> Datei geschützt ist, indem Sie den Zugriff auf sie mit
<code bash>chmod og-xrw ~/.ssh/id_rsa</code> einschränken (Die Datei sollte diese Rechte eigentlich bereits bei der Erstellung erhalten haben)}}

===== Die SSH desktop Datei =====
Wenn Sie Anwendungen einfacher benutzen wollen, als Sie per SSH-Befehl von der Shell zu starten, besteht ein Weg darin, <tt>.desktop</tt> Dateien zu erstellen die automatisch per <tt>ssh</tt> zum anderen Benutzer wechseln.
{{Note|Dies ist nur dann nützlich, wenn Ihre Desktop-Umgebung .desktop Dateien unterstützt. Immerhin KDE und GNOME tuen dies.}}

Sie können eine existierenden .desktop Datei als Vorlage verwenden (Etwa eine von Ihrem Desktop) oder eine neue erstellen. Die Idee dahinter ist, dem auszuführenden Kommando die SSH-Verbindung auf folgende Weise voranzustellen:
<code bash>
ssh -X kde-devel@localhost $HOME/kde/bin/
</code>

Eine einfache .desktop Datei die KWrite ausführt würde folgenden Inhalt haben:

<code ini>
[Desktop Entry]
Categories=Qt;KDE;TextEditor;
Comment=
DocPath=kwrite/index.html
Encoding=UTF-8
Exec=ssh -X kde-devel@localhost /home/kde-devel/kde/bin/kwrite %U
GenericName=Text Editor
Icon=kwrite
InitialPreference=8
MimeType=text/plain
Name=KWrite (kde-devel)
Path=
StartupNotify=false
Terminal=false
TerminalOptions=
Type=Application
X-DBUS-StartupType=Multi
X-DCOP-ServiceType=non
X-KDE-StartupNotify=true
X-KDE-SubstituteUID=false
X-KDE-Username=
</code>

{{tip|Anwendung, die wie hier über SSH gestartet werden, lösen nicht die korrekten Startereignisse aus, so dass Sie besser die "Startrückmeldung" für Ihre .desktop Dateien deaktivieren sollten.}}

{{note|Um auf diese Weise eine .desktop-Datei für KDE 4 Anwendungen zu erstellen, muss das Paket der Anwendung mit <tt>cmakekde</tt> in <tt>~/kde/bin</tt> installiert worden sein.}}

=== Starten von KDE 4 Sitzungen ===
==== Eingebettete KDE 4 Sitzung ====
{|align="right"
|[[image:Snapshot1.png|right|thumb|200px|Nested]]
|}
Anstatt für die Software-Entwicklung einen vollständigen virtuellen X-Server zu benutzen, können Sie Xephyr zur Einbettung Ihrer KDE 4 Sitzung in Ihr KDE 3 oder eine andere X11-Umgebung verwenden.

Sie können dies auch mit xnest erreichen aber da xnest nicht mit Erweiterungen wie Render umgehen kann, bevorzugen viele Leute Xephyr.

Wenn Sie eine minimale KDE Sitzung verwenden wollen, führen Sie einfach Xephyr aus: (in Kubuntu als xserver-xephyr verfügbar; Gentoo Benutzer kompilieren x11-base/xorg-server mit USE="kdrive"):

Xephyr :1&

Sie können KDE nun ausführen:

export DISPLAY=:1
/path/to/kde4/bin/startkde-modified &

startkde-modified ist eine Kopie des startkde-Skripts welches die folgenden Zeilen am Anfang enthält:

<code bash>
export KDEDIR=`kde4-config --prefix`
export LD_LIBRARY_PATH=$KDEDIR/lib
export PATH=$KDEDIR/bin/:$PATH
export KDEHOME=~/.kde4
</code>

Sie können Xephyr auch mit KDM über das Xdmcp Protokoll benutzen und einfach eine neue KDE 4 Sitzung zu KDM hinzufügen.

Unter Kubuntu können Sie das erreichen indem Sie

<code ini>
[Xdmcp]
# Whether KDM should listen to incoming XDMCP requests.
# Default is true
Enable=false
</code>

in {{path|/etc/kde3/kdm/kdmrc}} zu

<code ini>
[Xdmcp]
# Whether KDM should listen to incoming XDMCP requests.
# Default is true
Enable=true
</code>

verändern und Ihre {{path|/etc/kde3/kdm/Xaccess}} anpassen um ihrem lokalen System Zugriff zu gewähren. Zusätzlich sollten Sie eine Blockierende Regel für alle Ihre externen Schnittstellen für den Xdmcp Port einrichten falls Sie dies auf einem Laptop oder einem PC in einer unsicheren Umgebung verwenden.

Wenn Sie soweit sind, führen Sie einfach Xephyr aus:

Xephyr -query localhost :1 -host-cursor -screen 1024x768&

wobei <tt>-host-cursor</tt> versucht den Cursor des Hosts zu benutzen und <tt>-screen</tt> die Auflösung des Bildschirms festlegt.

Hinweis: Wenn Sie viele Fehlermeldungen bezüglich abgewiesener Verbindungen erhalten, sollten Sie die Option -ac an Xephyr übergeben:

Xephyr -ac :1&

Eine andere Möglichkeit die Sie versuchen können, wenn Sie diese Meldungen erhalten, ist es dem kde-devel Benutzer Zugriff auf den X-Server zu geben. Als root oder mit sudo führen Sie dazu folgenden Befehl aus:

xhost +local:kde-devel

Falls Ihnen Xephyr nicht zur Verfügung steht, können Sie auch Xnest benutzen:

Xnest -ac :1& export DISPLAY=:1

 
-----
{{improve}}
[[User:Sping|Sping]] 00:25, 9 April 2007 (CEST) 
I use this for my start script ''nested_kde4.sh'':

#! /bin/bash
NESTED_KDE_DISPLAY_BACKUP=$DISPLAY
export DISPLAY=:0
Xephyr :1 -screen 1024x768 &
export DISPLAY=:1
$HOME/kde/bin/startkde-modified &
export DISPLAY=${NESTED_KDE_DISPLAY_BACKUP}

Falls Sie folgende Fehlermeldung erhalten:

"Call to lnusertemp failed (temporary directories full?).
Check your installation."

versuchen Sie folgendes:

mkdir /var/tmp/kde-devel-kde4

Der obige Code setzt voraus das sie als Benutzer ''kde-devel'' arbeiten.
{{Note|In den meisten Fällen müssen Sie ''startkde-modified'' mit ''startkde'' ersetzen}}
-----

==== Eigenständige KDE 4 Sitzung ====
{|align="right"
|[[image:solitary.png|right|thumb|200px|Solitary]]
|}
Um eine eigenständige KDE 4 Sitzung auszuführen, können Sie sie entweder, wie gewöhnlich, auf folgende Weise von der Kommandozeile starten:

X :1 & export DISPLAY=:1
startkde

{{Note|Wenn der X-Server die Verbindung verweigert und dabei folgendes ausgibt: <tt>Xlib: connection to ":1.0" refused by server</tt>, versuchen Sie <tt>X -ac :1</tt> stattdessen.}}

oder Sie können KDE 4 zu Ihrem Login Manager hinzufügen. Wenn Sie KDM (oder einen kompatiblen Login Manager) benutzen, wird dies durch Erstellen einer .desktop Datei in entweder {{path|`kde-config --prefix`/share/apps/kdm/sessions/}} oder in {{path|/usr/share/xsessions/}} erreicht. Der einfachste Weg führt dabei über das kopieren einer existierenden {{path|kde.desktop}}-Datei nach {{path|kde4.desktop}}. Öffnen Sie diese neue .desktop-Datei in einem Texteditor und ändern Sie die Einträge zu <tt>Exec</tt>, <tt>TryExec</tt> und <tt>Name</tt> auf folgende Weise:

<code ini>
Exec=$HOME/kde/bin/startkde
TryExec=$HOME/kde/bin/startkde
Name=KDE4
</code>

Ersetzen Sie {{path|$HOME/kde}} in obigem Beispiel mit dem Pfad unter dem Sie KDE 4 installiert haben.

Nach dem Neustart des Login Managers (<tt>Alt+e</tt> in KDM) sollte dieser neue Eintrag im Sitzungs-Menu erscheinen.

{{Note|Sie sollten den Pfad zum 'qdbus' Programm (normalerweise ist dies $QTDIR/bin) in Ihrer $PATH Variable haben um sich erfolgreich anzumelden. Falls es dort nicht ist, werden Sie eine Fehlermeldung "Could not start DBus. Check your installation." erhalten.}}

== Entwicklungs Aufgaben ==
=== KDevelop ===

Dieser Abschnitt wird Ihnen erklären, wie sie KDevelop 3.4 benutzen um KDE 4 Anwendungen zu entwickeln. Wenn sie Fragen, Korrekturen oder Bedenken zu diesem Abschnitt haben, notieren Sie diese bitte auf der Diskussions-Seite.

==== Voraussetzungen ====

Sie benötigen hierfür mindestens KDevelop 3.4, das immernoch eine KDE 3 Anwendung ist. Versionen vor 3.4 haben unter anderem keine Qt 4 Unterstützung. Die KDE 4 Version von KDevelop ist für den produktiven Einsatz noch nicht geeignet. Sie erhalten KDevelop auf der [http://www.kdevelop.org/index.html?filename=3.4/download.html KDevelop Homepage]. Installieren Sie KDevelop wie alle anderen KDE 3 Anwendungen unter Ihrem normalen Benutzer und '''nicht''' mit Ihrem ''kde-devel'' Benutzer.

Sie benötigen ausserdem die neueste ''GDB'' Version. Die aktuelle ist 6.6.0.

Weiterhin müssen Sie die kdelibs API Dokumentation lokal vorliegend haben, was unter [[Getting_Started/Build/KDE4#Generating_local_API_documentation|Anleitung zum Erstellen]] beschrieben wird.

Ausserdem benötigen Sie noch ''ctags'', ''htdig'', ''htmerge'' und ''htsearch''. ''valgrind'' und ''callgrind'' könnten auch nützlich sein.

Stellen Sie sicher, das sie den Schritten unter KDE 4 [[Getting_Started/Build/KDE4|Anleitung zum Erstellen]] befolgt und eine funktionierende KDE 4 Umgebung erstellt haben. Prüfen Sie, ob sich einfache KDE 4 Anwendungen wie ''Konsole'' oder ''KWrite'' von der Kommandozeile des kde-devel Benutzers ohne Probleme starten lassen.

Die folgenden Schritte werden alle mit dem '''kde-devel''' Benutzer ausgeführt. Sie müssen sich mit <code bash>su - kde-devel</code> unter diesem Benutzer anmelden.

==== Die Umgebung aufsetzen ====

KDevelop hat keine native Unterstützung für CMake Projekte. Glücklicherweise hat CMake die Fähigkeit selbst KDevelop Projekt Dateien zu erstellen. Um dies zu erreichen, müssen Sie CMake den Parameter ''-GKDevelop3'' übergeben. Dies bewegt CMake dazu, Projektdateien für KDevelop neben den normalen Makefiles zu erstellen. Der beste Weg dazu ist es, die '''cmakekde ''' Funktion in Ihrer [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|{{path|.bashrc}}]] anzupassen. Ändern Sie einfach
<code bash>
cmake $srcFolder -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull&& \
make && \
make install;
</code>
in
<code bash>
cmake $srcFolder -GKDevelop3 -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull&& \
make && \
make install;
</code>

Nachdem Sie das getan haben, melden Sie sich erneut an, damit sich die Veränderungen an der {{path|.bashrc}} Datei auswirken. Dann müssen Sie ''cmakekde'' erneut im (Wurzel) build Verzeichnis des Projekts an dem Sie mit KDevelop arbeiten wollen (wenn sie vorher nicht ''-GKDevelop3'' im [[Getting_Started/Build/KDE4#Setting_up_the_environment|Erstellungsschritt]] ausgeführt haben). Wenn Sie zum Beispiel an Konsole, welches in ''kdebase'' liegt, arbeiten möchten, müssen Sie cmakekde im {{path|$KDE_BUILD/KDE/kdebase}} Verzeichnis ausführen. Dies erstellt unglücklicherweise alles erneut, aber nur einmal wenn Sie den Generator ändern.

Da alle Umgebungsvariablen des kde-devel Benutzers KDE 4 spezifisch sind, müssen diese zurückgesetzt werden, um der KDE 3 Umgebung zu entsprechen bevor KDevelop gestartet wird. Am einfachsten wird dies erreicht, indem Sie folgende Funktion zu Ihrer {{path|.bashrc}} hinzufügen:

<code bash>
function start3app {
mkdir -p /tmp/$USER-kde
export PATH=/opt/kde3/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/bin/X11:/usr/games
export LD_LIBRARY_PATH=
export KDETMP=/tmp/$USER-kde
export KDEVARTMP=/var/tmp/$USER-kde
export KDEHOME=$HOME/.kde
export KDEDIR=/usr
export KDEDIRS=$KDEDIR
export DISPLAY=:0
eval "$@"
source $HOME/.bashrc #Reset environment variables again
}
</code>

Die ''PATH'' und ''LD_LIBRARY_PATH'' Variable werden vom KDE 3 Benutzer übernommen, und sie könnten auf Ihrem System abweichen, Geben Sie <code bash>echo $PATH</code> und <code bash>echo $LD_LIBRARY_PATH</code> als normaler KDE 3 Benutzer ein, um diese Werte zu erhalten. Die obigen Funktion nimmt an, das KDE 3 im {{path|/usr}} Verzeichnis installiert ist, wie es unter Debian-Systemen der Fall ist. Falls Ihr KDE 3 in einem anderen Verzeichnis installiert ist, müssen Sie die Zeile die ''KDEDIR'' setzt entsprechend anpassen. Hier ist ein Beispiel, wie sie herausfinden unter welchem Verzeichnis KDE installiert ist; in diesem Beispiel ist es /opt/kde3:

<code bash>
kde-config --prefix
/opt/kde3
</code>

Jetzt sollten Sie KDevelop starten können, indem Sie <tt>start3app kdevelop</tt> eingeben. Machen sie dies jetzt.

{{tip|
Sie können jede KDE 3 Anwendung mit der <tt>start3app</tt> Funktion starten. Nützlich ist das zum Beispiele für ''Kompare'' und ''kdesvn''.

Sie können jedoch auf diesem Weg nicht ''KDbg'' starten umd KDE 4 Anwendungen zu debuggen, da sonst die die Umgebungsvariablen für die debuggte Anwendung falsch sind.
}}


===== TroubleShooting =====

'''Symptom:''' kdevelop meldet "cannot talk to klauncher". Sie können keine Datei öffnen.

'''Lösung:''' fügen Sie Ihren KDE Bibliotheks-Pfad zum LD_LIBRARY_PATH hinzu, e.g.:
export LD_LIBRARY_PATH=/opt/kde3/lib

==== Einrichten von KDevelop ====

Jetzt, da KDevelop gestartet ist, müssen Sie einige Einstellung vornehmen.
Gehen Sie dafür nach ''Einstellungen->KDevelop einrichten...->Dokumentation''. Entfernen Sie alle Einträge die für KDE 4 nicht relevant sind.

{{note| Obwohl Umgebungsvariablen wie $HOME in diesem Abschnitt verwendet werden, sollten Sie diese mit echten Pfaden ersetzen, da KDevelop keine Umgebungsvariablen auflöst.}

Optional können Sie die kdelibs API Dokumentation hinzufügen. Sie müssen sie [[Getting_Started/Build/KDE4#Generating_local_API_documentation|zuvor erstellen]]. Dann fügen sie die Dokumentation durch Klick auf ''Hinzufügen...'' hinzu. In diesem Dialog verwenden Sie folgende Einstellungen:
* ''Typ'': Doxygen Documentation Collection (muss zuerst eingestellt werden)
* ''Ort'': {{path|$KDE_SRC/KDE/kdelibs/kdelibs-apidocs/index.html}}

Fügen Sie nun die Qt API Dokumentation hinzu, indem Sie folgende Einstellungen verwenden:
* ''Typ'': Qt Documentation Collection (muss zuerst eingestellt werden)
* ''Ort'': {{path|$HOME/qt-copy/doc/html/qt.dcf}}

Nachdem Sie die Dokumentation für kdelibs und die Qt API hinzugefügt haben, stellen sie sicher das alle Checkboxen (''TOC'',''Index'' und ''Suche'') aktiviert sind. Dann gehen Sie auf den Tab ''Volltextsuche'' und stellen sicherm das die Pfade zu den Programmen ''htdig'', ''htmerge'' und ''htsearch'' korrekt sind. Sie können den Einstellungs-Dialog nun schliessen.

Jetzt ist es an der Zeit das Projekt an dem Sie arbeiten möchten zu öffen indem sie auf ''Projekt->Projekt öffnen'' klicken. Die Projektdateien befinden sich im build-Verzeichnis. Für Konsole müssen Sie zum Beispiel die Datei {{path|$KDE_BUILD/KDE/kdebase/apps/konsole/konsole.kdevelop}} öffnen. Sie müssen nun einige Projektspezifische Einstellungen unter ''Projekt->Projekt Optionen'' vornehmen. Sie müssen das für jedes Projekt machen, an dem Sie arbeiten möchten.

{{note|
Manchmal ist keine KDevelop Projektdatei für das Verzeichnis in dem Sie arbeiten möchten verfügbar.

Dies kann verschieden Gründe haben, es hängt davon ab wie die CMake-Dateien geschrieben wurden. Für gewöhnlich sollten CMake-Dateien, die eine <tt>project(projectname)</tt> Anweisung enthalten gut funktionieren. Wenn Sie mit CMake vertraut genug sind, können Sie versuchen, diese Anweisung hinzuzufügen.

Ein Workaround dafür ist es, einfach die KDevelop Projektdatei eines darüberliegenden Ordners zu verwenden. In diesem Fall müssen Sie den <tt>Make Active Directory</tt> Eintrag im Kontextmenu des <tt>File Selectors</tt> in der Sidebar benutzen. Damit können Sie die anderen, unerwünschten Verzeichnisse beim erstellen und installieren ignorieren.
}}

* ''C++ Unterstützung->Codevervollständigung''
:Hier müssen Sie die Vervollständigungs-Datenbanken für Qt und kdelibs hinzufügen und natürlich noch mehr wenn Sie mögen. Zum Beispiel könnten Sie eine Datenbank für ''kdepimlibs'' benötigen wenn sie an ''kdepim'' arbeiten.

:Für kdelibs klicken Sie den ''Hinzufügen...'' Button und wählen ''KDevelop Custom Directory PCS Importer'', dann fügen Sie Ihr KDE include Verzeichnis ({{path|$HOME/kde/include}}) zur Liste hinzu und fahren fort. Sie können den Dateiauswahldialog und den ''Hinzufügen...'' Button benutzen um es hinzuzufügen.

:Jetzt fügen Sie die Datenbank für Qt 4 hinzu indem Sie ''KDevelop Qt4 PCS Importer'' auswählen. Sie müssen das Qt 4 include-Verzeichnis welches Sie unter {{path|$HOME/qt-copy/include}} finden hinzufügen.

{{note|Der Qt4 PCS Importer wird nur benötigt wenn Qt4 nicht installiert wurde, sie es also zum Beispiel direkt aus dem build-Verzeichnis heraus nutzen. Der Nachteil ber der Benutzung des Qt4 Importers ist das er während des Imports keinen Fortschritt anzeigt und die Applikation zu hängen scheint. Die Alternative ist es den Custom Directory PCS Importer dafür zu benutzen}}

* ''C++ Unterstützung->Qt Optionen''
:Aktivieren Sie ''Qt Options aktivieren'' und wählen Sie Qt4 als Ihre Version. Setzen Sie den ''QMake Binary'' Pfad auf {{path|$HOME/qt-copy/bin/qmake}}. Dann wählen Sie ''Qt 4 style'' als ''Qt include syntax''. Benutzen Sie {{path|$HOME/qt-copy/bin/designer}} für ''Designer Binary''. Benutzen Sie den ''Pluginpfade ändern'' Dialog um das Plugin-Verzeichnis von KDE hinzufügen und so die KDE widgets im Designer zu sehen. Um das zu erreichen fügen Sie {{path|$HOME/kde/lib/kde4/plugins}} in das Textfeld ein und klicken den ''Hinzufügen''-Button.

* ''Ausführungs Optionen''
:Stellen Sie sicher das für ''Executable'' der korrekte Wert eingestellt ist. Wenn Sie zum Beispiel Konsole ausführen wollen, geben Sie {{path|$KDE_BUILD/KDE/kdebase/apps/konsole/src/konsole}} an. Sie sollten ''--nofork'' zu den ''Debug Parametern'' hinzufügen oder das Debuggen von einigen Anwendungen wie ''KMail'' wird fehlschlagen.

:Da die ''start3app'' Funktion einige Umgebungsvariablen anpasst, müssen Sie diese hier zurücksetzen damit KDE 4 Anwendungen problemlos aus KDevelop heraus ausgeführt werden können.
:Für einige Anwendungen, wie Konsole, ist dies nicht unbedingt nötig aber andere wie KMail werden abstürzen wenn Sie die Variablen nicht anpassen.
:Klicken Sie einfach auf den ''Hinzufügen / Kopieren'' Button um neue Umgebungsvariablen hinzuzufügen. Sie werden die folgenden brauchen, die die selben wie in Ihrer [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|{{path|.bashrc}}]] sind:

:{| border="1"
|-
! Name
! Value
|-
| KDEHOME
| $HOME/.kde4
|-
| PATH
| $KDEDIR/bin:$QTDIR/bin:/usr/local/bin:$PATH
|-
| LD_LIBRARY_PATH
| $KDEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH
|-
| KDETMP
| /tmp/$USER-kde4
|-
| KDEVARTMP
| /var/tmp/$USER-kde4
|-
| KDEDIR
| $HOME/kde
|-
| KDEDIRS
| $KDEDIR
|-
| LD_BIND_NOW
| 42
|}

* ''Erstellungs Optionen->Erstellung''
:Stellen Sie sicher das hier das korrekte build-Verzeichnis eingetragen ist. Für Konsole ist es wiederum dieses: {{path|$KDE_BUILD/KDE/kdebase/apps/konsole}}.

* ''Erstellungs Optionen->Make''
:Sie sollten ''Abruch bei erstem Fehler'' aktivieren. Ausserdem sollten Sie ''VERBOSE='' oder ''VERBOSE=1'' zu ''Weitere Make Optionen'' hinzufügen um Aussagekraft des Erstellungsprozesses zu steuern.

:Wenn Sie mehr als einen Prozessor haben oder Sie Zugriff auf einen icecream cluster besitzen, sollten Sie die Option ''Mehrere Jobs ausführen'' aktivieren u nd die ''Anzahl der gleichzeitigen Prozesse'' auf die Anzahl der verfügbaren Prozessoren einstellen. Dies erhöht die Kompilierungsgeschwindigkeit. Es ist dsa gleiche wie die <tt>-j</tt> Option für ''Make''.

* ''Formatierung''
:Sie sollten alle Optionen hier so setzen, das sie zu dem Coding-Stil des Projekts an dem Sie arbeiten passen.

* ''CTags->Allgemein''
:Sie müssen den ''Pfad zur CTag Binary'' korrekt setzen, die sich in Debian unter {{path|/usr/bin/ctags}} befindet.

:Am besten aktivieren Sie noch die Option <tt>Bei mehr als einem Treffer, direkt zum Ersten gehen</tt>.

Jetzt sind Sie damit fertig Ihre Projekt-spezifischen Einstellungen zu konfigurieren. Sie sollten nun unter ''Einstellungen->Plugins konfigurieren...'' einige Plugins entfernen, die Sie nicht benötigen. Ich deaktiviere beispielsweise folgende Plugins:

Abbreviation Expansion, Code Snippets, Doxygen Support, Embedded Konsole, File Tree, '''Final Packaging Support''', "Open with" Menu Addon, QuickOpen, Regular Expression Tester, Scripting, '''Security Checker''', Shell Filtering and Insertion, Text Structure and Tools Menu Addition.

Sie sollten zumindest die Fettgedruckten entfernen.

Jetzt öffnen Sie, falls noch nicht geschehen, irgendeine Quelldatei. Dies aktiviert den Menueintrag ''Einstellungen->Editor konfigurieren...'', wo Sie die Tabulatoroptionen so einstellen müssen wie Sie im Projekt an dem Sie arbeiten benutzt werden. Die wichtigsten Einstellungen sind:
* ''Erscheinungsbild->Rahmen->Zeilennummern anzeigen'': Sollte aktiviert sein.
* ''Erscheinungsbild->Rahmen->Symbolränder anzeigen'': Sollte aktiviert sein.
* ''Bearbeiten->Tabulatoren''
* ''Bearbeiten->Statischer Zeilenumbruch->Markierung anzeigen'': Sollte aktiviert sein
* ''Einrückung->Automatische Einrückung->Einrückungs-Modus'': Sollte ''C Style'' sein
* ''Einrückung'' insgesamt

Im Hauptfenster klicken Sie auf den Tab ''CTags'' in der unteren Tableiset, dann klicken Sie auf ''Neu erstellen'' um eine CTags-Datenbank zur einfacheren Navigation im Quellcode zu erstellen.

Jetzt haben Sie alle wesentlichen Einstellunge vorgenommen, Gratulation!

==== KDevelop benutzen ====

Wenden Sie sich an das [http://docs.kde.org/development/en/kdevelop/kdevelop/ KDevelop Handbuch (englisch)] um generell Hilfe zu Ihrer Arbeit mit KDevelop zu erhalten. Der folgende Abschnitt wird nur Spezialfälle im Bezug auf KDE 4 enthalten.

===== Debugging =====

KDE Anwendungen haben viele Symbole, was bedeutet, dass sie viel Speicher benötigen um eine angemessene Ladezeit beim Debuggen zu erreichen. Um einen GDB Entwickler zu zitieren: "
KDE apps have many symbols, which means that you need a lot of memory to get a decent loading times for debugging. To quote a GDB developer: "Ich würde mich weigern KDE auf etwas mit unter 1 GB RAM zu debuggen."
Wenn die Schrittfunktion des Debuggers zu langsam für Sie ist, versuchen Sie folgende Tips:
* Lokale Variablen verstecken. Der <tt>Lokal</tt> Teil im linken Variablen Tab verursacht einen erheblichen Geschwindigkeitsrückgang bei der Schrittweisen Ausführung wenn Sie viele lokale Variablen haben. Klappen sie einfach den <tt>Lokal</tt> Teil des Baums zu, die lokalen Variablen werden nun nicht bei jedem Schritt aktualisiert. Sie können immernoch die Variablen untersuchen indem sie die <tt>Ausdruck evaluieren</tt> Funktion benutzen.
* Benutzen Sie den Patch unter http://bugs.kde.org/show_bug.cgi?id=143977. Es verhindert die Aktualisierung des Framestack-Widgets bei jedem Schritt und beschleunigt damit die Schrittweise Ausführung erheblich. Der Patch führt zu einigen kleineren Ungereimtheiten weshalb er bisher noch nicht commited wurde.

{{Note|
KDevelop unterstützt bisher keine Änderungen am CMake build System. Das bedeutet, das Sie KDevelop nicht dazu benutzen können, Dateien zum Projekt hinzuzufügen oder zu entfernen oder irgend einen anderen Aspekt des Buildprozesses Ihres Projekts zu modifizieren.

Sie müssen stattdessen die CMake Dateien per Hand anpassen und dann erneut <tt>cmakekde</tt> ausführen. Lesen Sie das [[Development/Tutorials/CMake|CMake Tutorial]] um zu lernen wie man das macht.
}}

{{tip|Wenn Sie an Bibliotheken arbeiten, müssen Sie diese zuerst installieren bevor Sie Ihre Änderungen an diesen testen oder debuggen können.
Da this lästig und zeitverschlingend ist, sollten Sie für alle betreffenden Bibliotheken Symlinks erstellen ''(ln -s)'', die aus dem Build-Verzeichnis auf das Installations-Verzeichnis verweisen.

Oft benutzen selbst einfache Programme interne Bibliotheken, zum Beispiel ist der Einstellungsdialog von Konsole in Wirklichkeit eine Bibliothek,}}

[[Category:KDE4]]