KDE TechBase - User contributions [en]

Talk:Schedules/KDE4/4.0 Release Beta Goals

2007-09-28T14:55:59Z

Liquidat: New page: == Kopete? == What is with Kopete? Shouldn't KDE be released together with an instant messenger? Will it work or won't it? --~~~~

== Kopete? ==
What is with Kopete? Shouldn't KDE be released together with an instant messenger? Will it work or won't it? --[[User:Liquidat|Liquidat]] 16:55, 28 September 2007 (CEST)

Schedules/KDE4/4.0 Announcements/KDE4/4.0 Beta3

2007-09-10T12:16:08Z

Liquidat:

List of nice and important changes between beta2 and beta3 so they can be put in the announcement article. Put links in here!!!

* work on KNotes [http://blog.guillermoamaral.com/2007/09/04/knotes-sur-un-triangle/]

work-in-progress:

* About Kommander
<a href="http://code.google.com/soc/2007/kde/appinfo.html?csaid=93F720A476DF8E71">Matthias Wieser integrated</a> the cool <a href="http://dot.kde.org/1087424515/">Kommander tool</a>, which enables even very unskilled developers to quickly build GUI applications.

(they didn't make it, too much work. might become something later on?)

* About MARBLE (SoC work)
much work, not the least on <a href="http://edu.kde.org/marble/">Marble</a>. It alone had three Summer of Code projects, with <a href="http://realate.blogspot.com/">Andrew Manson</a> working on <a href="http://code.google.com/soc/2007/kde/appinfo.html?csaid=58AE7448FBEEEAE0">GPS support</a>, <a href="http://carloslicea.blogspot.com/">Carlos Licea</a> on <a href="http://code.google.com/soc/2007/kde/appinfo.html?csaid=DCE4DBD4A0509DC7">2D projection</a> and <a href="http://cia.vc/stats/author/muradt/">Murad Tagirov</a> busy with <a href="http://code.google.com/soc/2007/kde/appinfo.html?csaid=D67FADC741D4F4C4">KML support</a>.
(beta 3 stuff)

* KVocTrain (from KDE-Edu) is renamed to Parley ( Parley is a discussion or conference, especially one between enemies over terms of truce or other matters).

* kget was integrated with Plasma:
http://liquidat.wordpress.com/2007/09/04/kde-4-screencast-plasma-and-kget-interaction/

Todo:
- ask KDE-pim ppl about progress!!!
- get plasma screencast?!?

Getting Started/Build/KDE4 (de)

2007-07-11T21:34:03Z

Liquidat: strigi, soprano raus, kdesupport rein

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Vorbereitungen|

name=KDE4 aus dem Quellcode bauen|

pre=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]|

next=[[../../Set_up_KDE_4_for_development|Set up KDE 4 for development]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: The KDE From Subversion Build Tool] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]] [[../KDE4/FreeBSD|FreeBSD notes]] [[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Übersicht ==

Diese Anleitung zeigt einen Weg, KDE auf Linux- und BSD-Systemen
zu komplieren und auszuführen. Als Grundlage verwenden wir die Shell.
Wenn Sie sich für die Installation auf anderen Systeme wie etwa Solaris, MacOS oder Microsoft Windows interessieren, besuchen Sie bitte [[../|Build]] und folgen Sie den Links am Ende der Seite.

{{warning|Stellen Sie sich auf verstärkt auftretende Buildprobleme '''an Montagen''' ein, da die Entwickler an diesem Wochentag kritische Änderungen vornehmen. Das [http://developer.kde.org/~dirk/dashboard/ Dashboard] zeigt unerwartete Probleme beim Kompilieren an.
}}

== Benötigte Software ==

Folgendes muss installiert sein, um dieses Tutorial erfolgreich durchführen zu können:
* gcc und g++ vom gcc Projekt, vorzugsweise Version 4.1 oder höher
* svn, der subversion revision control client
* pkg-config
* devel-(Entwicklungs-)Bibliotheken und -header für X11, OpenGL (mesa-common-dev und libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 und libxslt
* Das <tt>makeobj</tt> Skript, welches Teil von kdesdk ist. Sie können es als Teil von kdesdk (kdesdk-scripts in Debian) installieren oder von hier einzeln herunterladen: [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* das [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info Paket], welches der freedesktop-MIME-Standard ist, den KDE nun nutzt
* [http://boost.org/ boost], welches von kdebase gebraucht wird. Nach dem Kompilieren und/oder Installieren von boost fügen Sie das boost-Verzeichnis (das, welches das include-Unterverzeichnis enthält) zu CMAKE_INCLUDE_PATH hinzu, oder kreieren Sie eine Umgebungsvariable namens BOOST_ROOT, die zum boost-Verzeichnis verweist, um cmake den Ort von boost mitzuteilen (FindBoost).

Weiterhin ist es zu empfehlen, folgende Software bereits installiert zu haben:
* bash

=== Kubuntu ===

In Kubuntu 7.04 (Feisty) kann alle zum Bau der Pakete benötigte Software mit folgendem Befehl installiert werden:
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake libungif4-dev \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng-dev libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen
</code>

Die manuelle Installation von Qt 4.3, CMake 2.4.6 und DBus kann durch die Installation der folgenden Pakete und ihrer Abhängigkeiten vermieden werden:
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

{{warning|Alle KDE-Releases nach Alpha1 funktionieren nur mit Qt4.3. Kubuntu hat aber nur Packete für QT 4.3-Beta. Um neuere Versionen zu kompilieren, ist das offizielle Release nötig.
}}

Für eine voll funktionstüchtige [[apidox]]-Umgebung wird ebenfalls zusätzliche Software benötigt:
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===
{{note|
Der openSUSE build service stellt ebenfalls tagesaktuelle KDE-4-Pakete bereit, die das gesamte auf dieser Seite beschriebene Vorgehen überflüssig machen. Weitere Informationen findet man direkt im openSUSE wiki unter [http://de.opensuse.org/KDE4 KDE4].
}}

In OpenSuse können Pakete mit Hilfe von [http://de.opensuse.org/Zypper Zypper] installiert werden:
<code bash>
sudo zypper install <package-name>
</code>

In älteren SUSE-Versionen geht dies nur mit Yast:
<code bash>
yast2 -i <packagename>
</code>

Die meisten zum Bau von KDE 4 nötigen Pakete sind:
<code bash>
xorg-x11-devel, libxml2-devel, kdesdk3, clucene-core-devel, libjpeg-devel, liblrdf-devel, libpng-devel, libxslt-devel, Mesa-devel, giflib-devel, subversion, gcc, gcc-c++
</code>

Bereits vorkompilierte CMake-Pakete für openSUSE sind direkt verfügbar im [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

Sie können die stabilen ebuilds verwenden. Vergessen Sie nur nicht, ihr Portage zu synchronisieren, bevor Sie fortfahren.

Von folgenden Paketen müssen instabile Versionen verwendet werden. Um das zu erreichen, nehmen Sie die Paketnamen in die Datei <code>package.keywords</code> auf.

<code bash>
# echo 'x11-libs/qt' >> /etc/portage/package.keywords
# echo 'dev-util/cmake' >> /etc/portage/package.keywords
# echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
# echo '>dev-cpp/clucene-0.9.16a' >> /etc/portage/package.mask
</code>

Dies sind die zu installierenden Pakete. Einige könnten bereits installiert sein. Diese können übersprungen werden, indem das "update"-flag in emerge gesetzt wird.

<code bash>
$ emerge -avu ebuild/name
</code>

sys-devel/gcc
dev-util/subversion
dev-util/pkgconfig
x11-base/xorg-x11
media-libs/glut
media-libs/mesa
media-libs/jpeg
media-libs/libpng
media-libs/giflib
dev-cpp/clucene
dev-util/cppunit
media-libs/liblrdf
dev-libs/libxml2
dev-libs/libxslt
x11-misc/shared-mime-info
dev-libs/boost
x11-libs/qt
dev-util/cmake
sys-apps/dbus
redland

Beginnen Sie nun, [[Getting_Started/Build/KDE4#Strigi|Strigi]] zu kompilieren.

Viel Erfolg!

== Ein Benutzer für die KDE-4-Entwicklung ==

{{Note|
Einige Menschen ziehen es vor, für KDE 4 einen separaten Nutzer-Account einzurichten, um nicht aus Versehen durch noch bestehende Bugs oder ähnliches Daten zu verlieren. Die Anleitung hier basiert auf der Herangehensweise.

Es ist jedoch deutlich effizienter alles mit einem einzigen Nutzer-Account zu machen. Unter [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] findet man mehr Details dazu.

In diesem Fall ist die folgende Anleitung noch immer gültig, jedoch sollten die nötigen Umgebungsvariablen nicht in die <tt>.bashrc</tt>, sondern in eine separate Datei geschrieben werden, die dann bei Bedarf eingelesen wird.
}}

=== Option 1: Kommandozeile ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2: Über KControl ===

Anstatt der oben genannten Befehle kann man auch mit Hilfe des Benutzer-Moduls im KDE-Kontrollzentrum (kcontrol) einen weiteren Benutzer einrichten.

=== Einrichten der Entwicklungsumgebung ===

Kopieren Sie die Datei {{path|~/.bashrc}} von Ihrem normalen Benutzer-Account zu Ihrem neuen kde-devel-Account. Danach fügen Sie den Inhalt der Seite [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|example .bashrc]] in die Datei {{path|~kde-devel/.bashrc}} ein. Stellen Sie sicher, dass die Zeile <tt>alias make=makeobj</tt> auskommentiert ist falls auf Ihrem System das Programm <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt> nicht verfügbar ist.
Die neue {{path|~/.bashrc}} wird mit folgendem Befehl eingelesen:
<code bash>
source ~/.bashrc
</code>

Nun haben Sie Zugriff auf Befehle wie <tt>cmakekde</tt>, die in dieser Anleitung genutzt werden. Auch wird so sichergestellt, dass alle wichtigen Umgebungsvariablen (z. B. für die Pfadangaben von Qt, KDE und CMake) richtig gesetzt sind.

Für weitere Informationen lesen Sie bitte [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Zum neuen Benutzer wechseln ===

Sie können sich nun als Benutzer kde-devel anmelden (der Bindestrich ist wichtig!):
<code bash>
su - kde-devel
</code>

Der Rest dieser Anleitung geht davon aus, dass Sie alle Befehle als <tt>kde-devel</tt> ausführen.

== Die Shell des Entwicklungsbenutzers ==
Auf manchen Systemen nutzen neue Benutzer standardmäßig {{path|/bin/sh}}. Wenn dies auf Ihrem System nicht der Fall ist, können Sie diesen Abschnitt überspringen. {{path|/bin/sh}} zu nuzten kann sich als sehr unangenehm erweisen. Daher sollten Sie erwägen, zu {{path|/bin/bash}} oder einer anderen Shell zu wechseln.

=== Option 1: Als kde-devel-Benutzer ===
Wenn Sie keine root-Privilegien haben und Ihr System das Wechseln der eigenen Shell mittels <tt>chsh</tt> unterstützt, können Sie versuchen, Ihre Shell zu {{path|/bin/bash}} zu wechseln, indem Sie Folgendes eingeben:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2: Als root-Benutzer ===
Wenn Ihr System die Anwendung <tt>usermod</tt> beinhaltet, können Sie den folgenden Befehl als root-Benuzter eingeben: <tt>usermod -s /bin/bash</tt>.

Eine weitere Möglichkeit ist die Nutzung der Anwendung <tt>vipw</tt> als root-Benuzter, um auf sichere Art {{path|/etc/passwd}} zu editieren. Machen Sie 'kde-devel' in dieser Datei ausfindig und ändern Sie '{{path|/bin/sh}}' am Zeilenende in '{{path|/bin/bash}}'. Speichern Sie die Änderungen und beenden Sie die Anwendung.

Die neue Shell wird automatisch gestartet wenn Sie sich wieder als kde-devel-Benutzer einloggen.

== D-Bus ==
QtDBus und KDE arbeiten mit den D-Bus-Versionen 0.6.2, 0.92 und höher zusammen. Die Versionen 0.60 und 0.61 funktionieren eventuell auch, sind aber ungetestet. Die Versionen 0.90 und 0.91 funktionieren definitiv nicht.

Wir empfehlen, dass Sie eine aktuelle, stabile Version, also größer Version 1.0, benutzen, wenigstens aber Version 0.94.

Wenn Sie eine aktuelle D-Bus-Version auf ihrem System bereits installiert haben oder Ihre D-Bus-Version nicht aktualisieren wollen, können Sie die nächste Sektion überspringen.

Bevor Sie die nächsten Schritte durchgehen sollten Sie sicherstellen, dass die X11-header und -Bibliotheken installiert sind. Das Konfigurationsskript sollte in Zeile 5 Folgendes ausgeben:
Building X11 code: yes

=== Das Kochrezept ===

{{tip|Stellen Sie sicher, dass Ihre Umgebung [[Getting_Started/Build/KDE4 (de)#Einrichten der Entwicklungsumgebung|wie beschrieben]] eingerichtet wurde. Das ist wichtig für das Funktionieren der <tt>cs</tt>- und <tt>cb</tt>-Befehle.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' ist eine Bash-Funktion, klicken Sie hier, um mehr darüber zu lernen]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=$KDEDIR/var
make
make install
dbus-uuidgen --ensure

=== Was hier passiert ===
Wir wechseln in Zeile 1 in das Quellen-Verzeichnis, laden in Zeile 2 den Quellcode von freedesktop.org herunter und entpacken diesen in Zeile 3.
In Zeile 4 wechseln wir in das neu erstellte Verzeichnis, und bereiten in Zeile 5 das Kompilieren der Quelldateien vor. Zeile 6 setzt den Kompilier-Vorgang in Gang, Zeile 7 installiert D-Bus, und in Zeile 8 benutzen wir das <tt>dbus-uuidgen</tt>-Werkzeug, um eine Maschinen-Identifikation zu installieren. Das erlaubt dem bus, automatisch mit der Desktop-Sitzung zu starten.

Achten Sie darauf, dass Sie Schreibrechte auf {{path|/var}} haben, da Sie sie für die letzten beiden Schritte benötigen. Falls Ihr System kein sudo-Kommando unterstützt, können Sie auch <tt>su</tt> benutzen, z. B. <tt>su -c "make install"</tt>.

=== Fehlerbehebung ===

Falls Sie die Fehlermeldung '''makeobj: command not found''' bekommen fehlt Ihnen <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Überspringen Sie diesen Abschnitt, wenn Sie [http://cmake.org/ CMake] >=2.4.5 installiert haben.
Es sollte Ihnen möglich sein, die Binärpakete zu installieren, die hier verfügbar sind: [http://www.cmake.org/HTML/Download.html CMake site]. Dort sind ebenfalls distributionsspezifische Pakete zu finden.

=== Das Kochrezept ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' ist eine Bash-Funktion, klicken Sie hier, um mehr zu erfahren]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== Was hier passiert ===
Zuerst wechseln wir in das Quellverzeichnis des <tt>kde-devel</tt>-Benutzers (Zeile 1), laden den CMake-Quellcode herunter (Zeile 2) und entpacken ihn (Zeile 3). Dann erstellen wir ein Verzeichnis, in dem wir CMake kompilieren (Zeile 4) und wechseln in dieses (Zeile 5). Hier führen wir das CMake-bootstrap-Skript aus (Zeile 6), dann den make-Befehl (Zeile 7) und schließlich die Installation als root-Benuzter (Zeile 8).

Wenn Ihr System den <tt>sudo</tt>-Befehl nicht beinhaltet, können Sie stattdessen Folgendes eingeben: <tt>su -c "make install"</tt>.

== Qt ==
Als nächstes wird Qt 4 benötigt; es befindet sich im KDE-Quell-Repository. KDE kompiliert garantiert gegen jedes Qt der Version 4.3. Qt 4.2 und früher sind nicht unterstützt und funktionieren nicht. Da Qt 4.3 erst kürzlich veröffentlicht worden ist, finden sich wahrscheinlich noch keine Pakete für Ihre Distribution (bekannte Ausnahmen sind Kubuntu und openSUSE). Sie sollten die Kopie auf den KDE-Subversion-Servern verwenden.

=== Das Kochrezept ===
cd
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -qdbus -pch -nomake examples \
-nomake demos
make -j2
# make install: Nur wenn QTDIR nicht das momentane Verzeichnis ist!
make install

=== Was hier passiert ===
Wir wechseln in das Heimverzeichnis des <tt>kde-devel</tt>-Benutzers (Zeile 1) und laden den Quellcode mittels Subversion (svn) herunter (Zeile 2). Nach dem Wechsel in das daraus resultierende Verzeichnis {{path|qt-copy}} (Zeile 3), führen wir ein Skript aus, das die Patches integriert, die mit <tt>qt-copy</tt> kommen (Zeile 4).

Sobald die Patches integriert sind, konfigurieren wir das build mittels des <tt>configure</tt>-Skripts (Zeilen 5-7). Die verschiedenen Kommandozeilenoptionen werden in der Datei {{path|qt-copy/README.qt-copy}} erläutert. Schließlich kompilieren wir die Mininalanforderungen für KDE (Zeile 8) und installieren Qt (Zeilen 9-10). Wenn Sie alle Beispiel- und Demo-Applikationen installieren möchten, können Sie sie entweder einzeln kompilieren oder einfach den Befehl <tt>make</tt> im Verzeichnis {{path|qt-copy}} ausführen.

Beachten Sie, dass die Installation keine root-Rechte verlangt, da Qt lokal in {{path|$QTDIR}} installiert wird. Die Installation ist ohnehin nur nötig, wenn {{path|$QTDIR}} sich von {{path|$HOME/qt-copy}} unterscheidet, was nicht der Fall ist, wenn Sie die Anweisungen exakt befolgt haben.

=== Fehlerbehebung ===
Wenn Sie die Fehlerausgabe "error: X11/Xlib.h: No such file or directory" erhalten, installieren Sie das devel-Paket von <tt>xorg</tt> (der Name des Pakets kann in verschiedenen Distributionen abweichen, in (K)Ubuntu z. B. ist er <tt>xorg-dev</tt>).

Wenn Sie eine Fehlermeldung im configure-Schritt erhalten, die auf "missing defines" hinweist, prüfen Sie den Wert von <tt>$QMAKESPEC</tt>. Manche Distributionen lassen die Variable direkt auf das standardmäßig installierte Qt verweisen. Wenn der Befehl <tt>unset QMAKESPEC</tt> das Problem löst, sollten Sie überlegen, ihn zum <tt>~/.bashrc</tt>-Skript hinzuzufügen.

Wenn Sie die Fehlermeldung ".pch/debug-shared/QtCore" erhalten, bedeutet dies, dass Qt-4.3 zwar die vorkompilierten header aktiviert hat (wenn Ihr gcc dies unterstützt), es jedoch nicht funktioniert. Wenn Sie distcc nutzen, konfigurieren Sie Qt mit der Option -no-pch. Wenn Sie icecream nutzen, führen Sie ein Update zur neuesten Version von icecream im svn trunk durch.

Versuchen Sie, irgendeine Qt-Applikation zu starten, beispielsweise {{program|assistant}}. Wenn sie in QSpanData::adjustSpanMethods abstürzt, haben Sie ein Problem mit dem Oxygen style. Versuchen Sie, {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} und {{path|lib/kde4/plugins/styles/oxygen.so}} zu entfernen, wenn sie sich im KDE-Installationspräfix finden.

== kdesupport ==

{{warning|Wenn Sie diesen Abschnitt erreicht haben, ohne [[Getting_Started/Build/KDE4 (de)#Einrichten der Entwicklungsumgebung|Einrichten der Entwicklungsumgebung]] zu lesen, '''werden die hier angebotenen Rezepte nicht funktionieren'''. Diese Rezepte sind nicht defekt; <tt>cs</tt> und <tt>cb</tt> sind keine Tippfehler. Ihre Umgebung '''muss''' korrekt eingerichtet sein, damit diese Instruktionen funktionieren.}}

Es gibt eine Reihe von Bibliotheken in kdesupport, von denen andere Programme abhängen. Das umfasst Strigi und Soprano für die Datei-Metadaten und für die Suche, eigen für visuelle Effekte z.B. in Kalzium, taglib für Musik-Programme und qca für Kryptographie-Unterstützung.

Strigi selbst hat ebenfalls einige Abhängigkeiten: Sie benötigen die Bibliotheken von libz, libbz2, openssl (libcrypto oder libssl), libclucene (=0.9.16; Version 0.9.17 funktioniert '''nicht'''), und entweder libxml2 oder libexpat.

=== Das Kochrezept ===

cs # cs is kein Schreibfehler
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== Was hier passiert ===
Wir wechseln in das Quellverzeichnis (Zeile 1), laden den Quellcode von kdesupport mittels Subversion herunter (Zeile 2) und wechseln anschließend in das neue Verzeichnis {{path|~/src/kdesupport}} (Zeile 3). Dann starten wir die Kompilierung (Zeile 4). Wir finden uns im Anschluss an die Kompilierung im build-Verzeichnis von kdesupport wieder.

=== Troubleshooting ===
Wenn Sie folgende Fehlermeldung bekommen:
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
dann sollten Sie das Entwicklerpaket für libxml2 installieren (z.B. libxml2-devel oder ähnlich).

Wenn Sie
CMake Error: Could NOT find REDLAND
erhalten, benötigen Sie librdf aus den Redland-Bibliotheken.
Wenn Ihre Distribution das librdf-Paket nicht zur Verfügung stellt, können Sie dessen Quellcode hier herunterladen [http://download.librdf.org/source/ http://download.librdf.org/source/] und selbst kompilieren. In Gentoo heißt das Paket 'redland' anstatt librdf.

Wenn Sie
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
erhalten, werfen Sie einen Blick auf [http://techbase.kde.org/Getting_Started/Sources/Using_Subversion_with_KDE Using Subversion with KDE]

Bei der Fehlermeldung
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto
benötigen Sie zum Installieren des crypto-plugins Administrations-Rechte, vermutlich weil Sie die Systemweite Installation von qt4 verwenden. Am einfachsten ist es, Sie benutzen wie oben angegeben eine für den lokalen Nutzer erstellte.

== kdelibs ==
Nachdem wir Qt 4 und Strigi kompiliert haben, können wir nun mit dem Kompilieren der KDE-Basisbibliotheken fortschreiten. Wenn Sie die oben genannte Anleitung bezüglich [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] nutzen, kommen Ihnen diese neuen Funktionen im Folgenden gelegen.

=== Das Kochrezept ===


cd $KDE_SRC
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Was hier passiert ===
Wir wechseln in das KDE-Quellverzeichnis (Zeile 1), erstellen ein Verzeichnis names KDE und wechseln in dieses (Zeile 2). Dann laden wir den Quellcode der kdelibs mittels Subversion herunter (Zeile 3), wechseln in das neue Verzeichnis {{path|~/src/KDE/kdelibs}} (Zeile 4) und starten die Kompilierung (Zeile 5). Wir finden uns anschließend im <tt>kdelibs</tt>-build-Verzeichnis wieder.

{{tip|Es könnte einige fehlende Anhängigkeiten auf Ihrem System geben! Sie können in der Ausgabe von <tt>cmakekde</tt> leicht übersehen werden.
Sie können vor dem Kompilieren jeglicher KDE-Module (wie kdelibs, kdepimlibs usw.) <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> ausführen.}}

=== Zusätzliche KDE-typische CMake-Module ===
Es gibt weitere CMake-Module in {{path|kdelibs/cmake/modules/}}, die für die Kompilierung von KDE4-Applikationen nötig sind. Sie werden mit kdelibs installiert (siehe unten).

=== Fehlerbebung ===
Wenn Sie Schwierigkeiten bei der Kompilierung von kdelibs haben, stellen Sie sicher, dass Sie die Software im obigen Abschnitt [[Getting_Started/Build/KDE4#Required_Software|Required Software]] installiert haben und dass sie funktioniert. Andere mögliche Probleme sind:
* Wenn der Befehl <tt>cmakekde</tt> mit der Ausgabe fehlschlägt, dass CMake ein "out of source" build-Verzeichnis benötigt, entfernen Sie {{path|~/src/KDE/kdelibs/CMakeCache.txt}} und versuchen Sie es erneut.

Wenn <tt>cmakekde</tt> dennoch denselben Fehler ausgibt, versuchen Sie Folgendes:
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install
* Wenn Sie die Fehlerausgabe "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there." erhalten, müssen Sie in Ihr build-Verzechnis wechseln bevor Sie cmakekde ausführen. (z. B. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Wenn Qt nicht oder in einer falschen Version gefunden wird, stellen Sie sicher, dass das qmake der benötigten Qt-Version an erster Stelle (unter den qmake-Einträgen) im Pfad eingetragen ist.
* Wenn das Problem nach wie vor vorhanden ist, versuchen Sie die CMake make-Option <tt>--keep-going</tt>.
* Sie benötigen die libungif-Bibliothek, ansonsten erhalten Sie eine Fehlerausgabe ähnlich "<tt>Could NOT find GIF</tt>".
* Qt-4.3-Upgrade: Wenn Sie einen Verknüpfnugsfehler in kjsembed erhalten, der auf die QScriptEngine bezogen ist, editieren Sie CMakeCache.txt in kdelibs und entfernen Sie die Zeilen, die sich auf QT_QTUITOOLS_LIBRARY beziehen, und führen Sie den make-Befehl erneut aus (diese statische Bibliothek hat eine neue Abhängigkeit und der cmake-Code, der diese hinzufügt, benötigt sie, um ausgeführt zu werden).
* Wenn Sie die Fehlerausgabe <code>CMake Error: KDE Requires Qt to be built with SSL support</code> erhalten, installieren Sie openssl-devel, und rekompilieren Sie Qt.

== kdepimlibs ==
Sie müssen ''kdepimlibs'' nach <tt>kdelibs</tt>, aber vor ''kdebase'' installieren.

=== Das Kochrezept ===


cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs ist KEIN Tippfehler]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Was hier passiert ===
Wir wechseln in das KDE-Quellverzeichnis (Zeile 1), laden den Quellcode für kdepimlibs mittels Subversion herunter (Zeile 2) und wechseln anschließend in das neue Verzeichnis {{path|~/src/KDE/kdepimlibs}} (Zeile 3). Dann starten wir die Kompilierung (Zeile 4). Wir finden uns im Anschluss an die Kompilierung im build-Verzeichnis von <tt>kdepimlibs</tt> wieder.

== kdebase ==
Für manche kioslaves könnte kdebase benötigt werden.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs ist KEIN Tippfehler]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Fehlerbebung ===

Wenn Sie Schwierigkeiten beim Kompilieren von kdebase haben:
* Stellen Sie sicher, dass die <tt>libxss-Header</tt> installiert sind. (Sollten diese nicht installiert sein, erhalten Sie in der Regel undefinierte Verweise auf xscreensaver-Objekte.)
* <tt>which meinproc</tt> muss {{path|/home/kde-devel/kde/bin/meinproc}} ausgeben.
* Wenn cmakekde das kdepimlibs-Verzeichnis nicht finden kann, editieren Sie die Datei {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} und definieren Sie <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt> manuell.
* Wenn Sie die Fehlerausgabe "Please set the following variables: X11_XTest_LIB (ADVANCED)" erhalten, installieren Sie das devel-Paket von <tt>Xtst</tt>. Auf manchen Systemen ist es separat von <tt>xext</tt> gepackt und heißt <tt>x11proto-xext-dev</tt> oder <tt>libxtst-dev</tt>. Sie müssen eventuell außerdem nach der Installation dieses Paketes die Datei CMakeCache.txt im build Verzeichnis löschen.
* Dasselbe gilt für die analoge Fehlerausgabe betreffend der Variable "X11_Xinerama_LIB (ADVANCED)": Sie benötigen das devel-Paket für <tt>xinerama</tt>.
* Wenn Sie die Fehlerausgabe "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)" erhalten, müssen Sie die libfontconfig-Header installieren.
* Wenn Sie die Fehlerausgabe "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES" erhalten, müssen Sie soprano aus kdesupport installieren und dann kdelibs neu kompilieren.
* Wenn Sie die Fehlerausgabe "‘XserverRegion’ does not name a type" erhalten, stellen Sie sicher, dass Sie die libxcomposite header installiert haben. (In Ubuntu heißen diese <tt>libxcomposite-dev</tt>.)

== Lokale API-Dokumentation erstellen ==

Obwohl die API-Dokumentation für KDE online unter [http://api.kde.org api.kde.org] verfügbar ist, kann es hilfreich sein, sie offline verfügbar zu haben, zum Beispiel wenn Sie [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] zum Durchsuchen der Dokumentation nutzen oder wenn Sie nicht ständig online sein können.

Seien Sie sich bewusst, dass das Generieren der API-Dokumentation mehrere Stunden in Anspruch nehmen kann und knapp ein halbes Gigabyte an Speicherplatz benötigt.
Das Generieren wird von einem Skript in {{path|kdelibs/doc/api}} ausgeführt; Sie benötigen <tt>doxygen</tt>, um es ausführen zu können.

Um die API-Dokumentation für kdelibs zu generieren, geben Sie Folgendes ein:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs ist KEIN Tippfehler]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Wiederholen Sie dies nach Bedarf für andere Module.

== Allgemeine Fehlerbehebung ==

Es kann im Laufe der Zeit nach mehrmaligem Ausführen von <tt>svn up</tt> vorkommen, dass sich das Ausgabeformat einiger Werkzeuge, die in der KDE-Werkzeugkette benutzt werden, ändert. Zum Beispiel werden <tt>kcfg</tt> Dateien vom <tt>kconfig_compiler</tt> gelesen, um die Konfigurationsdialoge zu generieren. Da CMake diese Veränderungen nicht erkennt, kann das Kompilieren fehlschlagen. Eine provisorische Lösung ist, die Regenerierung all dieser Dateien zu erzwingen:
find $KDE_SRC/kde/kdebase -name "*.kcfg" | xargs touch
Dasselbe gilt für <tt>ui</tt> Dateien wie solche, die mit Qt Designer generiert werden.

== Das war's! ==

Sie sind nun bereit, andere svn-Module in derselben Weise wie kdebase zu kompilieren, KDE 4 zu benutzen und zu testen, sowie Ihre eigenen Patches und Anwendungen zu schreiben.

Siehe auch die Anleitung [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] um Hilfe beim Starten von KDE-4-Anwendungen sowie zur Benutzung von KDevelop zu erhalten.

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4

2007-06-13T21:14:06Z

Liquidat: /* Qt */ it is part of the usual updates for Fedora 7

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Getting Started|

name=Building KDE4 From Source|

pre=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]|

next=[[../../Set_up_KDE_4_for_development|Set up KDE 4 for development]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: The KDE From Subversion Build Tool] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]] [[../KDE4/FreeBSD|FreeBSD notes]] [[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Abstract ==

This tutorial shows one way to get KDE from trunk running on Linux/BSD systems. Throughout the tutorial the bash shell is used. If you are interested in building KDE on other systems such as Solaris, MacOS or Microsoft Windows, please visit the [[../|Build]] page and see the links at the bottom for the respective operating systems.

{{warning|Expect a higher risk of build failure '''on Mondays''' when critical changes are implemented. [http://developer.kde.org/~dirk/dashboard/ Dashboard] reports unexpected breakages. You are encouraged to fix failing modules.
}}

== Required Software ==

The following must be installed first before you can successfully complete this tutorial:
* gcc and g++ from the gcc project, preferably version 4.1 or higher
* svn, the subversion revision control client
* pkg-config
* development libraries and headers for X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 and libxslt
* the <tt>makeobj</tt> script, which is part of kdesdk. You can install it as part of kdesdk (kdesdk-scripts on Debian) or similar package, or just download it itself from [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* the [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info package], which is the freedesktop MIME standard KDE is using now
* [http://boost.org/ boost], needed by kdebase; after compiling and/or installing boost, in order to make cmake aware about its location (FindBoost), add boost directory (the one containing include subdirectory) to CMAKE_INCLUDE_PATH or set an environment variable called BOOST_ROOT pointing to boost directory.

You may also want to have the following installed:
* bash

=== Kubuntu ===

In Kubuntu 7.04 (Feisty) the build dependencies you need are installed with:
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake libungif4-dev \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng-dev subversion libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen
</code>

You can skip the manual installation of Qt 4.3, CMake 2.4.6 and DBus by installing the following packages (and their dependencies). '''Please Note:''' This will not work for Qt for KDE4 after Alpha 1:
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

And for fully functional [[apidox]] frame work you also need:
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

In openSUSE, you can install packages using [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <package-name>
</code>

In older releases of SUSE, you can use YaST:
<code bash>
yast2 -i <packagename>
</code>

The packages you will need are:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
redland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

CMake binary packages for openSUSE are available from [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

You can use most stable ebuilds just remember to sync your portage before you begin.

We need to be unmasked and/or kept at a lower version to continue.

<code bash>
# echo 'x11-libs/qt' >> /etc/portage/package.keywords
# echo 'dev-util/cmake' >> /etc/portage/package.keywords
# echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
# echo '>dev-cpp/clucene-0.9.16a' >> /etc/portage/package.mask
</code>

These are the packages you will need to install, some may already be installed so you may skip those by adding the update flag to emerge.

<code bash>
$ emerge -avu ebuild/name
</code>

sys-devel/gcc
dev-util/subversion
dev-util/pkgconfig
x11-base/xorg-x11
media-libs/glut
media-libs/mesa
media-libs/jpeg
media-libs/libpng
media-libs/giflib
dev-cpp/clucene
dev-util/cppunit
media-libs/liblrdf
dev-libs/libxml2
dev-libs/libxslt
x11-misc/shared-mime-info
kde-base/kdesdk-scripts
dev-libs/boost
x11-libs/qt
dev-util/cmake
sys-apps/dbus
dev-libs/redland

You will start compiling by hand from the [[Getting_Started/Build/KDE4#Strigi|Strigi section]].

Good Luck!

== Create a user account for KDE4 development ==

{{Note|
Some people like to have a separate user account for KDE 4 (for instance an old bug deleted files by mistake), and the instructions below were written with that approach.

However it is much more efficient to do everything with a single user account, see [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]
for more details.

You can still follow the instructions below, but don't put the environment variables in your <tt>.bashrc</tt>, put them in a separate file that you source to switch to the KDE 4 environment.
}}

=== Option 1: Command Line ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2: Using KControl ===

Instead of using the commands above, you can also use the User module in the KDE Control Center if you already have KDE3 installed.

=== Setting up the environment ===

Copy the {{path|~/.bashrc}} from your normal user account to the new kde-devel account. Next, copy and paste the contents of the [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|example .bashrc]] into {{path|~kde-devel/.bashrc}}. Be sure to comment out the line <tt>alias make=makeobj</tt> if you do not have the <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt> command available. To make it run, you have to open a new bash or to execute
<code bash>
source ~/.bashrc
</code>

This will provide access to commands such as <tt>cmakekde</tt> that are used in this tutorial as well as ensure that the proper paths are in place for Qt, KDE and CMake binaries.

For more information, please read the [[Getting Started/Increased Productivity in KDE4 with Scripts]] tutorial.

=== Switching to the New User ===
Switch to the user kde-devel: (don't forget the dash)
<code bash>
su - kde-devel
</code>

The rest of this tutorial assumes you are running as the <tt>kde-devel</tt> user.

== The development user's shell ==

On some systems a new user is configured by default to use {{path|/bin/sh}}. If this is not the case on your system, you can skip this section. Using {{path|/bin/sh}} can be very inconvenient to work with and you may want to change it to {{path|/bin/bash}} or another shell.

=== Option 1: As the kde-devel user ===

If you don't have root privileges and your system supports the changing of your own shell with the <tt>chsh</tt> application, then you could try to change your shell to {{path|/bin/bash}} by using:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2: As the root user ===

If your system comes with the <tt>usermod</tt> application you can run the following command as root: <tt>usermod -s /bin/bash</tt>.

Another option is to use the <tt>vipw</tt> application as root to safely edit your {{path|/etc/passwd}}. Locate 'kde-devel' in the the file. Change '{{path|/bin/sh}}' at the end of the line to read '{{path|/bin/bash}}', save your changes and exit.

The new shell will be started automatically when you log in as the kde-devel user again.

== D-Bus ==
QtDBus and KDE are known to work with D-Bus versions 0.62, as well as 0.92 and upwards. Versions 0.60 and 0.61 may work too but are not tested. Versions 0.90 and 0.91 are known not to work. We recommend using post-1.0 release versions (at least 0.94), so consider upgrading if you haven't done so.

You may skip this section if you have a recent D-Bus version or if you don't want to upgrade.

Before running these steps in the recipe, make sure your X11 headers and libraries are available. The configure script run on line 5 should output:
Building X11 code: yes

=== The Recipe ===

{{tip|Make sure you did set up your environment correctly as described [[Getting_Started/Build/KDE4#Setting_up_the_environment|above]]. This is necessary for the <tt>cs</tt> and <tt>cb</tt> functions to work.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
make install
dbus-uuidgen --ensure

=== What's Happening ===
After changing into the source directory (line 1), D-Bus source code is downloaded from freedesktop.org (line 2) and unpacked (line 3). After going into the newly created D-Bus directory (line 4), the build is set up using the supplied {{path|configure}} script (line 5). After building (line 6) and installing (line 7) D-Bus, we use the <tt>dbus-uuidgen</tt> tool to install a machine identification file that allows the bus to start automatically when the desktop session starts (line 8).

Note that you need write access to {{path|/var}} for the last two steps. If your system does not have the sudo command, you can use the <tt>su</tt> command instead, e.g. <tt>su -c "make install"</tt>.

=== Troubleshooting ===

If you get the error '''makeobj: command not found''' you are lacking the command <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Skip this if you have [http://cmake.org/ CMake] >=2.4.5 installed.
You should be able to directly use the binary packages available on the [http://www.cmake.org/HTML/Download.html CMake site]. There are also distribution specific packages available.

=== The Recipe ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click Here to learn more]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== What's Happening ===
First, we go back to the <tt>kde-devel</tt> user's source directory (line 1), get the CMake sources (line 2) and unpack them (line 3). We create a directory to build CMake in (line 4) and go into it (line 5). We then run the CMake bootstrap script to set up the CMake build (line 6), then make (line 7) and install it (line 8) using the root user.

If your system does not have the <tt>sudo</tt> command, you can instead do <tt>su -c "make install"</tt>.

== Qt ==
Next we need to get the Qt4 that is in KDE's source repository. KDE is guaranteed to build against any Qt 4.3. Qt 4.2 and earlier are not supported and will not work. Qt 4.3 has been released only recently, so your distribution probably doesn't have packages for it yet (known exceptions: Kubuntu, openSUSE, Fedora, Gentoo, Debian experimental). You should use the copy in the KDE Subversion servers.

=== The Recipe ===
cd
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -qdbus -pch -nomake examples \
-nomake demos
make -j2

# do copy files if the target doesnt match current dir,
# clear obj files to save disk space otherwise
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -exec rm {} \; ; \
else make install; fi;

=== What's Happening ===
We switch back to the <tt>kde-devel</tt> user's home directory (line 1) and download the source code using subversion (svn) from KDE's repository (line 2). After changing into the resulting {{path|qt-copy}} directory (line 3), we run a script that manages the patches that come with <tt>qt-copy</tt> (line 4).

Once the patches have been applied, we then set up the build using the <tt>configure</tt> script (line 5-7). The various command line options used are explained in the {{path|qt-copy/README.qt-copy}} file. Finally, we build the minimal requirements for KDE (line 8) and install (line 9-10) Qt. If you want all the example and demo applications, you can either build them individually or simply do a <tt>make</tt> from the {{path|qt-copy}} directory.

Note that the installation does not require root as it installs Qt locally into {{path|$QTDIR}}. Anyway, installation is only needed if {{path|$QTDIR}} differs from {{path|$HOME/qt-copy}}, which is not the case if you have exactly followed the instructions.

=== Troubleshooting ===
If you get "error: X11/Xlib.h: No such file or directory", install the devel package of <tt>xorg</tt> (the actual name may vary between operating systems, for example it is <tt>xorg-dev</tt> on Ubuntu based systems such as Kubuntu).

If you get an error in the configure step about missing defines, check the value of <tt>$QMAKESPEC</tt>. Some distributions set this to point directly to the system-installed Qt. If <tt>unset QMAKESPEC</tt> solves the problem, you probably want to add it to the <tt>~/.bashrc</tt> script.

If you get an error ".pch/debug-shared/QtCore", this is because Qt-4.3 enables precompiled headers if your gcc supports it, but for some reason it doesn't work for you. If you use distcc, configure qt with -no-pch. If you use icecream, update to the latest icecream from svn trunk.

Try running any Qt program, like {{program|assistant}}. If it crashes in QSpanData::adjustSpanMethods, then your problem is the oxygen style. Try removing {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} and {{path|lib/kde4/plugins/styles/oxygen.so}} if they exist in the KDE install prefix.

== Strigi ==

{{warning|If you have jumped to this section without reading [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''the recipes provided will not work'''.

The recipes are not in error; <tt>cs</tt> and <tt>cb</tt> are not typos. Your environment '''needs''' to be set up correctly for these instructions to work for you.}}

The code for getting file metadata now relies on Strigi. To install Strigi you need the libraries and headers for libz, libbz2, openssl (libcrypto or libssl), libclucene (=0.9.16; version 0.9.17 does '''not''' work), and either libxml2 or libexpat.

=== The Recipe ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/strigi
cd strigi
cmakekde

=== What's Happening ===
We change to the base source directory (line 1). We download the sources for Strigi using subversion (line 2), go into the new {{path|~/src/strigi}} directory (line 3), and commence the build (line 4). This will leave us in the strigi build directory after the build is completed.

==== TroubleShooting ====
If you get
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
you should install the development package for libxml2.

== Soprano ==

{{warning|If you have jumped to this section without reading [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''the recipes provided will not work'''.

The recipes are not in error; <tt>cs</tt> and <tt>cb</tt> are not typos. Your environment '''needs''' to be set up correctly for these instructions to work for you.}}

The code for getting file kmetadata relies on Soprano. To install Soprano you need the libraries and headers for librdf.

=== The Recipe ===
cd $KDE_SRC
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/soprano
cd soprano
cmakekde

=== What's Happening ===
We change to the base source directory (line 1). We download the sources for Soprano using subversion (line 2), go into the new {{path|~/src/soprano}} directory (line 3), and commence the build (line 4). This will leave us in the soprano build directory after the build is completed.

==== TroubleShooting ====
If you get
CMake Error: Could NOT find REDLAND
then you need librdf from the Redland.
If your distribution does not provide the librdf package, you can download the source there: [http://download.librdf.org/source/ http://download.librdf.org/source/] and build it.
(Gentoo users: The ebuild for librdf is named dev-libs/redland)

== kdelibs ==

With Qt4, Strigi, and Soprano built, we can now move on to building KDE's base libraries. If you use the aforementioned [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] this is where those new functions come in handy.

=== The Recipe ===

cd $KDE_SRC
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== What's Happening ===
We change to the base source directory (line 1) then make and go into the KDE directory (line 2). We download the sources for kdelibs using subversion (line 3), go into the new {{path|~/src/KDE/kdelibs}} directory (line 4), and commence the build (line 5). This will leave us in the <tt>kdelibs</tt> build directory after the build is completed.

{{tip|There might be missing dependencies on your system! They are easily overlooked in the output of <tt>cmakekde</tt>.
You might want to do a <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> prior to compiling any kde modules (like kdelibs, kdepimlibs etc.)}}

=== Additional KDE-specific CMake modules ===
There are additional CMake modules in {{path|kdelibs/cmake/modules/}} that are necessary for building KDE4 applications. These will be installed for you when kdelibs itself is installed.

=== Troubleshooting ===
If you have problems compiling kdelibs, first make sure the software in the [[Getting_Started/Build/KDE4#Required_Software|Required Software]] section above is installed and works. Other possible hints include:
* If the <tt>cmakekde</tt> command fails stating that CMake requires an out of source build directory, remove {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and try again.

If <tt>cmakekde</tt> still gives the same error then try this
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install
* If you received an error stating "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", then you need to change to your build directory before running cmakekde. (e.g <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* If Qt wasn't found or the wrong version of Qt was found, make sure that the qmake from the Qt you need is the first qmake in the path.
* If the problems persist, try the CMake make-option <tt>--keep-going</tt>.
* Here you need the libungif library, otherwise you will get an error message like "<tt>Could NOT find GIF</tt>".
* Qt-4.3 upgrade: if you get a link error in kjsembed talking about QScriptEngine, edit CMakeCache.txt in kdelibs and remove the lines that talk about QT_QTUITOOLS_LIBRARY, then type make again (that static library has a new dependency, and the cmake code that adds it needs to run).
* if you get <code>CMake Error: KDE Requires Qt to be built with SSL support
</code>, install openssl-devel, and re-compile QT.
* if you get <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> it means you compiled QT without QT3 support(no, linking to a true QT3 install won't work)

== kdepimlibs ==
After <tt>kdelibs</tt>, but before ''kdebase'', you need to build and install ''kdepimlibs''.

=== The Recipe ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== What's Happening ===
We go into the KDE source directory (line 1), download the source code for kdepimlibs using subversion (line 2) and then go into the new {{path|~/src/KDE/kdepimlibs}} directory (line 3). We then commence the build (line 4). This will leave us in the <tt>kdepimlibs</tt> build directory after the build is completed.

== kdebase ==
You may need kdebase for some kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Troubleshooting ===
If you have troubles compiling kdebase:
* Make sure you have the <tt>libxss headers</tt> installed. (Usually you got undefined references on xscreensaver objects if you haven't those headers)
* <tt>which meinproc</tt> has to deliver {{path|/home/kde-devel/kde/bin/meinproc}}
* if cmakekde can not find the path of kdepimlibs, edit the file {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}} and manually set <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* if you get an error saying "Please set the following variables: X11_XTest_LIB (ADVANCED)", install the devel package of <tt>Xtst</tt>. On some systems, this is packaged separately from <tt>xext</tt> and called <tt>x11proto-xext-dev</tt> or <tt>libxtst-dev</tt>. You may also need to remove the CMakeCache.txt file in the build dir after installing the package.
* the same for "X11_Xinerama_LIB (ADVANCED)" where you will need the devel package for <tt>xinerama</tt>.
* if you get the error "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", then you need to install the libfontconfig headers
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", you need to install soprano from kdesupport and to rebuild kdelibs
* if you get the error "‘XserverRegion’ does not name a type" make sure you have libxcomposite headers installed (<tt>libxcomposite-dev</tt> in ubuntu)

== Generating local API documentation ==
Although the API documentation for KDE is available online at [http://api.kde.org api.kde.org], it is sometimes useful to have it on your own disk, for example when you want to use [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] for browsing the documentation or when you are not able to be online all the time.

Be aware that generating the API documentation can take several hours and takes almost half a gigabyte of diskspace.
The generation is handled by a script in {{path|kdelibs/doc/api}}, you need <tt>doxygen</tt> to be able to run it.

To build the API documentation for kdelibs, type the following:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Repeat for other modules as desired. 
cd <module home>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

== General troubleshooting ==

What can happen over time, after some <tt>svn up</tt> commands, is that some of the tools used in the KDE build chain change their output format. For example, <tt>kcfg</tt> files are read by <tt>kconfig_compiler</tt> to produce configuration dialogs. CMake cannot detect those changes, and the compilation might fail. A workaround is to always force a re-generation of all such files:
find $KDE_SRC/kde/kdebase -name "*.kcfg" | xargs touch
The same applies to <tt>ui</tt> files as produced by Qt designer.

== Success! ==

You are now ready to start building other svn modules in the same fashion as you built kdebase, running and testing KDE4 or writing your own patches and applications.

See the [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] tutorial for how to start KDE 4 applications and how to use KDevelop to work on them.

[[Category:Build KDE]]
[[Category:KDE4]]

Talk:Installing third party softwares in terminal/Build/KDE4

2007-06-07T01:08:46Z

Liquidat: /* Amount of space needed? */

==== This article is full of errors ====

For example it *is* nessecary to install qt-copy, even if you keep it in the source directory (which leads to 394583069845 error messages on the console during the install). And kdelibs won't build unless something unknown is done with strigi - if it is installed into KDEDIR, it isn't just found.

==== This article is complicated ====
when I wrote this article, it was lean and simple. It has been improved somewhere, but on most places worsened. An example is the directory structure (to get to qt-copy: cd && cd qt-copy; to get to kdelibs: cs && cd kdelibs; to get to kdepim: cs && cd KDE && cd kdepim - no one understands this!!!).
Another example is cs and cb which is quite unnecessary as my initial article shows. But of course, with the complexity as the article has NOW, it IS necessary.

Why do you spoil a simple article so that even I no longer find my own subdirs ?
--[[User:Tstaerk|Tstaerk]] 10:25, 28 May 2007 (CEST)

: Where do you see "cs && cd KDE && cd kdepim"? Because I don't see that anywhere. In any case it would just be "cs kdepim". Perhaps that's the bit need explaining a bit better? --[[User:Aseigo|Aseigo]] 02:48, 29 May 2007 (CEST)

:To whom are you talking to? ;) There are many contributors and as it's a wiki an article probably "degenerates" automatically if noone has an eye on it. The article certainly has valuable information and simply needs a cleanup. In other words: Fix it! :) --[[User:Dhaumann|Dhaumann]] 12:20, 28 May 2007 (CEST)

::IMHO all of this cs/cb/cmakekde and such is only confusing, users just do copy&paste with no really knowledge of what's going on when they type those commands. This way troubleshooting is quite difficult, and they learn nothing about the '''real''' compiling way. The concept of source/build dirs is barely noted. The ''old'' http://developer.kde.org/build/trunk.html has some more commands to type, but it was quite more understandable and clear about the '''real''' steps to do. --[[user:Pino|pino]] 12:54, 28 May 2007 (CEST)

::: Yes, this article could go back to being more verbose. I suppose what is missing is an explanation of ''why'' the shortcuts are used. They are there for a reason. I also don't get the differentiation between real and not real steps; unless we now consider using the shell for what it was designed for as not real. --[[User:Aseigo|Aseigo]] 02:48, 29 May 2007 (CEST)

:::: What's wrong in explicitely telling:
<pre>
svn co .../kdelibs
mkdir build-kdelibs
cd build-kdelibs
cmake <options> ../kdelibs
make install
</pre>
:::: After all, we did that with the <tt>./configure && make && make install</tt> sequence in KDE 3 times, and that worked quite fine. I still fail why we have to make our things more complicated. Moreover, these macros force fixed paths -- [[user:Pino|pino]] 23:43, 29 May 2007 (CEST)

==== Q: What is cs and cb? ====

A: '''This is not a typo'''. Read the article about setting up your .bashrc. Both '''cs''' and '''cb''' are bash functions, used to change to the KDE source directory and KDE build directory respectively.

==== Q: Are there build instructions for other OS? ====

A: Actually '''yes''', for [[Getting Started/Build/KDE4/Mac OS X|Mac OS X]]. There also is [http://www.kdelibs.com kdelibs.com] (see also [[User_talk:Jstaniek#KDElibs.com_and_developernew.kde.org_coexistence|here]]) which will be merged into this wiki in the future.

==== Q: Isn't the install prefix, make and make install missing for modules like kdelibs and kdebase? ====
A: No. The shell function ''cmakekde'' handels this, have a look at the file [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|.bashrc]].

==== Q: How can I generate API Documentation for other modules? ====
A: Try the following code, replacing <modulename> with your desired module:
cs
mkdir -p apidox
cs apidox
../kdelibs/doc/api/doxygen.sh ../<modulename>/

I tried that and got the following:
<code bash>
kdedev@PC1:~/src/KDE/apidox$ ../kdelibs/doc/api/doxygen.sh ../kdepimlibs/
*** doxygen.sh
* $DOXDATA does not name a directory ( or is unset ), tried "/media/kdedev/home/src/KDE/kdepimlibs/doc/common"
</code>
What is wrong here? -[[User:TMG|TMG]] 23:55, 28 March 2007 (CEST)

==== Q: I changed the first command of the "Set up QT - Recipe" from cd to cs because I think this was a typo. Am I right?? ====
A: Right --[[User:Dhaumann|Dhaumann]]

:: no, it was perfectly intentional. see the [[/Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc bashrc in the productivity with KDE4 scripts tutorial]]. it has QTDIR set to ~/qt-copy. this makes sense, actually, since building Qt is done rather differently from the rest of KDE and one may not get Qt from KDE's svn in any case. so yes, it is supposed to be cd, not cs.

::: *blush* ;) i should read more carefully. --[[User:Dhaumann|Dhaumann]]

==== Notes: ~/install ====

When installing KDE4, I strongly recommend installing all tools (like dbus and cmake) and kde packages into the same place, e.g. ~/install. Qt is the only exception.

The reason for this is because if you install some packages to ~/kde and some to /usr/local and maybe one in /usr then cmake will generate errors like:

-- It is impossible to order the include directories.

This is not a fatal error, so you will still be able to compile, but you will possibly be using the wrong versions of libraries and this will product problems that are very hard to diagnose.

You may not experience any problems when installed like I advise not to, however I have and you might too in some typical situations.

Please see:

http://developer.kde.org/build/trunk.html

==== Install CMake modules local ====

The CMake modules should be installed local into ~/install/cmake/modules or similar.
When following the current instructions [[ Getting_Started/Build/KDE4#Install_additional_CMake_modules|6.1: Install additional CMake modules]], it's impossible to do a non-root installation, because "kdelibs/cmake/modules/cmake_install.cmake" wants to install the modules to "/cmake/modules". (I didn't install CMake local, because my system already provided CMake > 2.4.3).

I've already tried to do this, fiddling around with CMAKE_MODULE_PATH and DATA_INSTALL_DIR but couldn't get it working.

Does anybody know how to do this properly?

--[[User:Eliasp|Eliasp]] 15:44, 4 January 2007 (CET)

==== Fixes needed ====
* qt-copy: Should we pass the -debug flag? Doesn't Qt install debug information separately by default anyways? Or is that just in the snapshot? --[[User:Mpyne|Mpyne]]

: according to ./configure --help, the default is -release in snapshot. --[[User:Aseigo|Aseigo]] 04:33, 14 March 2007 (CET)

* In the part of the tutorial that describes how to create a new users, shoudn't to have an edit /etc/sudoers to add permitions for kde-devel call sudo? --[[User:SilveiraNeto|SilveiraNeto]] 03:01, 14 March 2007 (CET)

: no. why would you want them to have sudo access?

==== libungif/giflib ====
Since the patents expired, why not use giflib?

==== Old gcc and -pch flag ====
In Qt part I had problems with error like this: [http://www.qtforum.org/thread.php?threadid=19998 QtForum thread]. I had GCC 3.3.X installed. Using -pch flag (as in recipe) get me errors. Someone friendly gave me tip on #kde-devel not to use this flag, although I didn't test it. Instead I've just updated gcc and g++ from debian repositories. Newer version works fine as "Precompiled headers are supported in GCC (3.4 and newer)" [http://en.wikipedia.org/wiki/Precompiled_header Wikipedia pch].

==== Build status ====

You might want to include the [http://developer.kde.org/~dirk/dashboard/ dashboard link] to show which modules currently build and which don't. --[[User:141.35.8.106|141.35.8.106]] 13:28, 20 March 2007 (CET)

== Extra optional software ==

- openldap
- cyrus

If there was a line at the top like:

sudo apt-get install libaaa-dev libbbb-dev ...-dev ...

This would be very useful and save hours. Is this something we should do?

== su - kde4 didn't set the variables ==

after running 'su - kde4' and 'export' i saw that no variables in .bashrc were set, instead the old one (of the system) where set. I tried 'su kde4' and it worked fine. Why is that?

I'm running gentoo 2006.1 amd64

== Qt Flags ==

Are "-pch" and "-qdbus" really needed? The configure script shows that they're enabled by default. --[[User:McEnroe|McEnroe]] 16:49, 19 April 2007 (CEST)

== Amount of space needed? ==

It would be nice to know how much space (roughly, in GB) you need for a setup to build and run the basic things and packages. --[[User:Liquidat|Liquidat]] 03:08, 7 June 2007 (CEST)

Talk:Installing third party softwares in terminal/Build/KDE4

2007-06-07T01:08:21Z

Liquidat: Amount of space needed?

User:Liquidat

2007-06-07T01:00:13Z

Liquidat:

Not much to tell, but most people know me through my blog: 
[http://liquidat.wordpress.com /home/liquidat]

Getting Started/Build/KDE4 (de)

2007-06-05T14:15:56Z

Liquidat: /* Qt */

{{Template:I18n_Getting_Started_Build_KDE4}}

{{TutorialBrowser|

series=Vorbereitungen|

name=KDE4 aus dem Quellcode bauen|

pre=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]|

next=[[../../Set_up_KDE_4_for_development|Set up KDE 4 for development]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: The KDE From Subversion Build Tool] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]] [[../KDE4/FreeBSD|FreeBSD notes]] [[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Übersicht ==

Diese Anleitung zeigt einen Weg, KDE auf Linux- und BSD-Systemen
zu komplieren und auszuführen. Als Grundlage verwenden wir die Shell.
Wenn Sie sich für die Installation auf anderen Systeme wie etwa Solaris, MacOS oder Microsoft Windows interessieren, besuchen Sie bitte [[../|Build]] und folgen Sie den Links am Ende der Seite.

{{warning|Stellen Sie sich auf verstärkt auftretende Buildprobleme '''an Montagen''' ein, da die Entwickler an diesem Wochentag kritische Änderungen vornehmen. Das [http://developer.kde.org/~dirk/dashboard/ Dashboard] zeigt unerwartete Probleme beim Kompilieren an.
}}

== Benötigte Software ==

Folgendes muss installiert sein, um dieses Tutorial erfolgreich durchführen zu können:
* gcc und g++ vom gcc Projekt, vorzugsweise Version 4.1 oder höher
* svn, der subversion revision control client
* pkg-config
* devel-(Entwicklungs-)Bibliotheken und -header für X11, OpenGL (mesa-common-dev und libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 und libxslt
* Das <tt>makeobj</tt> Skript, welches Teil von kdesdk ist. Sie können es als Teil von kdesdk (kdesdk-scripts in Debian) installieren oder von hier einzeln herunterladen: [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* das [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info Paket], welches der freedesktop-MIME-Standard ist, den KDE nun nutzt
* [http://boost.org/ boost], welches von kdebase gebraucht wird. Nach dem Kompilieren und/oder Installieren von boost fügen Sie das boost-Verzeichnis (das, welches das include-Unterverzeichnis enthält) zu CMAKE_INCLUDE_PATH hinzu, oder kreieren Sie eine Umgebungsvariable namens BOOST_ROOT, die zum boost-Verzeichnis verweist, um cmake den Ort von boost mitzuteilen (FindBoost).

Weiterhin ist es zu empfehlen, folgende Software bereits installiert zu haben:
* bash

=== Kubuntu ===

In Kubuntu 7.04 (Feisty) kann alle zum Bau der Pakete benötigte Software mit folgendem Befehl installiert werden:
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake libungif4-dev \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng-dev libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen
</code>

Die manuelle Installation von Qt 4.3, CMake 2.4.6 und DBus kann durch die Installation der folgenden Pakete und ihrer Abhängigkeiten vermieden werden:
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Für eine voll funktionstüchtige [[apidox]]-Umgebung wird ebenfalls zusätzliche Software benötigt:
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===
{{note|
Der openSUSE build service stellt ebenfalls tagesaktuelle KDE-4-Pakete bereit, die das gesamte auf dieser Seite beschriebene Vorgehen überflüssig machen. Weitere Informationen findet man direkt im openSUSE wiki unter [http://de.opensuse.org/KDE4 KDE4].
}}

In OpenSuse können Pakete mit Hilfe von [http://de.opensuse.org/Zypper Zypper] installiert werden:
<code bash>
sudo zypper install <package-name>
</code>

In älteren SUSE-Versionen geht dies nur mit Yast:
<code bash>
yast2 -i <packagename>
</code>

Die meisten zum Bau von KDE 4 nötigen Pakete sind:
<code bash>
xorg-x11-devel, libxml2-devel, kdesdk3, clucene-core-devel, libjpeg-devel, liblrdf-devel, libpng-devel, libxslt-devel, Mesa-devel, giflib-devel, subversion, gcc, gcc-c++
</code>

Bereits vorkompilierte CMake-Pakete für openSUSE sind direkt verfügbar im [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

== Ein Benutzer für die KDE-4-Entwicklung ==

{{Note|
Einige Menschen ziehen es vor, für KDE 4 einen separaten Nutzer-Account einzurichten, um nicht aus Versehen durch noch bestehende Bugs oder ähnliches Daten zu verlieren. Die Anleitung hier basiert auf der Herangehensweise.

Es ist jedoch deutlich effizienter alles mit einem einzigen Nutzer-Account zu machen. Unter [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] findet man mehr Details dazu.

In diesem Fall ist die folgende Anleitung noch immer gültig, jedoch sollten die nötigen Umgebungsvariablen nicht in die <tt>.bashrc</tt>, sondern in eine separate Datei geschrieben werden, die dann bei Bedarf eingelesen wird.
}}

=== Option 1: Kommandozeile ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2: Über KControl ===

Anstatt der oben genannten Befehle kann man auch mit Hilfe des Benutzer-Moduls im KDE-Kontrollzentrum (kcontrol) einen weiteren Benutzer einrichten.

=== Einrichten der Entwicklungsumgebung ===

Kopieren Sie die Datei {{path|~/.bashrc}} von Ihrem normalen Benutzer-Account zu Ihrem neuen kde-devel-Account. Danach fügen Sie den Inhalt der Seite [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|example .bashrc]] in die Datei {{path|~kde-devel/.bashrc}} ein. Stellen Sie sicher, dass die Zeile <tt>alias make=makeobj</tt> auskommentiert ist falls auf Ihrem System das Programm <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt> nicht verfügbar ist.
Die neue {{path|~/.bashrc}} wird mit folgendem Befehl eingelesen:
<code bash>
source ~/.bashrc
</code>

Nun haben Sie Zugriff auf Befehle wie <tt>cmakekde</tt>, die in dieser Anleitung genutzt werden. Auch wird so sichergestellt, dass alle wichtigen Umgebungsvariablen (z. B. für die Pfadangaben von Qt, KDE und CMake) richtig gesetzt sind.

Für weitere Informationen lesen Sie bitte [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Zum neuen Benutzer wechseln ===

Sie können sich nun als Benutzer kde-devel anmelden (der Bindestrich ist wichtig!):
<code bash>
su - kde-devel
</code>

Der Rest dieser Anleitung geht davon aus, dass Sie alle Befehle als <tt>kde-devel</tt> ausführen.

== Die Shell des Entwicklungsbenutzers ==
Auf manchen Systemen nutzen neue Benutzer standardmäßig {{path|/bin/sh}}. Wenn dies auf Ihrem System nicht der Fall ist, können Sie diesen Abschnitt überspringen. {{path|/bin/sh}} zu nuzten kann sich als sehr unangenehm erweisen. Daher sollten Sie erwägen, zu {{path|/bin/bash}} oder einer anderen Shell zu wechseln.

=== Option 1: Als kde-devel-Benutzer ===
Wenn Sie keine root-Privilegien haben und Ihr System das Wechseln der eigenen Shell mittels <tt>chsh</tt> unterstützt, können Sie versuchen, Ihre Shell zu {{path|/bin/bash}} zu wechseln, indem Sie Folgendes eingeben:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2: Als root-Benutzer ===
Wenn Ihr System die Anwendung <tt>usermod</tt> beinhaltet, können Sie den folgenden Befehl als root-Benuzter eingeben: <tt>usermod -s /bin/bash</tt>.

Eine weitere Möglichkeit ist die Nutzung der Anwendung <tt>vipw</tt> als root-Benuzter, um auf sichere Art {{path|/etc/passwd}} zu editieren. Machen Sie 'kde-devel' in dieser Datei ausfindig und ändern Sie '{{path|/bin/sh}}' am Zeilenende in '{{path|/bin/bash}}'. Speichern Sie die Änderungen und beenden Sie die Anwendung.

Die neue Shell wird automatisch gestartet wenn Sie sich wieder als kde-devel-Benutzer einloggen.

== D-Bus ==
QtDBus und KDE arbeiten mit den D-Bus-Versionen 0.6.2, 0.92 und höher zusammen. Die Versionen 0.60 und 0.61 funktionieren eventuell auch, sind aber ungetestet. Die Versionen 0.90 und 0.91 funktionieren definitiv nicht.

Wir empfehlen, dass Sie eine aktuelle, stabile Version, also größer Version 1.0, benutzen, wenigstens aber Version 0.94.

Wenn Sie eine aktuelle D-Bus-Version auf ihrem System bereits installiert haben oder Ihre D-Bus-Version nicht aktualisieren wollen, können Sie die nächste Sektion überspringen.

Bevor Sie die nächsten Schritte durchgehen sollten Sie sicherstellen, dass die X11-header und -Bibliotheken installiert sind. Das Konfigurationsskript sollte in Zeile 5 Folgendes ausgeben:
Building X11 code: yes

=== Das Kochrezept ===

{{tip|Stellen Sie sicher, dass Ihre Umgebung [[Getting_Started/Build/KDE4#Setting_up_the_environment|wie beschrieben]] eingerichtet wurde. Das ist wichtig für das Funktionieren der <tt>cs</tt>- und <tt>cb</tt>-Befehle.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' ist eine Bash-Funktion, klicken Sie hier, um mehr darüber zu lernen]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=$KDEDIR/var
make
make install
dbus-uuidgen --ensure

=== Was hier passiert ===
Wir wechseln in Zeile 1 in das Quellen-Verzeichnis, laden in Zeile 2 den Quellcode von freedesktop.org herunter und entpacken diesen in Zeile 3.
In Zeile 4 wechseln wir in das neu erstellte Verzeichnis, und bereiten in Zeile 5 das Kompilieren der Quelldateien vor. Zeile 6 setzt den Kompilier-Vorgang in Gang, Zeile 7 installiert D-Bus, und in Zeile 8 benutzen wir das <tt>dbus-uuidgen</tt>-Werkzeug, um eine Maschinen-Identifikation zu installieren. Das erlaubt dem bus, automatisch mit der Desktop-Sitzung zu starten.

Achten Sie darauf, dass Sie Schreibrechte auf {{path|/var}} haben, da Sie sie für die letzten beiden Schritte benötigen. Falls Ihr System kein sudo-Kommando unterstützt, können Sie auch <tt>su</tt> benutzen, z. B. <tt>su -c "make install"</tt>.

=== Fehlerbehebung ===

Falls Sie die Fehlermeldung '''makeobj: command not found''' bekommen fehlt Ihnen <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Überspringen Sie diesen Abschnitt, wenn Sie [http://cmake.org/ CMake] >=2.4.5 installiert haben.
Es sollte Ihnen möglich sein, die Binärpakete zu installieren, die hier verfügbar sind: [http://www.cmake.org/HTML/Download.html CMake site]. Dort sind ebenfalls distributionsspezifische Pakete zu finden.

=== Das Kochrezept ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' ist eine Bash-Funktion, klicken Sie hier, um mehr zu erfahren]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== Was hier passiert ===
Zuerst wechseln wir in das Quellverzeichnis des <tt>kde-devel</tt>-Benutzers (Zeile 1), laden den CMake-Quellcode herunter (Zeile 2) und entpacken ihn (Zeile 3). Dann erstellen wir ein Verzeichnis, in dem wir CMake kompilieren (Zeile 4) und wechseln in dieses (Zeile 5). Hier führen wir das CMake-bootstrap-Skript aus (Zeile 6), dann den make-Befehl (Zeile 7) und schließlich die Installation als root-Benuzter (Zeile 8).

Wenn Ihr System den <tt>sudo</tt>-Befehl nicht beinhaltet, können Sie stattdessen Folgendes eingeben: <tt>su -c "make install"</tt>.

== Qt ==
Als nächstes wird Qt 4 benötigt; es befindet sich im KDE-Quell-Repository. KDE kompiliert garantiert gegen jedes Qt der Version 4.3. Qt 4.2 und früher sind nicht unterstützt und funktionieren nicht. Da Qt 4.3 erst kürzlich veröffentlicht worden ist, finden sich wahrscheinlich noch keine Pakete für Ihre Distribution (bekannte Ausnahmen sind Kubuntu und openSUSE). Sie sollten die Kopie auf den KDE-Subversion-Servern verwenden.

=== Das Kochrezept ===
cd
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -qdbus -pch -nomake examples \
-nomake demos
make -j2
# make install: Nur wenn QTDIR nicht das momentane Verzeichnis ist!
make install

=== Was hier passiert ===
Wir wechseln in das Heimverzeichnis des <tt>kde-devel</tt>-Benutzers (Zeile 1) und laden den Quellcode mittels Subversion (svn) herunter (Zeile 2). Nach dem Wechsel in das daraus resultierende Verzeichnis {{path|qt-copy}} (Zeile 3), führen wir ein Skript aus, das die Patches integriert, die mit <tt>qt-copy</tt> kommen (Zeile 4).

Sobald die Patches integriert sind, konfigurieren wir das build mittels des <tt>configure</tt>-Skripts (Zeilen 5-7). Die verschiedenen Kommandozeilenoptionen werden in der Datei {{path|qt-copy/README.qt-copy}} erläutert. Schließlich kompilieren wir die Mininalanforderungen für KDE (Zeile 8) und installieren Qt (Zeilen 9-10). Wenn Sie alle Beispiel- und Demo-Applikationen installieren möchten, können Sie sie entweder einzeln kompilieren oder einfach den Befehl <tt>make</tt> im Verzeichnis {{path|qt-copy}} ausführen.

Beachten Sie, dass die Installation keine root-Rechte verlangt, da Qt lokal in {{path|$QTDIR}} installiert wird. Die Installation ist ohnehin nur nötig, wenn {{path|$QTDIR}} sich von {{path|$HOME/qt-copy}} unterscheidet, was nicht der Fall ist, wenn Sie die Anweisungen exakt befolgt haben.

=== Fehlerbehebung ===
Wenn Sie die Fehlerausgabe "error: X11/Xlib.h: No such file or directory" erhalten, installieren Sie das devel-Paket von <tt>xorg</tt> (der Name des Pakets kann in verschiedenen Distributionen abweichen, in (K)Ubuntu z. B. ist er <tt>xorg-dev</tt>).

Wenn Sie eine Fehlermeldung im configure-Schritt erhalten, die auf "missing defines" hinweist, prüfen Sie den Wert von <tt>$QMAKESPEC</tt>. Manche Distributionen lassen die Variable direkt auf das standardmäßig installierte Qt verweisen. Wenn der Befehl <tt>unset QMAKESPEC</tt> das Problem löst, sollten Sie überlegen, ihn zum <tt>~/.bashrc</tt>-Skript hinzuzufügen.

Wenn Sie die Fehlermeldung ".pch/debug-shared/QtCore" erhalten, bedeutet dies, dass Qt-4.3 zwar die vorkompilierten header aktiviert hat (wenn Ihr gcc dies unterstützt), es jedoch nicht funktioniert. Wenn Sie distcc nutzen, konfigurieren Sie Qt mit der Option -no-pch. Wenn Sie icecream nutzen, führen Sie ein Update zur neuesten Version von icecream im svn trunk durch.

Versuchen Sie, irgendeine Qt-Applikation zu starten, beispielsweise {{program|assistant}}. Wenn sie in QSpanData::adjustSpanMethods abstürzt, haben Sie ein Problem mit dem Oxygen style. Versuchen Sie, {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} und {{path|lib/kde4/plugins/styles/oxygen.so}} zu entfernen, wenn sie sich im KDE-Installationspräfix finden.

== Strigi ==

{{warning|Wenn Sie diesen Abschnitt erreicht haben, ohne [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]] zu lesen, '''werden die hier angebotenen Rezepte nicht funktionieren'''. Diese Rezepte sind nicht defekt; <tt>cs</tt> und <tt>cb</tt> sind keine Tippfehler. Ihre Umgebung '''muss''' korrekt eingerichtet sein, damit diese Instruktionen funktionieren.}}

Der Code zum Erhalten der Dateimetadaten ist nun von Strigi abhängig. Um Strigi zu installieren, benötigen Sie die Bibliotheken und Header von libz, libbz2, openssl (libcrypto oder libssl), libclucene (=0.9.16; Version 0.9.17 funktioniert '''nicht'''), und entweder libxml2 oder libexpat.

=== Das Kochrezept ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs ist KEIN Tippfehler]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/strigi
cd strigi
cmakekde

=== Was hier passiert ===
Wir wechseln in das Quellverzeichnis (Zeile 1), laden den Quellcode für Strigi mittels Subversion herunter (Zeile 2) und wechseln anschließend in das neue Verzeichnis {{path|~/src/strigi}} (Zeile 3). Dann starten wir die Kompilierung (Zeile 4). Wir finden uns im Anschluss an die Kompilierung im build-Verzeichnis von Strigi wieder.

=== Fehlerbehebung ===
Wenn Sie
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
erhalten, sollten Sie das devel-Paket für libxml2 installieren.

== Soprano ==

{{warning|Wenn Sie diesen Abschnitt erreicht haben, ohne [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]] zu lesen, '''werden die hier angebotenen Rezepte nicht funktionieren'''. Diese Rezepte sind nicht defekt; <tt>cs</tt> und <tt>cb</tt> sind keine Tippfehler. Ihre Umgebung '''muss''' korrekt eingerichtet sein, damit diese Instruktionen funktionieren.}}

Der Code zum Erhalten von kmetadata für Dateien ist von Soprano abhängig. Um Soprano zu installieren benötigen Sie die Bibliotheken und Header von librdf.

=== Das Kochrezept ===

cd $KDE_SRC
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/soprano
cd soprano
cmakekde

=== Was hier passiert ===
Wir wechseln in das Quellverzeichnis (Zeile 1), laden den Quellcode für Soprano mittels Subversion herunter (Zeile 2) und wechseln anschließend in das neue Verzeichnis {{path|~/src/soprano}} (Zeile 3). Dann starten wir die Kompilierung (Zeile 4). Wir finden uns im Anschluss an die Kompilierung im build-Verzeichnis von Soprano wieder.

=== Fehlerbebung ===
Wenn Sie
CMake Error: Could NOT find REDLAND
erhalten, benötigen Sie librdf aus den Redland-Bibliotheken.
Wenn Ihre Distribution das librdf-Paket nicht zur Verfügung stellt, können Sie dessen Quellcode hier herunterladen [http://download.librdf.org/source/ http://download.librdf.org/source/] und selbst kompilieren. In Gentoo heißt das Paket 'redland' anstatt librdf.

== kdelibs ==
Nachdem wir Qt 4 und Strigi kompiliert haben, können wir nun mit dem Kompilieren der KDE-Basisbibliotheken fortschreiten. Wenn Sie die oben genannte Anleitung bezüglich [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] nutzen, kommen Ihnen diese neuen Funktionen im Folgenden gelegen.

=== Das Kochrezept ===


cd $KDE_SRC
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Was hier passiert ===
Wir wechseln in das KDE-Quellverzeichnis (Zeile 1), erstellen ein Verzeichnis names KDE und wechseln in dieses (Zeile 2). Dann laden wir den Quellcode der kdelibs mittels Subversion herunter (Zeile 3), wechseln in das neue Verzeichnis {{path|~/src/KDE/kdelibs}} (Zeile 4) und starten die Kompilierung (Zeile 5). Wir finden uns anschließend im <tt>kdelibs</tt>-build-Verzeichnis wieder.

{{tip|Es könnte einige fehlende Anhängigkeiten auf Ihrem System geben! Sie können in der Ausgabe von <tt>cmakekde</tt> leicht übersehen werden.
Sie können vor dem Kompilieren jeglicher KDE-Module (wie kdelibs, kdepimlibs usw.) <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> ausführen.}}

=== Zusätzliche KDE-typische CMake-Module ===
Es gibt weitere CMake-Module in {{path|kdelibs/cmake/modules/}}, die für die Kompilierung von KDE4-Applikationen nötig sind. Sie werden mit kdelibs installiert (siehe unten).

=== Fehlerbebung ===
Wenn Sie Schwierigkeiten bei der Kompilierung von kdelibs haben, stellen Sie sicher, dass Sie die Software im obigen Abschnitt [[Getting_Started/Build/KDE4#Required_Software|Required Software]] installiert haben und dass sie funktioniert. Andere mögliche Probleme sind:
* Wenn der Befehl <tt>cmakekde</tt> mit der Ausgabe fehlschlägt, dass CMake ein "out of source" build-Verzeichnis benötigt, entfernen Sie {{path|~/src/KDE/kdelibs/CMakeCache.txt}} und versuchen Sie es erneut.

Wenn <tt>cmakekde</tt> dennoch denselben Fehler ausgibt, versuchen Sie Folgendes:
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install
* Wenn Sie die Fehlerausgabe "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there." erhalten, müssen Sie in Ihr build-Verzechnis wechseln bevor Sie cmakekde ausführen. (z. B. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Wenn Qt nicht oder in einer falschen Version gefunden wird, stellen Sie sicher, dass das qmake der benötigten Qt-Version an erster Stelle (unter den qmake-Einträgen) im Pfad eingetragen ist.
* Wenn das Problem nach wie vor vorhanden ist, versuchen Sie die CMake make-Option <tt>--keep-going</tt>.
* Sie benötigen die libungif-Bibliothek, ansonsten erhalten Sie eine Fehlerausgabe ähnlich "<tt>Could NOT find GIF</tt>".
* Qt-4.3-Upgrade: Wenn Sie einen Verknüpfnugsfehler in kjsembed erhalten, der auf die QScriptEngine bezogen ist, editieren Sie CMakeCache.txt in kdelibs und entfernen Sie die Zeilen, die sich auf QT_QTUITOOLS_LIBRARY beziehen, und führen Sie den make-Befehl erneut aus (diese statische Bibliothek hat eine neue Abhängigkeit und der cmake-Code, der diese hinzufügt, benötigt sie, um ausgeführt zu werden).
* Wenn Sie die Fehlerausgabe <code>CMake Error: KDE Requires Qt to be built with SSL support</code> erhalten, installieren Sie openssl-devel, und rekompilieren Sie Qt.

== kdepimlibs ==
Sie müssen ''kdepimlibs'' nach <tt>kdelibs</tt>, aber vor ''kdebase'' installieren.

=== Das Kochrezept ===


cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs ist KEIN Tippfehler]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Was hier passiert ===
Wir wechseln in das KDE-Quellverzeichnis (Zeile 1), laden den Quellcode für kdepimlibs mittels Subversion herunter (Zeile 2) und wechseln anschließend in das neue Verzeichnis {{path|~/src/KDE/kdepimlibs}} (Zeile 3). Dann starten wir die Kompilierung (Zeile 4). Wir finden uns im Anschluss an die Kompilierung im build-Verzeichnis von <tt>kdepimlibs</tt> wieder.

== kdebase ==
Für manche kioslaves könnte kdebase benötigt werden.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs ist KEIN Tippfehler]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Fehlerbebung ===

Wenn Sie Schwierigkeiten beim Kompilieren von kdebase haben:
* Stellen Sie sicher, dass die <tt>libxss-Header</tt> installiert sind. (Sollten diese nicht installiert sein, erhalten Sie in der Regel undefinierte Verweise auf xscreensaver-Objekte.)
* <tt>which meinproc</tt> muss {{path|/home/kde-devel/kde/bin/meinproc}} ausgeben.
* Wenn cmakekde das kdepimlibs-Verzeichnis nicht finden kann, editieren Sie die Datei {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} und definieren Sie <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt> manuell.
* Wenn Sie die Fehlerausgabe "Please set the following variables: X11_XTest_LIB (ADVANCED)" erhalten, installieren Sie das devel-Paket von <tt>Xtst</tt>. Auf manchen Systemen ist es separat von <tt>xext</tt> gepackt und heißt <tt>x11proto-xext-dev</tt> oder <tt>libxtst-dev</tt>. Sie müssen eventuell außerdem nach der Installation dieses Paketes die Datei CMakeCache.txt im build Verzeichnis löschen.
* Dasselbe gilt für die analoge Fehlerausgabe betreffend der Variable "X11_Xinerama_LIB (ADVANCED)": Sie benötigen das devel-Paket für <tt>xinerama</tt>.
* Wenn Sie die Fehlerausgabe "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)" erhalten, müssen Sie die libfontconfig-Header installieren.
* Wenn Sie die Fehlerausgabe "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES" erhalten, müssen Sie soprano aus kdesupport installieren und dann kdelibs neu kompilieren.
* Wenn Sie die Fehlerausgabe "‘XserverRegion’ does not name a type" erhalten, stellen Sie sicher, dass Sie die libxcomposite header installiert haben. (In Ubuntu heißen diese <tt>libxcomposite-dev</tt>.)

== Lokale API-Dokumentation erstellen ==

Obwohl die API-Dokumentation für KDE online unter [http://api.kde.org api.kde.org] verfügbar ist, kann es hilfreich sein, sie offline verfügbar zu haben, zum Beispiel wenn Sie [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] zum Durchsuchen der Dokumentation nutzen oder wenn Sie nicht ständig online sein können.

Seien Sie sich bewusst, dass das Generieren der API-Dokumentation mehrere Stunden in Anspruch nehmen kann und knapp ein halbes Gigabyte an Speicherplatz benötigt.
Das Generieren wird von einem Skript in {{path|kdelibs/doc/api}} ausgeführt; Sie benötigen <tt>doxygen</tt>, um es ausführen zu können.

Um die API-Dokumentation für kdelibs zu generieren, geben Sie Folgendes ein:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs ist KEIN Tippfehler]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Wiederholen Sie dies nach Bedarf für andere Module.

== Allgemeine Fehlerbehebung ==

Es kann im Laufe der Zeit nach mehrmaligem Ausführen von <tt>svn up</tt> vorkommen, dass sich das Ausgabeformat einiger Werkzeuge, die in der KDE-Werkzeugkette benutzt werden, ändert. Zum Beispiel werden <tt>kcfg</tt> Dateien vom <tt>kconfig_compiler</tt> gelesen, um die Konfigurationsdialoge zu generieren. Da CMake diese Veränderungen nicht erkennt, kann das Kompilieren fehlschlagen. Eine provisorische Lösung ist, die Regenerierung all dieser Dateien zu erzwingen:
find $KDE_SRC/kde/kdebase -name "*.kcfg" | xargs touch
Dasselbe gilt für <tt>ui</tt> Dateien wie solche, die mit Qt Designer generiert werden.

== Das war's! ==

Sie sind nun bereit, andere svn-Module in derselben Weise wie kdebase zu kompilieren, KDE 4 zu benutzen und zu testen, sowie Ihre eigenen Patches und Anwendungen zu schreiben.

Siehe auch die Anleitung [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] um Hilfe beim Starten von KDE-4-Anwendungen sowie zur Benutzung von KDevelop zu erhalten.

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4 (de)

2007-06-05T01:15:30Z

Liquidat: /* D-Bus */

{{Template:I18n_Getting_Started_Build_KDE4}}

(Diese Anleitung befindet sich noch im Aufbau und ist eine Kopie des [[Getting_Started/Build/KDE4|englischen Orginals]]. Hilf mit, es zu übersetzen und es auf dem aktuellen Stand zu halten!)

{{TutorialBrowser|

series=Vorbereitungen|

name=KDE4 aus dem Quellcode bauen|

pre=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]|

next=[[../../Set_up_KDE_4_for_development|Set up KDE 4 for development]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: The KDE From Subversion Build Tool] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]] [[../KDE4/FreeBSD|FreeBSD notes]] [[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Übersicht ==

Diese Anleitung zeigt einen Weg, um KDE auf Linux und BSD-Systemen
zu komplieren und laufen zu lassen. Als Grundlage verwenden wir die Shell.
Wenn Sie sich für andere Systeme wie etwa Solaris, MacOS oder Microsoft Windows ersetzen, besuchen Sie bitte [[../|Build]] und folgen Sie den
Links am Ende der Seite.

{{warning|Stellen Sie sich auf verstärkt auftretende Buildprobleme '''an Montagen''' ein, da die Entwickler an diesem Wochentag kritische Änderungen vornehmen. Das [http://developer.kde.org/~dirk/dashboard/ Dashboard] zeigt unerwartete Probleme beim Kompilieren an.
}}

== Benötigte Software ==

Folgendes muss installiert sein, um dieses Tutorial erfolgreich durchführen zu können:
* gcc and g++ from the gcc project, preferably version 4.1 or higher
* svn, the subversion revision control client
* pkg-config
* development libraries and headers for X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 and libxslt
* the <tt>makeobj</tt> script, which is part of kdesdk. You can install it as part of kdesdk (kdesdk-scripts on Debian) or similar package, or just download it itself from [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* the [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info package], which is the freedesktop MIME standard KDE is using now
* [http://boost.org/ boost], needed by kdebase; after compiling and/or installing boost, in order to make cmake aware about its location (FindBoost), add boost directory (the one containing include subdirectory) to CMAKE_INCLUDE_PATH or set an environment variable called BOOST_ROOT pointing to boost directory.

Weiterhin ist es zu empfehlen, folgende Software bereits installiert zu haben:
* bash

=== Kubuntu ===

In Kubuntu 7.04 (Feisty) kann alle zum Bau der Pakete benötigte Software mit folgendem Befehl installiert werden:
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake libungif4-dev \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng-dev libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen
</code>

Die manuelle Installation von Qt 4.3, CMake 2.4.6 und DBus kann durch die Installation der folgenden Pakete und ihrer Abhängigkeiten vermieden werden:
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Für eine voll funktionstüchtige [[apidox]] Umgebung wird ebenfalls zusätzliche Software benötigt:
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===
{{note|
Der openSUSE build service stellt ebenfalls tagesaktuelle KDE-4-Pakete bereit, die das gesamte auf dieser Seite beschriebene Vorgehen überflüssig machen. Weitere Informationen findet man direkt im openSUSE wiki unter [http://de.opensuse.org/KDE4 KDE4].
}}

In OpenSuse können Pakete mit Hilfe von [http://de.opensuse.org/Zypper Zypper] installiert werden:
<code bash>
sudo zypper install <package-name>
</code>

In älteren SUSE-Versionen geht dies nur mit Yast:
<code bash>
yast2 -i <packagename>
</code>

Die meisten zum Bau von KDE 4 nötigen Pakete sind:
<code bash>
xorg-x11-devel, libxml2-devel, kdesdk3, clucene-core-devel, libjpeg-devel, liblrdf-devel, libpng-devel, libxslt-devel, Mesa-devel, giflib-devel, subversion, gcc, gcc-c++
</code>

Bereits vorkompilierte CMake-Pakete für openSUSE sind direkt verfügbar im [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

== Ein Benutzer für die KDE 4 Entwicklung ==

{{Note|
Einige Menschen ziehen es vor, für KDE 4 einen separaten Nutzer-Account einzurichten, um nicht aus Versehen durch noch bestehende Bugs oder ähnliches Daten zu verlieren. Die Anleitung hier basiert auf der Herangehensweise.

Es ist jedoch deutlich effizienter alles mit einem einzigen Nutzer-Account zu machen. Unter [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] findet man mehr Details dazu.

In diesem Fall ist die folgende Anleitung noch immer gültig, jedoch sollten die nötigen Umgebungsvariablen nicht in die <tt>.bashrc</tt>, sondern in eine separate Datei geschrieben werden, die dann bei Bedarf eingelesen wird.
}}

=== Option 1: Kommandozeile ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2: Über KControl ===

Anstatt der oben genannten Befehle kann man auch mit Hilfe des Nutzer-Moduls des KDE Control Centers (kcontrol) einen weiteren Nutzer einrichten.

=== Einrichten der Entwicklungsumgebung ===

Kopieren Sie die Datei {{path|~/.bashrc}} von Ihrem normalen Nutzer-Account zu Ihrem neuen kde-devel-Account. Danach fügen Sie den Inhalt der Seite [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|example .bashrc]] in die Datei {{path|~kde-devel/.bashrc}} ein. Stellen Sie sicher, dass die Zeile <tt>alias make=makeobj</tt> auskommentiert ist falls auf Ihrem System das Programm <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt> nicht verfügbar ist.
Die neue {{path|~/.bashrc}} wird mit folgendem Befehl eingelesen:
<code bash>
source ~/.bashrc
</code>

Nun haben Sie Zugriff auf Befehle wie <tt>cmakekde</tt>, die in dieser Anleitung genutzt werden. Auch wird so sichergestellt, dass alle wichtigen Umgebungsvariablen (z.B. für die Pfadangaben von Qt, KDE und CMake) richtig gesetzt sind.

Für weitere Informationen lesen Sie bitte [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Zum neuen Benutzer wechseln ===

Sie können sich nun als Benutzer kde-devel anmelden (der Bindestrich ist wichtig!):
<code bash>
su - kde-devel
</code>

Der Rest dieser Anleitung geht davon aus, dass Sie alle Befehle als <tt>kde-devel</tt> ausführen.

== Die Shell des Entwicklungsbenutzers ==
Auf manchen Systemen nutzen neue Benutzer standardmäßig {{path|/bin/sh}}. Wenn dies auf Ihrem System nicht der Fall ist, können Sie diesen Abschnitt überspringen. {{path|/bin/sh}} zu nuzten kann sich als sehr unangenehm erweisen. Daher sollten Sie erwägen, zu {{path|/bin/bash}} oder einer anderen Shell zu wechseln.

=== Option 1: Als kde-devel-Benutzer ===
Wenn Sie keine root-Privilegien haben und Ihr System das Wechseln der eigenen Shell mittels <tt>chsh</tt> unterstützt, können Sie versuchen, Ihre Shell zu {{path|/bin/bash}} zu wechseln, indem Sie Folgendes eingeben:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2: Als root-Benutzer ===
Wenn Ihr System die Anwendung <tt>usermod</tt> beinhaltet, können Sie den folgenden Befehl als root-Benuzter eingeben: <tt>usermod -s /bin/bash</tt>.

Eine weitere Möglichkeit ist die Nutzung der Anwendung <tt>vipw</tt> als root-Benuzter, um auf sichere Art {{path|/etc/passwd}} zu editieren. Machen Sie 'kde-devel' in dieser Datei ausfindig und ändern Sie '{{path|/bin/sh}}' am Zeilenende in '{{path|/bin/bash}}'. Speichern Sie die Änderungen und beenden Sie die Anwendung.

Die neue Shell wird automatisch gestartet wenn Sie sich wieder als kde-devel-Benutzer einloggen.

== D-Bus ==
QtDBus und KDE arbeiten mit den D-Bus-Versionen 0.6.2, 0.92 und höher zusammen. Die Versionen 0.60 und 0.61 funktionieren eventuell auch, sind aber ungetestet. Die Versionen 0.90 und 0.91 funktionieren definitiv nicht.

Wir empfehlen, dass sie eine aktuelle, stabile Version, also größer Version 1.0, benutzen, wenigstens aber Version 0.94.

Wenn Sie eine aktuelle D-Bus-Version auf ihrem System bereits installiert haben oder Ihre D-Bus-Version nicht aktualisieren wollen, können Sie die nächste Sektion überspringen.

Bevor Sie die nächsten Schritte durchgehen sollten Sie sicherstellen, dass die X11-header und -Bibliotheken installiert sind. Das Konfigurations-Skript sollte folgende Ausgabe ergeben:
Building X11 code: yes

=== Das Kochrezept ===

{{tip|Stellen Sie sicher, dass Ihre Umgebung [[Getting_Started/Build/KDE4#Setting_up_the_environment|wie beschrieben]] eingerichtet wurde. Das ist wichtig für das Funktionieren der <tt>cs</tt>- und <tt>cb</tt>-Befehle.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' ist eine Bash-Funktion, klicken Sie hier, um mehr darüber zu lernen]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=$KDEDIR/var
make
make install
dbus-uuidgen --ensure

=== Was hier passiert ===
Wir wechseln in Zeile 1 in das Quellen-Verzeichnis, laden in Zeile 2 den Quellcode von freedesktop.org herunter und entpacken den in Zeile 3.
In Zeile 4 wechseln wir in das neu erschaffene Verzeichnis, und bereiten in Zeile 5 das Kompilieren der Quelldateien vor. Zeile 6 setzt den Kompilier-Vorgang in Gang, Zeile 7 installiert D-Bus, und in Zeile 8 benutzen wir das <tt>dbus-uuidgen</tt>-Werkzeug, um eine Maschinen-Identifikation zu installieren. Das erlaubt dem bus, atuomatisch mit der Desktop-Sitzung zu starten.

Achten Sie darauf, dass Sie Schreibrechte auf {{path|/var}} haben, da Sie die benötigen für die letzten beiden Schritte. Falls Ihr System kein Sudo-Kommando unterstützt, können Sie auch <tt>su</tt> benutzen, z.B. <tt>su -c "make install"</tt>.

=== Fehlerbehebung ===

Falls Sie die Fehlermeldung '''makeobj: command not found''' bekommen fehlt Ihnen <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Skip this if you have [http://cmake.org/ CMake] >=2.4.5 installed.
You should be able to directly use the binary packages available on the [http://www.cmake.org/HTML/Download.html CMake site]. There are also distribution specific packages available.

=== Das Kochrezept ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click Here to learn more]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== Was hier passiert ===
First, we go back to the <tt>kde-devel</tt> user's source directory (line 1), get the CMake sources (line 2) and unpack them (line 3). We create a directory to build CMake in (line 4) and go into it (line 5). We then run the CMake bootstrap script to set up the CMake build (line 6), then make (line 7) and install it (line 8) using the root user.

If your system does not have the <tt>sudo</tt> command, you can instead do <tt>su -c "make install"</tt>.

== Qt ==
Next we need to get the Qt4 that is in KDE's source repository. KDE is guaranteed to build against any Qt 4.3. Qt 4.2 and earlier are not supported and will not work. Qt 4.3 has been released only recently, so your distribution probably doesn't have packages for it yet (known exceptions: Kubuntu, openSUSE). You should use the copy in the KDE Subversion servers.

=== Das Kochrezept ===
cd
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -qdbus -pch -nomake examples \
-nomake demos
make -j2
# make install: only if QTDIR is not the current directory!
make install

=== Was hier passiert ===
We switch back to the <tt>kde-devel</tt> user's home directory (line 1) and download the source code using subversion (svn) from KDE's repository (line 2). After changing into the resulting {{path|qt-copy}} directory (line 3), we run a script that manages the patches that come with <tt>qt-copy</tt> (line 4).

Once the patches have been applied, we then set up the build using the <tt>configure</tt> script (line 5-7). The various command line options used are explained in the {{path|qt-copy/README.qt-copy}} file. Finally, we build the minimal requirements for KDE (line 8) and install (line 9-10) Qt. If you want all the example and demo applications, you can either build them individually or simply do a <tt>make</tt> from the {{path|qt-copy}} directory.

Note that the installation does not require root as it installs Qt locally into {{path|$QTDIR}}. Anyway, installation is only needed if {{path|$QTDIR}} differs from {{path|$HOME/qt-copy}}, which is not the case if you have exactly followed the instructions.

=== Fehlerbebung ===

If you get "error: X11/Xlib.h: No such file or directory", install the devel package of <tt>xorg</tt> (the actual name may vary between operating systems, for example it is <tt>xorg-dev</tt> on Ubuntu based systems such as Kubuntu).

If you get an error in the configure step about missing defines, check the value of <tt>$QMAKESPEC</tt>. Some distributions set this to point directly to the system-installed Qt. If <tt>unset QMAKESPEC</tt> solves the problem, you probably want to add it to the <tt>~/.bashrc</tt> script.

If you get an error ".pch/debug-shared/QtCore", this is because Qt-4.3 enables precompiled headers if your gcc supports it, but for some reason it doesn't work for you. If you use distcc, configure qt with -no-pch. If you use icecream, update to the latest icecream from svn trunk.

Try running any Qt program, like {{program|assistant}}. If it crashes in QSpanData::adjustSpanMethods, then your problem is the oxygen style. Try removing {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} and {{path|lib/kde4/plugins/styles/oxygen.so}} if they exist in the KDE install prefix.

== Strigi ==

{{warning|Wenn Sie diesen Abschnitt erreicht haben, ohne [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]] zu lesen, '''werden die hier angebotenen Rezepte nicht funktionieren'''. Diese Rezepte sind nicht defekt; <tt>cs</tt> und <tt>cb</tt> sind keine Tippfehler. Ihre Umgebung '''muss''' korrekt eingerichtet sein, damit diese Instruktionen funktionieren.}}

Der Code zum Erhalten der Dateimetadaten ist nun von Strigi abhängig. Um Strigi zu installieren, benötigen Sie die Bibliotheken und header von libz, libbz2, openssl (libcrypto oder libssl), libclucene (=0.9.16; Version 0.9.17 funktioniert '''nicht'''), und entweder libxml2 oder libexpat.

=== Das Kochrezept ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/strigi
cd strigi
cmakekde

=== Was hier passiert ===
Wir wechseln in das Quellverzeichnis (Zeile 1), laden den Quellcode für Strigi mittels subversion herunter (Zeile 2) und wechseln anschließend in das neue {{path|~/src/strigi}} Verzeichnis (Zeile 3). Dann starten wir die Kompilierung (Zeile 4). Wir finden uns im Anschluss an die Kompilierung im build-Verzeichnis von Strigi wieder.

=== Fehlerbehebung ===
Wenn Sie
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
erhalten, sollten Sie das devel-Paket für libxml2 installieren.

== Soprano ==

{{warning|Wenn Sie diesen Abschnitt erreicht haben, ohne [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]] zu lesen, '''werden die hier angebotenen Rezepte nicht funktionieren'''. Diese Rezepte sind nicht defekt; <tt>cs</tt> und <tt>cb</tt> sind keine Tippfehler. Ihre Umgebung '''muss''' korrekt eingerichtet sein, damit diese Instruktionen funktionieren.}}

Der Code zum Erhalten von kmetadata für Dateien ist von Soprano abhängig. Um Soprano zu installieren benötigen Sie die Bibliotheken und header von librdf.

=== Das Kochrezept ===

cd $KDE_SRC
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/soprano
cd soprano
cmakekde

=== Was hier passiert ===
Wir wechseln in das Quellverzeichnis (Zeile 1), laden den Quellcode für Soprano mittels subversion herunter (Zeile 2) und wechseln anschließend in das neue {{path|~/src/soprano}} Verzeichnis (Zeile 3). Dann starten wir die Kompilierung (Zeile 4). Wir finden uns im Anschluss an die Kompilierung im build-Verzeichnis von Soprano wieder.

=== Fehlerbebung ===
Wenn Sie
CMake Error: Could NOT find REDLAND
erhalten, benötigen Sie librdf aus den Redland-Bibliotheken.
Wenn Ihre Distribution das librdf Paket nicht zur Verfügung stellt, können Sie dessen Quellcode hier herunterladen [http://download.librdf.org/source/ http://download.librdf.org/source/] und selbst kompilieren. In Gentoo wird das Paket 'redland' anstatt librdf genannt.

== kdelibs ==

With Qt4 and Strigi built, we can now move on to building KDE's base libraries. If you use the aforementioned [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] this is where those new functions come in handy.

=== Das Kochrezept ===


cd $KDE_SRC
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Was hier passiert ===
We change to the base source directory (line 1) then make and go into the KDE directory (line 2). We download the sources for kdelibs using subversion (line 3), go into the new {{path|~/src/KDE/kdelibs}} directory (line 4), and commence the build (line 5). This will leave us in the <tt>kdelibs</tt> build directory after the build is completed.

{{tip|There might be missing dependencies on your system! They are easily overlooked in the output of <tt>cmakekde</tt>.
You might want to do a <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> prior to compiling any kde modules (like kdelibs, kdepimlibs etc.)}}

=== Additional KDE-specific CMake modules ===
There are additional CMake modules in {{path|kdelibs/cmake/modules/}} that are necessary for building KDE4 applications. These will be installed for you when kdelibs itself is installed.

=== Fehlerbebung ===

If you have problems compiling kdelibs, first make sure the software in the [[Getting_Started/Build/KDE4#Required_Software|Required Software]] section above is installed and works. Other possible hints include:
* If the <tt>cmakekde</tt> command fails stating that CMake requires an out of source build directory, remove {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and try again.

If <tt>cmakekde</tt> still gives the same error then try this
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install
* If you received an error stating "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", then you need to change to your build directory before running cmakekde. (e.g <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* If Qt wasn't found or the wrong version of Qt was found, make sure that the qmake from the Qt you need is the first qmake in the path.
* If the problems persist, try the CMake make-option <tt>--keep-going</tt>.
* Here you need the libungif library, otherwise you will get an error message like "<tt>Could NOT find GIF</tt>".
* Qt-4.3 upgrade: if you get a link error in kjsembed talking about QScriptEngine, edit CMakeCache.txt in kdelibs and remove the lines that talk about QT_QTUITOOLS_LIBRARY, then type make again (that static library has a new dependency, and the cmake code that adds it needs to run).
* if you get <code>CMake Error: KDE Requires Qt to be built with SSL support
</code>, install openssl-devel, and re-compile QT.

== kdepimlibs ==
Sie müssen ''kdepimlibs'' nach <tt>kdelibs</tt>, aber vor ''kdebase'' installieren.

=== Das Kochrezept ===


cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Was hier passiert ===
Wir wechseln in das KDE Quellverzeichnis (Zeile 1), laden den Quellcode für kdepimlibs mittels subversion herunter (Zeile 2) und wechseln anschließend in das neue {{path|~/src/KDE/kdepimlibs}} Verzeichnis (Zeile 3). Dann starten wir die Kompilierung (Zeile 4). Wir finden uns im Anschluss an die Kompilierung im build-Verzeichnis von <tt>kdepimlibs</tt> wieder.

== kdebase ==
Für manche kioslaves mag kdebase benötigt werden.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Fehlerbebung ===

Wenn Sie Schwierigkeiten beim Kompilieren von kdebase haben:
* Stellen Sie sicher, dass die <tt>libxss header</tt> installiert sind. (Sollten diese header nicht installiert sein, erhalten Sie in der Regel undefinierte Verweise auf xscreensaver Objekte.)
* <tt>which meinproc</tt> muss {{path|/home/kde-devel/kde/bin/meinproc}} ausgeben.
* Wenn cmakekde das kdepimlibs-Verzeichnis nicht finden kann, editieren Sie die Datei {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} und definieren Sie <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt> manuell.
* Wenn Sie die Fehlerausgabe "Please set the following variables: X11_XTest_LIB (ADVANCED)" erhalten, installieren Sie das devel Paket von <tt>Xtst</tt>. Auf manchen Systemen ist es separat von <tt>xext</tt> gepackt und <tt>x11proto-xext-dev</tt> oder <tt>libxtst-dev</tt> benannt. Sie müssen eventuell außerdem nach der Installation dieses Paketes die Datei CMakeCache.txt im build Verzeichnis löschen.
* Dasselbe gilt für die analoge Fehlerausgabe betreffend der Variable "X11_Xinerama_LIB (ADVANCED)": Sie benötigen das devel Paket für <tt>xinerama</tt>.
* Wenn Sie die Fehlerausgabe "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)" erhalten, müssen Sie die libfontconfig header installieren.
* Wenn Sie die Fehlerausgabe "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES" erhalten, müssen Sie soprano aus kdesupport installieren und dann kdelibs neu kompilieren.
* Wenn Sie die Fehlerausgabe "‘XserverRegion’ does not name a type" erhalten, stellen Sie sicher, dass Sie die libxcomposite header installiert haben. (In Ubuntu werden sie <tt>libxcomposite-dev</tt> genannt.)

== Lokale API-Dokumentation erstellen ==

Obwohl die API-Dokumentation für KDE online unter [http://api.kde.org api.kde.org] verfügbar ist, kann es hilfreich sein, sie offline verfügbar zu haben, zum Beispiel wenn Sie [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] zum Durchsuchen der Dokumentation nutzen oder wenn Sie nicht ständig online sein können.

Seien Sie sich bewusst, dass das Generieren der API-Dokumentation mehrere Stunden in Anspruch nehmen kann und knapp einen halben Gigabyte an Speicherplatz benötigt.
Das Generieren wird von einem Skript in {{path|kdelibs/doc/api}} ausgeführt; Sie benötigen <tt>doxygen</tt>, um es ausführen zu können.

Um die API-Dokumentation für kdelibs zu generieren, geben Sie Folgendes ein:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Wiederholen Sie dies nach Bedarf für andere Module.

== Allgemeine Fehlerbehebung ==

Es kann im Laufe der Zeit nach mehrmaligem Ausführen von <tt>svn up</tt> vorkommen, dass sich das Ausgabeformat einiger Werkzeuge, die in der KDE Werkzeugkette benutzt werden, ändert. Zum Beispiel werden <tt>kcfg</tt> Dateien vom <tt>kconfig_compiler</tt> gelesen, um die Konfigurationsdialoge zu generieren. Da CMake diese Veränderungen nicht erkennen kann, kann das Kompilieren fehlschlagen. Eine provisorische Lösung ist, die Regenerierung all dieser Dateien zu erzwingen:
find $KDE_SRC/kde/kdebase -name "*.kcfg" | xargs touch
Dasselbe gilt für <tt>ui</tt> Dateien wie solche, die vom Qt designer generiert werden.

== Das wars! ==

Sie sind nun bereit, andere svn Module in derselben Weise wie kdebase zu kompilieren, KDE4 zu benutzen und zu testen, sowie Ihre eigenen Patches und Anwendungen zu schreiben.

Siehe auch die Anleitung [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] um Hilfe beim Starten von KDE4 Anwendungen sowie zur Nutzung von KDevelop zu erhalten.

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4 (de)

2007-06-05T01:07:15Z

Liquidat: Frage: Wie ist "run on line 5" gemeint?

{{Template:I18n_Getting_Started_Build_KDE4}}

(Diese Anleitung befindet sich noch im Aufbau und ist eine Kopie des [[Getting_Started/Build/KDE4|englischen Orginals]]. Hilf mit, es zu übersetzen und es auf dem aktuellen Stand zu halten!)

{{TutorialBrowser|

series=Vorbereitungen|

name=KDE4 aus dem Quellcode bauen|

pre=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]|

next=[[../../Set_up_KDE_4_for_development|Set up KDE 4 for development]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: The KDE From Subversion Build Tool] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]] [[../KDE4/FreeBSD|FreeBSD notes]] [[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Übersicht ==

Diese Anleitung zeigt einen Weg, um KDE auf Linux und BSD-Systemen
zu komplieren und laufen zu lassen. Als Grundlage verwenden wir die Shell.
Wenn Sie sich für andere Systeme wie etwa Solaris, MacOS oder Microsoft Windows ersetzen, besuchen Sie bitte [[../|Build]] und folgen Sie den
Links am Ende der Seite.

{{warning|Stellen Sie sich auf verstärkt auftretende Buildprobleme '''an Montagen''' ein, da die Entwickler an diesem Wochentag kritische Änderungen vornehmen. Das [http://developer.kde.org/~dirk/dashboard/ Dashboard] zeigt unerwartete Probleme beim Kompilieren an.
}}

== Benötigte Software ==

Folgendes muss installiert sein, um dieses Tutorial erfolgreich durchführen zu können:
* gcc and g++ from the gcc project, preferably version 4.1 or higher
* svn, the subversion revision control client
* pkg-config
* development libraries and headers for X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 and libxslt
* the <tt>makeobj</tt> script, which is part of kdesdk. You can install it as part of kdesdk (kdesdk-scripts on Debian) or similar package, or just download it itself from [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* the [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info package], which is the freedesktop MIME standard KDE is using now
* [http://boost.org/ boost], needed by kdebase; after compiling and/or installing boost, in order to make cmake aware about its location (FindBoost), add boost directory (the one containing include subdirectory) to CMAKE_INCLUDE_PATH or set an environment variable called BOOST_ROOT pointing to boost directory.

Weiterhin ist es zu empfehlen, folgende Software bereits installiert zu haben:
* bash

=== Kubuntu ===

In Kubuntu 7.04 (Feisty) kann alle zum Bau der Pakete benötigte Software mit folgendem Befehl installiert werden:
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake libungif4-dev \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng-dev libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen
</code>

Die manuelle Installation von Qt 4.3, CMake 2.4.6 und DBus kann durch die Installation der folgenden Pakete und ihrer Abhängigkeiten vermieden werden:
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Für eine voll funktionstüchtige [[apidox]] Umgebung wird ebenfalls zusätzliche Software benötigt:
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===
{{note|
Der openSUSE build service stellt ebenfalls tagesaktuelle KDE-4-Pakete bereit, die das gesamte auf dieser Seite beschriebene Vorgehen überflüssig machen. Weitere Informationen findet man direkt im openSUSE wiki unter [http://de.opensuse.org/KDE4 KDE4].
}}

In OpenSuse können Pakete mit Hilfe von [http://de.opensuse.org/Zypper Zypper] installiert werden:
<code bash>
sudo zypper install <package-name>
</code>

In älteren SUSE-Versionen geht dies nur mit Yast:
<code bash>
yast2 -i <packagename>
</code>

Die meisten zum Bau von KDE 4 nötigen Pakete sind:
<code bash>
xorg-x11-devel, libxml2-devel, kdesdk3, clucene-core-devel, libjpeg-devel, liblrdf-devel, libpng-devel, libxslt-devel, Mesa-devel, giflib-devel, subversion, gcc, gcc-c++
</code>

Bereits vorkompilierte CMake-Pakete für openSUSE sind direkt verfügbar im [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

== Ein Benutzer für die KDE 4 Entwicklung ==

{{Note|
Einige Menschen ziehen es vor, für KDE 4 einen separaten Nutzer-Account einzurichten, um nicht aus Versehen durch noch bestehende Bugs oder ähnliches Daten zu verlieren. Die Anleitung hier basiert auf der Herangehensweise.

Es ist jedoch deutlich effizienter alles mit einem einzigen Nutzer-Account zu machen. Unter [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] findet man mehr Details dazu.

In diesem Fall ist die folgende Anleitung noch immer gültig, jedoch sollten die nötigen Umgebungsvariablen nicht in die <tt>.bashrc</tt>, sondern in eine separate Datei geschrieben werden, die dann bei Bedarf eingelesen wird.
}}

=== Option 1: Kommandozeile ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2: Über KControl ===

Anstatt der oben genannten Befehle kann man auch mit Hilfe des Nutzer-Moduls des KDE Control Centers (kcontrol) einen weiteren Nutzer einrichten.

=== Einrichten der Entwicklungsumgebung ===

Kopieren Sie die Datei {{path|~/.bashrc}} von Ihrem normalen Nutzer-Account zu Ihrem neuen kde-devel-Account. Danach fügen Sie den Inhalt der Seite [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|example .bashrc]] in die Datei {{path|~kde-devel/.bashrc}} ein. Stellen Sie sicher, dass die Zeile <tt>alias make=makeobj</tt> auskommentiert ist falls auf Ihrem System das Programm <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt> nicht verfügbar ist.
Die neue {{path|~/.bashrc}} wird mit folgendem Befehl eingelesen:
<code bash>
source ~/.bashrc
</code>

Nun haben Sie Zugriff auf Befehle wie <tt>cmakekde</tt>, die in dieser Anleitung genutzt werden. Auch wird so sichergestellt, dass alle wichtigen Umgebungsvariablen (z.B. für die Pfadangaben von Qt, KDE und CMake) richtig gesetzt sind.

Für weitere Informationen lesen Sie bitte [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Zum neuen Benutzer wechseln ===

Sie können sich nun als Benutzer kde-devel anmelden (der Bindestrich ist wichtig!):
<code bash>
su - kde-devel
</code>

Der Rest dieser Anleitung geht davon aus, dass Sie alle Befehle als <tt>kde-devel</tt> ausführen.

== Die Shell des Entwicklungsbenutzers ==
Auf manchen Systemen nutzen neue Benutzer standardmäßig {{path|/bin/sh}}. Wenn dies auf Ihrem System nicht der Fall ist, können Sie diesen Abschnitt überspringen. {{path|/bin/sh}} zu nuzten kann sich als sehr unangenehm erweisen. Daher sollten Sie erwägen, zu {{path|/bin/bash}} oder einer anderen Shell zu wechseln.

=== Option 1: Als kde-devel-Benutzer ===
Wenn Sie keine root-Privilegien haben und Ihr System das Wechseln der eigenen Shell mittels <tt>chsh</tt> unterstützt, können Sie versuchen, Ihre Shell zu {{path|/bin/bash}} zu wechseln, indem Sie Folgendes eingeben:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2: Als root-Benutzer ===
Wenn Ihr System die Anwendung <tt>usermod</tt> beinhaltet, können Sie den folgenden Befehl als root-Benuzter eingeben: <tt>usermod -s /bin/bash</tt>.

Eine weitere Möglichkeit ist die Nutzung der Anwendung <tt>vipw</tt> als root-Benuzter, um auf sichere Art {{path|/etc/passwd}} zu editieren. Machen Sie 'kde-devel' in dieser Datei ausfindig und ändern Sie '{{path|/bin/sh}}' am Zeilenende in '{{path|/bin/bash}}'. Speichern Sie die Änderungen und beenden Sie die Anwendung.

Die neue Shell wird automatisch gestartet wenn Sie sich wieder als kde-devel-Benutzer einloggen.

== D-Bus ==
QtDBus und KDE arbeiten mit den D-Bus-Versionen 0.6.2, 0.92 und höher zusammen. Die Versionen 0.60 und 0.61 funktionieren eventuell auch, sind aber ungetestet. Die Versionen 0.90 und 0.91 funktionieren definitiv nicht.

Wir empfehlen, dass sie eine aktuelle, stabile Version, also größer Version 1.0, benutzen, wenigstens aber Version 0.94.

Wenn Sie eine aktuelle D-Bus-Version auf ihrem System bereits installiert haben oder Ihre D-Bus-Version nicht aktualisieren wollen, können Sie die nächste Sektion überspringen.

Bevor Sie die nächsten Schritte durchgehen sollten Sie sicherstellen, dass die X11-header und -Bibliotheken installiert sind. Das Konfigurations-Skript sollte folgende Ausgabe ergeben:
Building X11 code: yes

=== Das Kochrezept ===

{{tip|Make sure you did set up your environment correctly as described [[Getting_Started/Build/KDE4#Setting_up_the_environment|above]]. This is necessary for the <tt>cs</tt> and <tt>cb</tt> functions to work.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=$KDEDIR/var
make
make install
dbus-uuidgen --ensure

=== Was hier passiert ===
After changing into the source directory (line 1), D-Bus source code is downloaded from freedesktop.org (line 2) and unpacked (line 3). After going into the newly created D-Bus directory (line 4), the build is set up using the supplied {{path|configure}} script (line 5). After building (line 6) and installing (line 7) D-Bus, we use the <tt>dbus-uuidgen</tt> tool to install a machine identification file that allows the bus to start automatically when the desktop session starts (line 8).

Note that you need write access to {{path|/var}} for the last two steps. If your system does not have the sudo command, you can use the <tt>su</tt> command instead, e.g. <tt>su -c "make install"</tt>.

=== Fehlerbehebung ===

If you get the error '''makeobj: command not found''' you are lacking the command <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Skip this if you have [http://cmake.org/ CMake] >=2.4.5 installed.
You should be able to directly use the binary packages available on the [http://www.cmake.org/HTML/Download.html CMake site]. There are also distribution specific packages available.

=== Das Kochrezept ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click Here to learn more]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== Was hier passiert ===
First, we go back to the <tt>kde-devel</tt> user's source directory (line 1), get the CMake sources (line 2) and unpack them (line 3). We create a directory to build CMake in (line 4) and go into it (line 5). We then run the CMake bootstrap script to set up the CMake build (line 6), then make (line 7) and install it (line 8) using the root user.

If your system does not have the <tt>sudo</tt> command, you can instead do <tt>su -c "make install"</tt>.

== Qt ==
Next we need to get the Qt4 that is in KDE's source repository. KDE is guaranteed to build against any Qt 4.3. Qt 4.2 and earlier are not supported and will not work. Qt 4.3 has been released only recently, so your distribution probably doesn't have packages for it yet (known exceptions: Kubuntu, openSUSE). You should use the copy in the KDE Subversion servers.

=== Das Kochrezept ===
cd
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -qdbus -pch -nomake examples \
-nomake demos
make -j2
# make install: only if QTDIR is not the current directory!
make install

=== Was hier passiert ===
We switch back to the <tt>kde-devel</tt> user's home directory (line 1) and download the source code using subversion (svn) from KDE's repository (line 2). After changing into the resulting {{path|qt-copy}} directory (line 3), we run a script that manages the patches that come with <tt>qt-copy</tt> (line 4).

Once the patches have been applied, we then set up the build using the <tt>configure</tt> script (line 5-7). The various command line options used are explained in the {{path|qt-copy/README.qt-copy}} file. Finally, we build the minimal requirements for KDE (line 8) and install (line 9-10) Qt. If you want all the example and demo applications, you can either build them individually or simply do a <tt>make</tt> from the {{path|qt-copy}} directory.

Note that the installation does not require root as it installs Qt locally into {{path|$QTDIR}}. Anyway, installation is only needed if {{path|$QTDIR}} differs from {{path|$HOME/qt-copy}}, which is not the case if you have exactly followed the instructions.

=== Fehlerbebung ===

If you get "error: X11/Xlib.h: No such file or directory", install the devel package of <tt>xorg</tt> (the actual name may vary between operating systems, for example it is <tt>xorg-dev</tt> on Ubuntu based systems such as Kubuntu).

If you get an error in the configure step about missing defines, check the value of <tt>$QMAKESPEC</tt>. Some distributions set this to point directly to the system-installed Qt. If <tt>unset QMAKESPEC</tt> solves the problem, you probably want to add it to the <tt>~/.bashrc</tt> script.

If you get an error ".pch/debug-shared/QtCore", this is because Qt-4.3 enables precompiled headers if your gcc supports it, but for some reason it doesn't work for you. If you use distcc, configure qt with -no-pch. If you use icecream, update to the latest icecream from svn trunk.

Try running any Qt program, like {{program|assistant}}. If it crashes in QSpanData::adjustSpanMethods, then your problem is the oxygen style. Try removing {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} and {{path|lib/kde4/plugins/styles/oxygen.so}} if they exist in the KDE install prefix.

== Strigi ==

{{warning|Wenn Sie diesen Abschnitt erreicht haben, ohne [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]] zu lesen, '''werden die hier angebotenen Rezepte nicht funktionieren'''. Diese Rezepte sind nicht defekt; <tt>cs</tt> und <tt>cb</tt> sind keine Tippfehler. Ihre Umgebung '''muss''' korrekt eingerichtet sein, damit diese Instruktionen funktionieren.}}

Der Code zum Erhalten der Dateimetadaten ist nun von Strigi abhängig. Um Strigi zu installieren, benötigen Sie die Bibliotheken und header von libz, libbz2, openssl (libcrypto oder libssl), libclucene (=0.9.16; Version 0.9.17 funktioniert '''nicht'''), und entweder libxml2 oder libexpat.

=== Das Kochrezept ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/strigi
cd strigi
cmakekde

=== Was hier passiert ===
Wir wechseln in das Quellverzeichnis (Zeile 1), laden den Quellcode für Strigi mittels subversion herunter (Zeile 2) und wechseln anschließend in das neue {{path|~/src/strigi}} Verzeichnis (Zeile 3). Dann starten wir die Kompilierung (Zeile 4). Wir finden uns im Anschluss an die Kompilierung im build-Verzeichnis von Strigi wieder.

=== Fehlerbehebung ===
Wenn Sie
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
erhalten, sollten Sie das devel-Paket für libxml2 installieren.

== Soprano ==

{{warning|Wenn Sie diesen Abschnitt erreicht haben, ohne [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]] zu lesen, '''werden die hier angebotenen Rezepte nicht funktionieren'''. Diese Rezepte sind nicht defekt; <tt>cs</tt> und <tt>cb</tt> sind keine Tippfehler. Ihre Umgebung '''muss''' korrekt eingerichtet sein, damit diese Instruktionen funktionieren.}}

Der Code zum Erhalten von kmetadata für Dateien ist von Soprano abhängig. Um Soprano zu installieren benötigen Sie die Bibliotheken und header von librdf.

=== Das Kochrezept ===

cd $KDE_SRC
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/soprano
cd soprano
cmakekde

=== Was hier passiert ===
Wir wechseln in das Quellverzeichnis (Zeile 1), laden den Quellcode für Soprano mittels subversion herunter (Zeile 2) und wechseln anschließend in das neue {{path|~/src/soprano}} Verzeichnis (Zeile 3). Dann starten wir die Kompilierung (Zeile 4). Wir finden uns im Anschluss an die Kompilierung im build-Verzeichnis von Soprano wieder.

=== Fehlerbebung ===
Wenn Sie
CMake Error: Could NOT find REDLAND
erhalten, benötigen Sie librdf aus den Redland-Bibliotheken.
Wenn Ihre Distribution das librdf Paket nicht zur Verfügung stellt, können Sie dessen Quellcode hier herunterladen [http://download.librdf.org/source/ http://download.librdf.org/source/] und selbst kompilieren. In Gentoo wird das Paket 'redland' anstatt librdf genannt.

== kdelibs ==

With Qt4 and Strigi built, we can now move on to building KDE's base libraries. If you use the aforementioned [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] this is where those new functions come in handy.

=== Das Kochrezept ===


cd $KDE_SRC
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Was hier passiert ===
We change to the base source directory (line 1) then make and go into the KDE directory (line 2). We download the sources for kdelibs using subversion (line 3), go into the new {{path|~/src/KDE/kdelibs}} directory (line 4), and commence the build (line 5). This will leave us in the <tt>kdelibs</tt> build directory after the build is completed.

{{tip|There might be missing dependencies on your system! They are easily overlooked in the output of <tt>cmakekde</tt>.
You might want to do a <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> prior to compiling any kde modules (like kdelibs, kdepimlibs etc.)}}

=== Additional KDE-specific CMake modules ===
There are additional CMake modules in {{path|kdelibs/cmake/modules/}} that are necessary for building KDE4 applications. These will be installed for you when kdelibs itself is installed.

=== Fehlerbebung ===

If you have problems compiling kdelibs, first make sure the software in the [[Getting_Started/Build/KDE4#Required_Software|Required Software]] section above is installed and works. Other possible hints include:
* If the <tt>cmakekde</tt> command fails stating that CMake requires an out of source build directory, remove {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and try again.

If <tt>cmakekde</tt> still gives the same error then try this
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install
* If you received an error stating "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", then you need to change to your build directory before running cmakekde. (e.g <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* If Qt wasn't found or the wrong version of Qt was found, make sure that the qmake from the Qt you need is the first qmake in the path.
* If the problems persist, try the CMake make-option <tt>--keep-going</tt>.
* Here you need the libungif library, otherwise you will get an error message like "<tt>Could NOT find GIF</tt>".
* Qt-4.3 upgrade: if you get a link error in kjsembed talking about QScriptEngine, edit CMakeCache.txt in kdelibs and remove the lines that talk about QT_QTUITOOLS_LIBRARY, then type make again (that static library has a new dependency, and the cmake code that adds it needs to run).
* if you get <code>CMake Error: KDE Requires Qt to be built with SSL support
</code>, install openssl-devel, and re-compile QT.

== kdepimlibs ==
Sie müssen ''kdepimlibs'' nach <tt>kdelibs</tt>, aber vor ''kdebase'' installieren.

=== Das Kochrezept ===


cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Was hier passiert ===
Wir wechseln in das KDE Quellverzeichnis (Zeile 1), laden den Quellcode für kdepimlibs mittels subversion herunter (Zeile 2) und wechseln anschließend in das neue {{path|~/src/KDE/kdepimlibs}} Verzeichnis (Zeile 3). Dann starten wir die Kompilierung (Zeile 4). Wir finden uns im Anschluss an die Kompilierung im build-Verzeichnis von <tt>kdepimlibs</tt> wieder.

== kdebase ==
Für manche kioslaves mag kdebase benötigt werden.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Fehlerbebung ===

Wenn Sie Schwierigkeiten beim Kompilieren von kdebase haben:
* Stellen Sie sicher, dass die <tt>libxss header</tt> installiert sind. (Sollten diese header nicht installiert sein, erhalten Sie in der Regel undefinierte Verweise auf xscreensaver Objekte.)
* <tt>which meinproc</tt> muss {{path|/home/kde-devel/kde/bin/meinproc}} ausgeben.
* Wenn cmakekde das kdepimlibs-Verzeichnis nicht finden kann, editieren Sie die Datei {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} und definieren Sie <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt> manuell.
* Wenn Sie die Fehlerausgabe "Please set the following variables: X11_XTest_LIB (ADVANCED)" erhalten, installieren Sie das devel Paket von <tt>Xtst</tt>. Auf manchen Systemen ist es separat von <tt>xext</tt> gepackt und <tt>x11proto-xext-dev</tt> oder <tt>libxtst-dev</tt> benannt. Sie müssen eventuell außerdem nach der Installation dieses Paketes die Datei CMakeCache.txt im build Verzeichnis löschen.
* Dasselbe gilt für die analoge Fehlerausgabe betreffend der Variable "X11_Xinerama_LIB (ADVANCED)": Sie benötigen das devel Paket für <tt>xinerama</tt>.
* Wenn Sie die Fehlerausgabe "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)" erhalten, müssen Sie die libfontconfig header installieren.
* Wenn Sie die Fehlerausgabe "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES" erhalten, müssen Sie soprano aus kdesupport installieren und dann kdelibs neu kompilieren.
* Wenn Sie die Fehlerausgabe "‘XserverRegion’ does not name a type" erhalten, stellen Sie sicher, dass Sie die libxcomposite header installiert haben. (In Ubuntu werden sie <tt>libxcomposite-dev</tt> genannt.)

== Lokale API-Dokumentation erstellen ==

Obwohl die API-Dokumentation für KDE online unter [http://api.kde.org api.kde.org] verfügbar ist, kann es hilfreich sein, sie offline verfügbar zu haben, zum Beispiel wenn Sie [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] zum Durchsuchen der Dokumentation nutzen oder wenn Sie nicht ständig online sein können.

Seien Sie sich bewusst, dass das Generieren der API-Dokumentation mehrere Stunden in Anspruch nehmen kann und knapp einen halben Gigabyte an Speicherplatz benötigt.
Das Generieren wird von einem Skript in {{path|kdelibs/doc/api}} ausgeführt; Sie benötigen <tt>doxygen</tt>, um es ausführen zu können.

Um die API-Dokumentation für kdelibs zu generieren, geben Sie Folgendes ein:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Wiederholen Sie dies nach Bedarf für andere Module.

== Allgemeine Fehlerbehebung ==

Es kann im Laufe der Zeit nach mehrmaligem Ausführen von <tt>svn up</tt> vorkommen, dass sich das Ausgabeformat einiger Werkzeuge, die in der KDE Werkzeugkette benutzt werden, ändert. Zum Beispiel werden <tt>kcfg</tt> Dateien vom <tt>kconfig_compiler</tt> gelesen, um die Konfigurationsdialoge zu generieren. Da CMake diese Veränderungen nicht erkennen kann, kann das Kompilieren fehlschlagen. Eine provisorische Lösung ist, die Regenerierung all dieser Dateien zu erzwingen:
find $KDE_SRC/kde/kdebase -name "*.kcfg" | xargs touch
Dasselbe gilt für <tt>ui</tt> Dateien wie solche, die vom Qt designer generiert werden.

== Das wars! ==

Sie sind nun bereit, andere svn Module in derselben Weise wie kdebase zu kompilieren, KDE4 zu benutzen und zu testen, sowie Ihre eigenen Patches und Anwendungen zu schreiben.

Siehe auch die Anleitung [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] um Hilfe beim Starten von KDE4 Anwendungen sowie zur Nutzung von KDevelop zu erhalten.

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4 (de)

2007-06-04T23:24:57Z

Liquidat: /* Ein Benutzer für die KDE 4 Entwicklung */ Wenn es eins gibt, was ich bei solchen Übersetzungen hasse, dann ist es die Übersetzung in die "Sie"-Form statt in die "Du"-Form :(

{{Template:I18n_Getting_Started_Build_KDE4}}

(Diese Anleitung befindet sich noch im Aufbau und ist eine Kopie des [[Getting_Started/Build/KDE4|englischen Orginals]]. Hilf mit, es zu übersetzen und es auf dem aktuellen Stand zu halten!)

{{TutorialBrowser|

series=Vorbereitungen|

name=KDE4 aus dem Quellcode bauen|

pre=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]|

next=[[../../Set_up_KDE_4_for_development|Set up KDE 4 for development]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: The KDE From Subversion Build Tool] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]] [[../KDE4/FreeBSD|FreeBSD notes]] [[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Übersicht ==

Diese Anleitung zeigt einen Weg, um KDE auf Linux und BSD-Systemen
zu komplieren und laufen zu lassen. Als Grundlage verwenden wir die Shell.
Wenn Sie sich für andere Systeme wie etwa Solaris, MacOS oder Microsoft Windows ersetzen, besuchen Sie bitte [[../|Build]] und folgen Sie den
Links am Ende der Seite.

{{warning|Stellen Sie sich auf verstärkt auftretende Buildprobleme '''an Montagen''' ein, da die Entwickler an diesem Wochentag kritische Änderungen vornehmen. Das [http://developer.kde.org/~dirk/dashboard/ Dashboard] zeigt unerwartete Probleme beim Kompilieren an.
}}

== Benötigte Software ==

Folgendes muss installiert sein, um dieses Tutorial erfolgreich durchführen zu können:
* gcc and g++ from the gcc project, preferably version 4.1 or higher
* svn, the subversion revision control client
* pkg-config
* development libraries and headers for X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 and libxslt
* the <tt>makeobj</tt> script, which is part of kdesdk. You can install it as part of kdesdk (kdesdk-scripts on Debian) or similar package, or just download it itself from [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* the [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info package], which is the freedesktop MIME standard KDE is using now
* [http://boost.org/ boost], needed by kdebase; after compiling and/or installing boost, in order to make cmake aware about its location (FindBoost), add boost directory (the one containing include subdirectory) to CMAKE_INCLUDE_PATH or set an environment variable called BOOST_ROOT pointing to boost directory.

Weiterhin ist es zu empfehlen, folgende Software bereits installiert zu haben:
* bash

=== Kubuntu ===

I Kubuntu 7.04 (Feisty) kann alle zum Bau der Pakete benötigte Software mit folgendem Befehl installiert werden:
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake libungif4-dev \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng-dev libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen
</code>

Die manuelle Installation von Qt 4.3, CMake 2.4.6 und DBus kann durch die Installation der folgenden Pakete und ihrer Abhängigkeiten vermieden werden:
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Für eine voll funktionstüchtige [[apidox]] Umgebung wird ebenfalls zusätzliche Software benötigt:
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===
{{note||Der openSUSE build service stellt ebenfalls tagesaktuelle KDE-4-Pakete bereit, die das gesamte auf dieser Seite beschriebene Vorgehen überflüssig machen. Weitere Informationen findet man direkt im openSUSE wiki unter [http://de.opensuse.org/KDE4 KDE4].}}

In OpenSuse können Pakete mit Hilfe von [http://de.opensuse.org/Zypper Zypper] installiert werden:
<code bash>
sudo zypper install <package-name>
</code>

In älteren SUSE-Versionen geht dies nur mit Yast:
<code bash>
yast2 -i <packagename>
</code>

Die meisten zum Bau von KDE 4 nötigen Pakete sind:
<code bash>
xorg-x11-devel, libxml2-devel, kdesdk3, clucene-core-devel, libjpeg-devel, liblrdf-devel, libpng-devel, libxslt-devel, Mesa-devel, giflib-devel, subversion, gcc, gcc-c++
</code>

Bereits vorkompilierte CMake-Pakete für openSUSE sind direkt verfügbar im [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

== Ein Benutzer für die KDE 4 Entwicklung ==

{{Note|
Einige Menschen ziehen es vor, für KDE 4 einen separaten Nutzer-Account einzurichten, um nicht aus Versehen durch noch bestehende Bugs oder ähnliches Daten zu verlieren. Die Anleitung hier basiert auf der Herangehensweise.

Es ist jedoch deutlich effizienter alles mit einem einzigen Nutzer-Account zu machen. Unter [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] findet man mehr Details dazu.

In diesem Fall ist die folgende Anleitung noch immer gültig, jedoch sollten die nötigen Umgebungsvariablen nicht in die <tt>.bashrc</tt>, sondern in eine separate Datei geschrieben werden, die dann bei Bedarf eingelesen wird.
}}

=== Option 1: Kommandozeile ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2: Über KControl ===

Anstatt der oben genannten Befehle kann man auch mit Hilfe des Nutzer-Moduls des KDE Control Centers (kcontrol) einen weiteren Nutzer einrichten.

=== Einrichten der Entwicklungsumgebung ===

Kopieren Sie die Datei {{path|~/.bashrc}} von Ihrem normalen Nutzer-Account zu Ihrem neuen kde-devel-Account. Danach fügen Sie den Inhalt der Seite [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|example .bashrc]] in die Datei {{path|~kde-devel/.bashrc}} ein. Stellen Sie sicher, dass die Zeile <tt>alias make=makeobj</tt> auskommentiert ist falls auf Ihrem System das Programm <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt> nicht verfügbar ist.
Die neue {{path|~/.bashrc}} wird mit folgendem Befehl eingelesen:
<code bash>
source ~/.bashrc
</code>

Nun haben Sie Zugriff auf Befehle wie <tt>cmakekde</tt>, die in dieser Anleitung genutzt werden. Auch wird so sichergestellt, dass alle wichtigen Umgebungsvariablen (z.B. für die Pfadangaben von Qt, KDE und CMake) richtig gesetzt sind.

Für weitere Informationen lesen Sie bitte [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Zum neuen Benutzer wechseln ===

Sie können sich nun als Benutzer kde-devel anmelden (der Bindestrich ist wichtig!):
<code bash>
su - kde-devel
</code>

Der Rest dieser Anleitung geht davon aus, dass Sie alle Befehle als <tt>kde-devel</tt> ausführen.

== Die Shell des Entwicklungsbenutzers ==

On some systems a new user is configured by default to use {{path|/bin/sh}}. If this is not the case on your system, you can skip this section. Using {{path|/bin/sh}} can be very inconvenient to work with and you may want to change it to {{path|/bin/bash}} or another shell.

=== Option 1: Als kde-devel-Benutzer ===

If you don't have root privileges and your system supports the changing of your own shell with the <tt>chsh</tt> application, then you could try to change your shell to {{path|/bin/bash}} by using:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2: Als root-Benutzer ===

If your system comes with the <tt>usermod</tt> application you can run the following command as root: <tt>usermod -s /bin/bash</tt>.

Another option is to use the <tt>vipw</tt> application as root to safely edit your {{path|/etc/passwd}}. Locate 'kde-devel' in the the file. Change '{{path|/bin/sh}}' at the end of the line to read '{{path|/bin/bash}}', save your changes and exit.

The new shell will be started automatically when you log in as the kde-devel user again.

== D-Bus ==
QtDBus and KDE are known to work with D-Bus versions 0.62, as well as 0.92 and upwards. Versions 0.60 and 0.61 may work too but are not tested. Versions 0.90 and 0.91 are known not to work. We recommend using post-1.0 release versions (at least 0.94), so consider upgrading if you haven't done so.

You may skip this section if you have a recent D-Bus version or if you don't want to upgrade.

Before running these steps in the recipe, make sure your X11 headers and libraries are available. The configure script run on line 5 should output:
Building X11 code: yes

=== Das Kochrezept ===

{{tip|Make sure you did set up your environment correctly as described [[Getting_Started/Build/KDE4#Setting_up_the_environment|above]]. This is necessary for the <tt>cs</tt> and <tt>cb</tt> functions to work.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=$KDEDIR/var
make
make install
dbus-uuidgen --ensure

=== Was hier passiert ===
After changing into the source directory (line 1), D-Bus source code is downloaded from freedesktop.org (line 2) and unpacked (line 3). After going into the newly created D-Bus directory (line 4), the build is set up using the supplied {{path|configure}} script (line 5). After building (line 6) and installing (line 7) D-Bus, we use the <tt>dbus-uuidgen</tt> tool to install a machine identification file that allows the bus to start automatically when the desktop session starts (line 8).

Note that you need write access to {{path|/var}} for the last two steps. If your system does not have the sudo command, you can use the <tt>su</tt> command instead, e.g. <tt>su -c "make install"</tt>.

=== Fehlerbehebung ===

If you get the error '''makeobj: command not found''' you are lacking the command <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Skip this if you have [http://cmake.org/ CMake] >=2.4.5 installed.
You should be able to directly use the binary packages available on the [http://www.cmake.org/HTML/Download.html CMake site]. There are also distribution specific packages available.

=== Das Kochrezept ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click Here to learn more]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== Was hier passiert ===
First, we go back to the <tt>kde-devel</tt> user's source directory (line 1), get the CMake sources (line 2) and unpack them (line 3). We create a directory to build CMake in (line 4) and go into it (line 5). We then run the CMake bootstrap script to set up the CMake build (line 6), then make (line 7) and install it (line 8) using the root user.

If your system does not have the <tt>sudo</tt> command, you can instead do <tt>su -c "make install"</tt>.

== Qt ==
Next we need to get the Qt4 that is in KDE's source repository. KDE is guaranteed to build against any Qt 4.3. Qt 4.2 and earlier are not supported and will not work. Qt 4.3 has been released only recently, so your distribution probably doesn't have packages for it yet (known exceptions: Kubuntu, openSUSE). You should use the copy in the KDE Subversion servers.

=== Das Kochrezept ===
cd
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -qdbus -pch -nomake examples \
-nomake demos
make -j2
# make install: only if QTDIR is not the current directory!
make install

=== Was hier passiert ===
We switch back to the <tt>kde-devel</tt> user's home directory (line 1) and download the source code using subversion (svn) from KDE's repository (line 2). After changing into the resulting {{path|qt-copy}} directory (line 3), we run a script that manages the patches that come with <tt>qt-copy</tt> (line 4).

Once the patches have been applied, we then set up the build using the <tt>configure</tt> script (line 5-7). The various command line options used are explained in the {{path|qt-copy/README.qt-copy}} file. Finally, we build the minimal requirements for KDE (line 8) and install (line 9-10) Qt. If you want all the example and demo applications, you can either build them individually or simply do a <tt>make</tt> from the {{path|qt-copy}} directory.

Note that the installation does not require root as it installs Qt locally into {{path|$QTDIR}}. Anyway, installation is only needed if {{path|$QTDIR}} differs from {{path|$HOME/qt-copy}}, which is not the case if you have exactly followed the instructions.

=== Fehlerbebung ===

If you get "error: X11/Xlib.h: No such file or directory", install the devel package of <tt>xorg</tt> (the actual name may vary between operating systems, for example it is <tt>xorg-dev</tt> on Ubuntu based systems such as Kubuntu).

If you get an error in the configure step about missing defines, check the value of <tt>$QMAKESPEC</tt>. Some distributions set this to point directly to the system-installed Qt. If <tt>unset QMAKESPEC</tt> solves the problem, you probably want to add it to the <tt>~/.bashrc</tt> script.

If you get an error ".pch/debug-shared/QtCore", this is because Qt-4.3 enables precompiled headers if your gcc supports it, but for some reason it doesn't work for you. If you use distcc, configure qt with -no-pch. If you use icecream, update to the latest icecream from svn trunk.

Try running any Qt program, like {{program|assistant}}. If it crashes in QSpanData::adjustSpanMethods, then your problem is the oxygen style. Try removing {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} and {{path|lib/kde4/plugins/styles/oxygen.so}} if they exist in the KDE install prefix.

== Strigi ==

{{warning|If you have jumped to this section without reading [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''the recipes provided will not work'''.

The recipes are not in error; <tt>cs</tt> and <tt>cb</tt> are not typos. Your environment '''needs''' to be set up correctly for these instructions to work for you.}}

The code for getting file metadata now relies on Strigi. To install Strigi you need the libraries and headers for libz, libbz2, openssl (libcrypto or libssl), libclucene (=0.9.16; version 0.9.17 does '''not''' work), and either libxml2 or libexpat.

=== Das Kochrezept ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/strigi
cd strigi
cmakekde

=== Was hier passiert ===
We change to the base source directory (line 1). We download the sources for Strigi using subversion (line 2), go into the new {{path|~/src/strigi}} directory (line 3), and commence the build (line 4). This will leave us in the strigi build directory after the build is completed.

=== Fehlerbehebung ===
If you get
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
you should install the development package for libxml2.

== Soprano ==

{{warning|If you have jumped to this section without reading [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''the recipes provided will not work'''.

The recipes are not in error; <tt>cs</tt> and <tt>cb</tt> are not typos. Your environment '''needs''' to be set up correctly for these instructions to work for you.}}

The code for getting file kmetadata relies on Soprano. To install Soprano you need the libraries and headers for librdf.

=== Das Kochrezept ===

cd $KDE_SRC
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/soprano
cd soprano
cmakekde

=== Was hier passiert ===
We change to the base source directory (line 1). We download the sources for Soprano using subversion (line 2), go into the new {{path|~/src/soprano}} directory (line 3), and commence the build (line 4). This will leave us in the soprano build directory after the build is completed.

=== Fehlerbebung ===
=
If you get
CMake Error: Could NOT find REDLAND
then you need librdf from the Redland.
If your distribution does not provide the librdf package, you can download the source there: [http://download.librdf.org/source/ http://download.librdf.org/source/] and build it. On Gentoo the package is called 'redland', instead of librdf.

== kdelibs ==

With Qt4 and Strigi built, we can now move on to building KDE's base libraries. If you use the aforementioned [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] this is where those new functions come in handy.

=== Das Kochrezept ===


cd $KDE_SRC
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Was hier passiert ===
We change to the base source directory (line 1) then make and go into the KDE directory (line 2). We download the sources for kdelibs using subversion (line 3), go into the new {{path|~/src/KDE/kdelibs}} directory (line 4), and commence the build (line 5). This will leave us in the <tt>kdelibs</tt> build directory after the build is completed.

{{tip|There might be missing dependencies on your system! They are easily overlooked in the output of <tt>cmakekde</tt>.
You might want to do a <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> prior to compiling any kde modules (like kdelibs, kdepimlibs etc.)}}

=== Additional KDE-specific CMake modules ===
There are additional CMake modules in {{path|kdelibs/cmake/modules/}} that are necessary for building KDE4 applications. These will be installed for you when kdelibs itself is installed.

=== Fehlerbebung ===

If you have problems compiling kdelibs, first make sure the software in the [[Getting_Started/Build/KDE4#Required_Software|Required Software]] section above is installed and works. Other possible hints include:
* If the <tt>cmakekde</tt> command fails stating that CMake requires an out of source build directory, remove {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and try again.

If <tt>cmakekde</tt> still gives the same error then try this
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install
* If you received an error stating "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", then you need to change to your build directory before running cmakekde. (e.g <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* If Qt wasn't found or the wrong version of Qt was found, make sure that the qmake from the Qt you need is the first qmake in the path.
* If the problems persist, try the CMake make-option <tt>--keep-going</tt>.
* Here you need the libungif library, otherwise you will get an error message like "<tt>Could NOT find GIF</tt>".
* Qt-4.3 upgrade: if you get a link error in kjsembed talking about QScriptEngine, edit CMakeCache.txt in kdelibs and remove the lines that talk about QT_QTUITOOLS_LIBRARY, then type make again (that static library has a new dependency, and the cmake code that adds it needs to run).
* if you get <code>CMake Error: KDE Requires Qt to be built with SSL support
</code>, install openssl-devel, and re-compile QT.

== kdepimlibs ==
After <tt>kdelibs</tt>, but before ''kdebase'', you need to build and install ''kdepimlibs''.

=== Das Kochrezept ===


cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Was hier passiert ===
We go into the KDE source directory (line 1), download the source code for kdepimlibs using subversion (line 2) and then go into the new {{path|~/src/KDE/kdepimlibs}} directory (line 3). We then commence the build (line 4). This will leave us in the <tt>kdepimlibs</tt> build directory after the build is completed.

== kdebase ==
You may need kdebase for some kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Fehlerbebung ===

If you have troubles compiling kdebase:
* Make sure you have the <tt>libxss headers</tt> installed. (Usually you got undefined references on xscreensaver objects if you haven't those headers)
* <tt>which meinproc</tt> has to deliver {{path|/home/kde-devel/kde/bin/meinproc}}
* if cmakekde can not find the path of kdepimlibs, edit the file {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} and manually set <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* if you get an error saying "Please set the following variables: X11_XTest_LIB (ADVANCED)", install the devel package of <tt>Xtst</tt>. On some systems, this is packaged separately from <tt>xext</tt> and called <tt>x11proto-xext-dev</tt> or <tt>libxtst-dev</tt>. You may also need to remove the CMakeCache.txt file in the build dir after installing the package.
* the same for "X11_Xinerama_LIB (ADVANCED)" where you will need the devel package for <tt>xinerama</tt>.
* if you get the error "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", then you need to install the libfontconfig headers
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", you need to install soprano from kdesupport and to rebuild kdelibs
* if you get the error "‘XserverRegion’ does not name a type" make sure you have libxcomposite headers installed (<tt>libxcomposite-dev</tt> in ubuntu)

== Lokale API-Dokumentation erstellen ==
Although the API documentation for KDE is available online at [http://api.kde.org api.kde.org], it is sometimes useful to have it on your own disk, for example when you want to use [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] for browsing the documentation or when you are not able to be online all the time.

Be aware that generating the API documentation can take several hours and takes almost half a gigabyte of diskspace.
The generation is handled by a script in {{path|kdelibs/doc/api}}, you need <tt>doxygen</tt> to be able to run it.

To build the API documentation for kdelibs, type the following:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Repeat for other modules as desired.

== Allgemeine Fehlerbehebung ==

Es kann im Laufe der Zeit nach mehrmaligem Ausführen von <tt>svn up</tt> vorkommen, dass sich das Ausgabeformat einiger Werkzeuge, die in der KDE Werkzeugkette benutzt werden, ändert. Zum Beispiel werden <tt>kcfg</tt> Dateien vom <tt>kconfig_compiler</tt> gelesen, um die Konfigurationsdialoge zu generieren. Da CMake diese Veränderungen nicht erkennen kann, kann das Kompilieren fehlschlagen. Eine provisorische Lösung ist, die Regenerierung all dieser Dateien zu erzwingen:
find $KDE_SRC/kde/kdebase -name "*.kcfg" | xargs touch
Dasselbe gilt für <tt>ui</tt> Dateien wie solche, die vom Qt designer generiert werden.

== Das wars! ==

Sie sind nun bereit, andere svn Module in derselben Weise wie kdebase zu kompilieren, KDE4 zu benutzen und zu testen, sowie Ihre eigenen Patches und Anwendungen zu schreiben.

Siehe auch die Anleitung [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] um Hilfe beim Starten von KDE4 Anwendungen sowie zur Nutzung von KDevelop zu erhalten.

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4 (de)

2007-06-04T23:14:07Z

Liquidat: Suse und Kubuntu übersetzt

{{Template:I18n_Getting_Started_Build_KDE4}}

(Diese Anleitung befindet sich noch im Aufbau und ist eine Kopie des [[Getting_Started/Build/KDE4|englischen Orginals]]. Hilf mit, es zu übersetzen und es auf dem aktuellen Stand zu halten!)

{{TutorialBrowser|

series=Vorbereitungen|

name=KDE4 aus dem Quellcode bauen|

pre=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]|

next=[[../../Set_up_KDE_4_for_development|Set up KDE 4 for development]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: The KDE From Subversion Build Tool] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]] [[../KDE4/FreeBSD|FreeBSD notes]] [[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Übersicht ==

Diese Anleitung zeigt einen Weg, um KDE auf Linux und BSD-Systemen
zu komplieren und laufen zu lassen. Als Grundlage verwenden wir die Shell.
Wenn Sie sich für andere Systeme wie etwa Solaris, MacOS oder Microsoft Windows ersetzen, besuchen Sie bitte [[../|Build]] und folgen Sie den
Links am Ende der Seite.

{{warning|Stellen Sie sich auf verstärkt auftretende Buildprobleme '''an Montagen''' ein, da die Entwickler an diesem Wochentag kritische Änderungen vornehmen. Das [http://developer.kde.org/~dirk/dashboard/ Dashboard] zeigt unerwartete Probleme beim Kompilieren an.
}}

== Benötigte Software ==

Folgendes muss installiert sein, um dieses Tutorial erfolgreich durchführen zu können:
* gcc and g++ from the gcc project, preferably version 4.1 or higher
* svn, the subversion revision control client
* pkg-config
* development libraries and headers for X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 and libxslt
* the <tt>makeobj</tt> script, which is part of kdesdk. You can install it as part of kdesdk (kdesdk-scripts on Debian) or similar package, or just download it itself from [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* the [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info package], which is the freedesktop MIME standard KDE is using now
* [http://boost.org/ boost], needed by kdebase; after compiling and/or installing boost, in order to make cmake aware about its location (FindBoost), add boost directory (the one containing include subdirectory) to CMAKE_INCLUDE_PATH or set an environment variable called BOOST_ROOT pointing to boost directory.

Weiterhin ist es zu empfehlen, folgende Software bereits installiert zu haben:
* bash

=== Kubuntu ===

I Kubuntu 7.04 (Feisty) kann alle zum Bau der Pakete benötigte Software mit folgendem Befehl installiert werden:
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake libungif4-dev \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng-dev libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen
</code>

Die manuelle Installation von Qt 4.3, CMake 2.4.6 und DBus kann durch die Installation der folgenden Pakete und ihrer Abhängigkeiten vermieden werden:
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Für eine voll funktionstüchtige [[apidox]] Umgebung wird ebenfalls zusätzliche Software benötigt:
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===
{{note||Der openSUSE build service stellt ebenfalls tagesaktuelle KDE-4-Pakete bereit, die das gesamte auf dieser Seite beschriebene Vorgehen überflüssig machen. Weitere Informationen findet man direkt im openSUSE wiki unter [http://de.opensuse.org/KDE4 KDE4].}}

In OpenSuse können Pakete mit Hilfe von [http://de.opensuse.org/Zypper Zypper] installiert werden:
<code bash>
sudo zypper install <package-name>
</code>

In älteren SUSE-Versionen geht dies nur mit Yast:
<code bash>
yast2 -i <packagename>
</code>

Die meisten zum Bau von KDE 4 nötigen Pakete sind:
<code bash>
xorg-x11-devel, libxml2-devel, kdesdk3, clucene-core-devel, libjpeg-devel, liblrdf-devel, libpng-devel, libxslt-devel, Mesa-devel, giflib-devel, subversion, gcc, gcc-c++
</code>

Bereits vorkompilierte CMake-Pakete für openSUSE sind direkt verfügbar im [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

== Ein Benutzer für die KDE 4 Entwicklung ==

{{Note|
Some people like to have a separate user account for KDE 4 (for instance an old bug deleted files by mistake), and the instructions below were written with that approach.

However it is much more efficient to do everything with a single user account, see [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]
for more details.

You can still follow the instructions below, but don't put the environment variables in your <tt>.bashrc</tt>, put them in a separate file that you source to switch to the KDE 4 environment.
}}

=== Option 1: Kommandozeile ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2: Über KControl ===

Instead of using the commands above, you can also use the User module in the KDE Control Center if you already have KDE3 installed.

=== Einrichten der Entwicklungsumgebung ===

Copy the {{path|~/.bashrc}} from your normal user account to the new kde-devel account. Next, copy and paste the contents of the [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|example .bashrc]] into {{path|~kde-devel/.bashrc}}. Be sure to comment out the line <tt>alias make=makeobj</tt> if you do not have the <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt> command available. To make it run, you have to open a new bash or to execute
<code bash>
source ~/.bashrc
</code>

This will provide access to commands such as <tt>cmakekde</tt> that are used in this tutorial as well as ensure that the proper paths are in place for Qt, KDE and CMake binaries.

For more information, please read the [[Getting Started/Increased Productivity in KDE4 with Scripts]] tutorial.

=== Zum neuen Benutzer wechseln ===
Switch to the user kde-devel: (don't forget the dash)
<code bash>
su - kde-devel
</code>

The rest of this tutorial assumes you are running as the <tt>kde-devel</tt> user.

== Die Shell des Entwicklungsbenutzers ==

On some systems a new user is configured by default to use {{path|/bin/sh}}. If this is not the case on your system, you can skip this section. Using {{path|/bin/sh}} can be very inconvenient to work with and you may want to change it to {{path|/bin/bash}} or another shell.

=== Option 1: Als kde-devel-Benutzer ===

If you don't have root privileges and your system supports the changing of your own shell with the <tt>chsh</tt> application, then you could try to change your shell to {{path|/bin/bash}} by using:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2: Als root-Benutzer ===

If your system comes with the <tt>usermod</tt> application you can run the following command as root: <tt>usermod -s /bin/bash</tt>.

Another option is to use the <tt>vipw</tt> application as root to safely edit your {{path|/etc/passwd}}. Locate 'kde-devel' in the the file. Change '{{path|/bin/sh}}' at the end of the line to read '{{path|/bin/bash}}', save your changes and exit.

The new shell will be started automatically when you log in as the kde-devel user again.

== D-Bus ==
QtDBus and KDE are known to work with D-Bus versions 0.62, as well as 0.92 and upwards. Versions 0.60 and 0.61 may work too but are not tested. Versions 0.90 and 0.91 are known not to work. We recommend using post-1.0 release versions (at least 0.94), so consider upgrading if you haven't done so.

You may skip this section if you have a recent D-Bus version or if you don't want to upgrade.

Before running these steps in the recipe, make sure your X11 headers and libraries are available. The configure script run on line 5 should output:
Building X11 code: yes

=== Das Kochrezept ===

{{tip|Make sure you did set up your environment correctly as described [[Getting_Started/Build/KDE4#Setting_up_the_environment|above]]. This is necessary for the <tt>cs</tt> and <tt>cb</tt> functions to work.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=$KDEDIR/var
make
make install
dbus-uuidgen --ensure

=== Was hier passiert ===
After changing into the source directory (line 1), D-Bus source code is downloaded from freedesktop.org (line 2) and unpacked (line 3). After going into the newly created D-Bus directory (line 4), the build is set up using the supplied {{path|configure}} script (line 5). After building (line 6) and installing (line 7) D-Bus, we use the <tt>dbus-uuidgen</tt> tool to install a machine identification file that allows the bus to start automatically when the desktop session starts (line 8).

Note that you need write access to {{path|/var}} for the last two steps. If your system does not have the sudo command, you can use the <tt>su</tt> command instead, e.g. <tt>su -c "make install"</tt>.

=== Fehlerbehebung ===

If you get the error '''makeobj: command not found''' you are lacking the command <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Skip this if you have [http://cmake.org/ CMake] >=2.4.5 installed.
You should be able to directly use the binary packages available on the [http://www.cmake.org/HTML/Download.html CMake site]. There are also distribution specific packages available.

=== Das Kochrezept ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click Here to learn more]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== Was hier passiert ===
First, we go back to the <tt>kde-devel</tt> user's source directory (line 1), get the CMake sources (line 2) and unpack them (line 3). We create a directory to build CMake in (line 4) and go into it (line 5). We then run the CMake bootstrap script to set up the CMake build (line 6), then make (line 7) and install it (line 8) using the root user.

If your system does not have the <tt>sudo</tt> command, you can instead do <tt>su -c "make install"</tt>.

== Qt ==
Next we need to get the Qt4 that is in KDE's source repository. KDE is guaranteed to build against any Qt 4.3. Qt 4.2 and earlier are not supported and will not work. Qt 4.3 has been released only recently, so your distribution probably doesn't have packages for it yet (known exceptions: Kubuntu, openSUSE). You should use the copy in the KDE Subversion servers.

=== Das Kochrezept ===
cd
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -qdbus -pch -nomake examples \
-nomake demos
make -j2
# make install: only if QTDIR is not the current directory!
make install

=== Was hier passiert ===
We switch back to the <tt>kde-devel</tt> user's home directory (line 1) and download the source code using subversion (svn) from KDE's repository (line 2). After changing into the resulting {{path|qt-copy}} directory (line 3), we run a script that manages the patches that come with <tt>qt-copy</tt> (line 4).

Once the patches have been applied, we then set up the build using the <tt>configure</tt> script (line 5-7). The various command line options used are explained in the {{path|qt-copy/README.qt-copy}} file. Finally, we build the minimal requirements for KDE (line 8) and install (line 9-10) Qt. If you want all the example and demo applications, you can either build them individually or simply do a <tt>make</tt> from the {{path|qt-copy}} directory.

Note that the installation does not require root as it installs Qt locally into {{path|$QTDIR}}. Anyway, installation is only needed if {{path|$QTDIR}} differs from {{path|$HOME/qt-copy}}, which is not the case if you have exactly followed the instructions.

=== Fehlerbebung ===

If you get "error: X11/Xlib.h: No such file or directory", install the devel package of <tt>xorg</tt> (the actual name may vary between operating systems, for example it is <tt>xorg-dev</tt> on Ubuntu based systems such as Kubuntu).

If you get an error in the configure step about missing defines, check the value of <tt>$QMAKESPEC</tt>. Some distributions set this to point directly to the system-installed Qt. If <tt>unset QMAKESPEC</tt> solves the problem, you probably want to add it to the <tt>~/.bashrc</tt> script.

If you get an error ".pch/debug-shared/QtCore", this is because Qt-4.3 enables precompiled headers if your gcc supports it, but for some reason it doesn't work for you. If you use distcc, configure qt with -no-pch. If you use icecream, update to the latest icecream from svn trunk.

Try running any Qt program, like {{program|assistant}}. If it crashes in QSpanData::adjustSpanMethods, then your problem is the oxygen style. Try removing {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} and {{path|lib/kde4/plugins/styles/oxygen.so}} if they exist in the KDE install prefix.

== Strigi ==

{{warning|If you have jumped to this section without reading [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''the recipes provided will not work'''.

The recipes are not in error; <tt>cs</tt> and <tt>cb</tt> are not typos. Your environment '''needs''' to be set up correctly for these instructions to work for you.}}

The code for getting file metadata now relies on Strigi. To install Strigi you need the libraries and headers for libz, libbz2, openssl (libcrypto or libssl), libclucene (=0.9.16; version 0.9.17 does '''not''' work), and either libxml2 or libexpat.

=== Das Kochrezept ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/strigi
cd strigi
cmakekde

=== Was hier passiert ===
We change to the base source directory (line 1). We download the sources for Strigi using subversion (line 2), go into the new {{path|~/src/strigi}} directory (line 3), and commence the build (line 4). This will leave us in the strigi build directory after the build is completed.

=== Fehlerbehebung ===
If you get
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
you should install the development package for libxml2.

== Soprano ==

{{warning|If you have jumped to this section without reading [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''the recipes provided will not work'''.

The recipes are not in error; <tt>cs</tt> and <tt>cb</tt> are not typos. Your environment '''needs''' to be set up correctly for these instructions to work for you.}}

The code for getting file kmetadata relies on Soprano. To install Soprano you need the libraries and headers for librdf.

=== Das Kochrezept ===

cd $KDE_SRC
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/soprano
cd soprano
cmakekde

=== Was hier passiert ===
We change to the base source directory (line 1). We download the sources for Soprano using subversion (line 2), go into the new {{path|~/src/soprano}} directory (line 3), and commence the build (line 4). This will leave us in the soprano build directory after the build is completed.

=== Fehlerbebung ===
=
If you get
CMake Error: Could NOT find REDLAND
then you need librdf from the Redland.
If your distribution does not provide the librdf package, you can download the source there: [http://download.librdf.org/source/ http://download.librdf.org/source/] and build it. On Gentoo the package is called 'redland', instead of librdf.

== kdelibs ==

With Qt4 and Strigi built, we can now move on to building KDE's base libraries. If you use the aforementioned [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] this is where those new functions come in handy.

=== Das Kochrezept ===


cd $KDE_SRC
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Was hier passiert ===
We change to the base source directory (line 1) then make and go into the KDE directory (line 2). We download the sources for kdelibs using subversion (line 3), go into the new {{path|~/src/KDE/kdelibs}} directory (line 4), and commence the build (line 5). This will leave us in the <tt>kdelibs</tt> build directory after the build is completed.

{{tip|There might be missing dependencies on your system! They are easily overlooked in the output of <tt>cmakekde</tt>.
You might want to do a <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> prior to compiling any kde modules (like kdelibs, kdepimlibs etc.)}}

=== Additional KDE-specific CMake modules ===
There are additional CMake modules in {{path|kdelibs/cmake/modules/}} that are necessary for building KDE4 applications. These will be installed for you when kdelibs itself is installed.

=== Fehlerbebung ===

If you have problems compiling kdelibs, first make sure the software in the [[Getting_Started/Build/KDE4#Required_Software|Required Software]] section above is installed and works. Other possible hints include:
* If the <tt>cmakekde</tt> command fails stating that CMake requires an out of source build directory, remove {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and try again.

If <tt>cmakekde</tt> still gives the same error then try this
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install
* If you received an error stating "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", then you need to change to your build directory before running cmakekde. (e.g <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* If Qt wasn't found or the wrong version of Qt was found, make sure that the qmake from the Qt you need is the first qmake in the path.
* If the problems persist, try the CMake make-option <tt>--keep-going</tt>.
* Here you need the libungif library, otherwise you will get an error message like "<tt>Could NOT find GIF</tt>".
* Qt-4.3 upgrade: if you get a link error in kjsembed talking about QScriptEngine, edit CMakeCache.txt in kdelibs and remove the lines that talk about QT_QTUITOOLS_LIBRARY, then type make again (that static library has a new dependency, and the cmake code that adds it needs to run).
* if you get <code>CMake Error: KDE Requires Qt to be built with SSL support
</code>, install openssl-devel, and re-compile QT.

== kdepimlibs ==
After <tt>kdelibs</tt>, but before ''kdebase'', you need to build and install ''kdepimlibs''.

=== Das Kochrezept ===


cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Was hier passiert ===
We go into the KDE source directory (line 1), download the source code for kdepimlibs using subversion (line 2) and then go into the new {{path|~/src/KDE/kdepimlibs}} directory (line 3). We then commence the build (line 4). This will leave us in the <tt>kdepimlibs</tt> build directory after the build is completed.

== kdebase ==
You may need kdebase for some kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Fehlerbebung ===

If you have troubles compiling kdebase:
* Make sure you have the <tt>libxss headers</tt> installed. (Usually you got undefined references on xscreensaver objects if you haven't those headers)
* <tt>which meinproc</tt> has to deliver {{path|/home/kde-devel/kde/bin/meinproc}}
* if cmakekde can not find the path of kdepimlibs, edit the file {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} and manually set <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* if you get an error saying "Please set the following variables: X11_XTest_LIB (ADVANCED)", install the devel package of <tt>Xtst</tt>. On some systems, this is packaged separately from <tt>xext</tt> and called <tt>x11proto-xext-dev</tt> or <tt>libxtst-dev</tt>. You may also need to remove the CMakeCache.txt file in the build dir after installing the package.
* the same for "X11_Xinerama_LIB (ADVANCED)" where you will need the devel package for <tt>xinerama</tt>.
* if you get the error "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", then you need to install the libfontconfig headers
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", you need to install soprano from kdesupport and to rebuild kdelibs
* if you get the error "‘XserverRegion’ does not name a type" make sure you have libxcomposite headers installed (<tt>libxcomposite-dev</tt> in ubuntu)

== Lokale API-Dokumentation erstellen ==
Although the API documentation for KDE is available online at [http://api.kde.org api.kde.org], it is sometimes useful to have it on your own disk, for example when you want to use [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] for browsing the documentation or when you are not able to be online all the time.

Be aware that generating the API documentation can take several hours and takes almost half a gigabyte of diskspace.
The generation is handled by a script in {{path|kdelibs/doc/api}}, you need <tt>doxygen</tt> to be able to run it.

To build the API documentation for kdelibs, type the following:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Repeat for other modules as desired.

== Allgemeine Fehlerbehebung ==

What can happen over time, after some <tt>svn up</tt> commands, is that some of the tools used in the KDE build chain change their output format. For example, <tt>kcfg</tt> files are read by <tt>kconfig_compiler</tt> to produce configuration dialogs. CMake cannot detect those changes, and the compilation might fail. A workaround is to always force a re-generation of all such files:
find $KDE_SRC/kde/kdebase -name "*.kcfg" | xargs touch
The same applies to <tt>ui</tt> files as produced by Qt designer.

== Das wars! ==

Sie sind nun bereit, andere svn Module in derselben Weise wie kdebase zu kompilieren, KDE4 zu benutzen und zu testen, sowie Ihre eigenen Patches und Anwendungen zu schreiben.

Siehe auch die Anleitung [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] um Hilfe beim Starten von KDE4 Anwendungen sowie zur Nutzung von KDevelop zu erhalten.

[[Category:Build KDE]]
[[Category:KDE4]]