KDE TechBase - User contributions [en]

Getting Started/Build/KDE4 (fr)

2010-04-09T17:29:30Z

Fatalerrors: Ajout bandeau avertissement obsolecence des instructions.

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}
{{warning| La présente traduction de ce document n'est pas à jour, son utilisation pourra donc poser problème. En cas de difficulté, il vous faudra vous référer à la version originale de ce document (en anglais), accessible depuis la barre ci-dessus. Merci de votre compréhension et veuillez nous excuser pour la gêne occasionné.}}
{{TutorialBrowser|

series=Démarrer avec KDE|

name=Construire KDE4 depuis les sources|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mac OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''le lundi''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir l'interpréteur de commandes bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev libgpgme11-dev libpth-dev \
libxine-dev libxkbfile-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour que le framework [[apidox]] fonctionne correctement vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquants avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquetages requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
gmp-devel (needed to build kdesupport)
xine-devel
libgpgme-devel (needed to build kdepimlibs)
</code>

'''Paquetages facultatifs'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.6 et DBus en installant le dépôt de paquetages openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquetages suivants (et leurs dépendances):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous aurez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

Vous pouvez utiliser tout les ebuilds stables récents mais rappelez vous de toujours synchroniser votre portage avant de commencer.

Il faut être démasqué et/ou conserver une version inférieure pour continuer ''(note du traducteur : à vérifier)''.

<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>

Ceux-ci sont les paquetages que nous aurons besoins d'installer, certain pouvant être déja installé. Vous pourrez donc éviter l'installation de certain d'entre eux en ajoutant le paramètre de mise à jour à 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

Vous commencerez à compiler à la main à partir de la section [[Getting_Started/Build/KDE4#kdesupport|section kdesupport]].

Bonne chance !

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se connecter avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== L'interpréteur de commandes du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash kde-devel</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.60 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous avez une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qui se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.6
Vous pouvez utiliser directement le paquetage binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquetages spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
wget http://www.cmake.org/files/v2.6/cmake-2.6.0.tar.gz
tar zxf cmake-2.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.6/bootstrap
make
sudo make install

=== Ce qui se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquetages adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
<code bash>
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 sub-src sub-tools
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;
</code>

=== Ce qui se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoi qu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquetage de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. '''Notez :''' Il vous faudra peut-être lancer la commande <tt>xhost +local:kde-devel</tt> en tant qu'utilisateur normal de KDE3 pour démarrer cette application. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== kdesupport ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|Mise en place de l'environnement]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Il existe plusieurs bibliothèques dont les applications KDE se servent dans le module appelé kdesupport. Ceci inclus Strigi et Soprano pour les recherche de fichiers et la création de métadata, eigen pour les effets visuels dans des applications tels que Kalzium, taglib pour les applications multimédia et qca pour certains besoins en cryptographie.

Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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/
cd kdesupport
cmakekde

=== Ce qui se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/kdesupport}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquetage de développement de libxml2.

Si vous avez :
CMake Error: Could NOT find REDLAND
alors il vous faudra librdf depuis Redland. Si votre distribution ne fournis pas le paquetage librdf, vous pourrez trouver son code source ici : [http://download.librdf.org/source/] et le compiler. (Pour les utilisateurs de Gentoo: L'ebuild de librdf est appelé dev-libs/redland)

Si vous avez :
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
regardez [[Getting_Started/Sources/Using_Subversion_with_KDE|Utiliser Subversion avec KDE]]

Si vous avez :
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.
- - -
make: *** [install] Error 255
Vérifiez que les chemins sont corrects dans le fichier .bashrc décris plus haut.

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

cs #cs n'est pas une commande unix
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Ce qui se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, et réessayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un message d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez-vous que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.
* Si vous avez : <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> cela signifie que vous avez compilé Qt sans le support de Qt3 (et le lien vers une bonne installation de Qt3 ne fonctionne pas).
* Si vous avez un pb avec la lib Soprano >= 1.99 avec Kubuntu Gutsy alors supprimez les packages libsoprano-dev et libsoprano4, checkout et cmakekde du kdesupports si ce n'est déjà fait, puis
cs KDE/kdelibs \
cb \
rm CMakeCache.txt \
cs KDE/kdelibs \
cmakekde

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qui se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certaines choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc4</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc4}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquetage.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquetage de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs
* Si vous obtenez l'erreur "‘XserverRegion’ does not name a type", vérifiez que vous avez les en-têtes de libxcomposite installé (libxcomposite-dev dans Ubuntu).

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/
Si vous le souhaiter répétez l'opération pour chaque module :
cd <répertoire de base du module>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

== Rester à jour ==

Pour garder une installation de KDE4 à jour, chaque module installé doit être mis à jour de manière périodique. Le lundi étant le jour des grosses modifications sur kdelibs, le mardi est le meilleur jour pour le faire. Pour chaque module que vous contrôlerez utilisez les commandes "svn up" puis "make" et "make install".

Par exemple :
<code bash>
cs KDE/kdesupport # cs n'est pas une commande unix
svn up
cb # cb n'est pas une commande unix
make -j2 VERBOSE=1 && make install
</code>

Note: Il n'est pas nécessaire d'utiliser cmakekde pour mettre à jour.

== Problèmes généraux ==

Ce qu'il peut arriver après quelques temps, après quelques commandes <tt>svn up</tt>, est que certain des outils utilisés dans la chaîne de compilation de KDE peuvent changer de format de sortie. Par exemple, les fichiers <tt>kcfg</tt> sont lu par <tt>kconfig_compiler</tt> pour produire les dialogues de configuration. CMake ne peut détecter ces changements, et dans ce cas la compilation échoue. Une solution consiste à forcer la re-génération de tout ces fichiers :
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
Le même principe s'applique aux fichiers <tt>ui</tt> produits par le Qt designer.

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started (fr)

2008-10-16T12:10:31Z

Fatalerrors: Correction liens (Build)

{{Template:I18n/Language Navigation Bar|Getting_Started}}
{{Box|Obtenir le code source|
[[Image:Action_down.svg|right|32px]]
Le code source de KDE est disponible via différents canaux :
* [[Getting Started/Sources/Anonymous SVN (fr)|Guide de démarrage rapide avec le SVN anonyme]]
* [[Getting Started/Sources/Using Subversion with KDE|Utiliser Subversion avec KDE]] ''Une description plus détaillée concernant l'accès au code source de KDE avec subversion, incluant l'organisation du dépôt et détaillant le fonctionnement des revisions et des patches.''
* [http://websvn.kde.org/ Parcourir le code en ligne]
* [[Getting Started/Sources/Snapshots|Aperçu journalier du code]]
|100%}}

{{Box|Construire KDE|
[[Image:Action_tool.svg|right|32px]]
Il existe plusieurs branches de KDE. Pour une utilisation sûre, il est recommandé de choisir une version stable.
* [[Getting Started/Build/KDE4 (fr)|KDE 4 (Version de développement, tronc)]]
* [[Getting Started/Build/Stable Version|KDE 3.5 (Version stable)]]
* [[Getting Started/Build_(fr)|Autres version de KDE et FAQ]] ''Inclut des informations pour la compilation sur des systèmes non-linux''
|100%}}

{{Box|Configurer l'environement|
[[Image:Action_pen.svg|right|32px]]
Après avoir construit KDE, vous souhaiterez probablement avoir un moyen efficace de lancer des applications et de réaliser vos tâches de développement habituelles :
* [[Getting Started/Increased Productivity in KDE4 with Scripts|Augmenter sa productivité dans KDE4 à l'aide de scripts]]
* [[Getting Started/Set up KDE 4 for development|Configurer KDE 4 pour le développement]]
|100%}}
[[Category:Build KDE]]

User talk:Fatalerrors

2007-07-21T14:53:53Z

Fatalerrors:

Hi, I am not sure whether it makes sense to translate the Projects subpages.
They are mostly a scratchpad as I see it.
--[[User:Dhaumann|Dhaumann]] 11:34, 2 July 2007 (CEST)
: Ok, that's right. I will concentrate translations on the most important pages... Trying to translate kde subproject parts was an error. --[[User:Fatalerrors|fatalerrors]]

Projects (fr)

2007-07-21T14:46:25Z

Fatalerrors: restauration des liens morts

{{Template:I18n/Language Navigation Bar|Projects}}
{| style="margin: 1em 2.5% 0 2.5%; padding: 0 5px;" cellpadding="5"
|-
|[[Image:Klogo-official-crystal.svg|noframe|left|40px]] ||
;[http://www.kde.org/getinvolved Soyez impliqué dans KDE]
:Informations générales pour vous impliquer dans les projets de KDE. Cela inclu un répertoire d'apprentissage pour différents projets.
|-
|[[Image:Action_book.svg|noframe|left|40px]] ||
;[[Projects/Edu_(fr)|Projets éducatifs de KDE]]
:Développer des logiciels éducatifs pour KDE.
|-
|[[Image:Devices_joystick.svg|noframe|left|40px]] ||
;[[Projects/Games_(fr)|Projets des jeux de KDE]]
:Développer des jeux de bureau pour KDE.
|-
|[[Image:Action_kontact_mail.svg|noframe|left|40px]] ||
;[[Projects/kdepim_(fr)|Projet PIM de KDE]]
: Système de gestion des informations personelles (PIM) de KDE.
|-
|[[Image:Klogo-official-crystal.svg|noframe|left|40px]] ||
;[[Projects/kde.org_(fr)|kde.org]]
:Information concernant les différents sites internet *.kde.org.
|-
|[[Image:Action_fileprint.svg|noframe|left|40px]] ||
;[[Projects/KDEPrint_(fr)|KDEPrint]]
:Informations relatives à l'impression dans KDE.
|-
|[[Image:Action_pencil.svg|noframe|left|40px]] ||
;[http://wiki.koffice.org KOffice.org]
:Développement d'une suite bureautique basé sur KDE.
|-
|[[Image:logo_oxygen.png|noframe|left|40px]] ||
;[[Projects/Oxygen|Le projet Oxygen]]
:Oeuvres artistiques dans KDE4.
|-
|[[Image:Action_world.svg|noframe|left|40px]] ||
;[[Projects/Partners|Programme de partenariat]]
:Programme de partenariat de KDE destiné aux fournisseurs indépendants de logiciels (ISV).
|-
| ||
;[[Projects/Plasma|Plasma]]
:Le projet Plasma. Un nouveau cheminement vers le bureau.
|-
| ||
;[[Projects/Summer_of_Code|Le projet "Été de code"]]
:Information sur le projet "Été de code" et perspectives relatives à KDE
|-
|[[Image:Kopete.svg|noframe|left|40px]] ||
;[[Projects/Kopete|Kopete]]
:Kopete, le programme de messagerie instantané de KDE.
|-
|[[Image:superkaramba.png|noframe|left|40px]] ||
;[[Projects/SuperKaramba|SuperKaramba]]
:SuperKaramba est un outil qui vous autorise à créé facilement des application visuelles interactives sur votre bureau KDE.
|-
| ||
;[[Projects/Okular|Okular]]
:Okular, le visualisateur universel de document.
|-
| ||
;[[Projects/Widgets and Classes|Widgets & Classes]]
:Widgets et classes qui ne se trouve pas dans kdelibs mais que vous pourrez trouver utiles.
|}

__NOTOC__

Projects/PIM (fr)

2007-06-30T06:28:32Z

Fatalerrors:

{{Template:I18n/Language Navigation Bar|Projects/kdepim}}
==Article==

* [[Projects/kdepim/Installing the KDE PIM 3.5.5+ feature branch|Installer la branche de fonctionnalité (?) de KDE PIM 3.5.5+]]

==Liste de vérification de qualité==

{| border="1"
|+ Liste de vérification des applications
! Application !! Portage Qt4/KDE4 !! Nettoyage désapprouvé !! Nettoyage fou !! Style de code !! Ui4
|-
| Akonadi || ? || ? || ? || ? || ?
|-
| Akregator || ? || ? || ? || ? || ?
|-
| Kabcclient || ? || ? || ? || ? || ?
|-
| KAddressbook || ? || ? || ? || ? || ?
|-
| KAlarm || ? || ? || ? || ? || ?
|-
| Kitchensync || ? || ? || ? || ? || ?
|-
| KMail || ? || ? || ? || ? || ?
|-
| KMailCVT || ? || ? || ? || ? || ?
|-
| KMobileTools || ? || ? || ? || ? || ?
|-
| KNode || ? || ? || ? || ? || ?
|-
| KNotes || ? || ? || ? || ? || ?
|-
| Kode || ? || ? || ? || ? || ?
|-
| Kontact || ? || ? || ? || ? || ?
|-
| KonsoleKalendar || ? || ? || ? || ? || ?
|-
| KOrganizer || ? || ? || ? || ? || ?
|-
| KOrn || ? || ? || ? || ? || ?
|-
| KPilot || ? || ? || ? || ? || ?
|-
| KTimeTracker || ? || ? || ? || ? || ?
|-
|}
Légende: D=Effectué, ?=Inconnu, n/a=Non applicable

==Liens==

* [http://kdepim.kde.org Page principale de KDE PIM]
* [http://kontact.kde.org/ Page principale de Kontact]

[[Category:PIM]]

Projects/PIM

2007-06-30T06:22:10Z

Fatalerrors: ooops

{{Template:I18n/Language Navigation Bar|Projects/kdepim}}
==Article==

* [[/Installing the KDE PIM 3.5.5+ feature branch|Installing the KDE PIM 3.5.5+ feature branch]]

==Quality Checklist==

{| border="1"
|+ Application Checklist
! Application !! Qt4/KDE4 Port !! Deprecated Clean !! Krazy Clean !! Coding Style !! Ui4
|-
| Akonadi || ? || ? || ? || ? || ?
|-
| Akregator || ? || ? || ? || ? || ?
|-
| Kabcclient || ? || ? || ? || ? || ?
|-
| KAddressbook || ? || ? || ? || ? || ?
|-
| KAlarm || ? || ? || ? || ? || ?
|-
| Kitchensync || ? || ? || ? || ? || ?
|-
| KMail || ? || ? || ? || ? || ?
|-
| KMailCVT || ? || ? || ? || ? || ?
|-
| KMobileTools || ? || ? || ? || ? || ?
|-
| KNode || ? || ? || ? || ? || ?
|-
| KNotes || ? || ? || ? || ? || ?
|-
| Kode || ? || ? || ? || ? || ?
|-
| Kontact || ? || ? || ? || ? || ?
|-
| KonsoleKalendar || ? || ? || ? || ? || ?
|-
| KOrganizer || ? || ? || ? || ? || ?
|-
| KOrn || ? || ? || ? || ? || ?
|-
| KPilot || ? || ? || ? || ? || ?
|-
| KTimeTracker || ? || ? || ? || ? || ?
|-
|}
Legend: D=Done, ?=Unknown, n/a=Not Applicable

==Links==

* [http://kdepim.kde.org Homepage of the KDE PIM]
* [http://kontact.kde.org/ Homepage of Kontact]

[[Category:PIM]]

Projects/PIM

2007-06-30T06:20:45Z

Fatalerrors: Add langage bar

{{Template:I18n/Language Navigation Bar|Projects}}
==Article==

* [[/Installing the KDE PIM 3.5.5+ feature branch|Installing the KDE PIM 3.5.5+ feature branch]]

==Quality Checklist==

{| border="1"
|+ Application Checklist
! Application !! Qt4/KDE4 Port !! Deprecated Clean !! Krazy Clean !! Coding Style !! Ui4
|-
| Akonadi || ? || ? || ? || ? || ?
|-
| Akregator || ? || ? || ? || ? || ?
|-
| Kabcclient || ? || ? || ? || ? || ?
|-
| KAddressbook || ? || ? || ? || ? || ?
|-
| KAlarm || ? || ? || ? || ? || ?
|-
| Kitchensync || ? || ? || ? || ? || ?
|-
| KMail || ? || ? || ? || ? || ?
|-
| KMailCVT || ? || ? || ? || ? || ?
|-
| KMobileTools || ? || ? || ? || ? || ?
|-
| KNode || ? || ? || ? || ? || ?
|-
| KNotes || ? || ? || ? || ? || ?
|-
| Kode || ? || ? || ? || ? || ?
|-
| Kontact || ? || ? || ? || ? || ?
|-
| KonsoleKalendar || ? || ? || ? || ? || ?
|-
| KOrganizer || ? || ? || ? || ? || ?
|-
| KOrn || ? || ? || ? || ? || ?
|-
| KPilot || ? || ? || ? || ? || ?
|-
| KTimeTracker || ? || ? || ? || ? || ?
|-
|}
Legend: D=Done, ?=Unknown, n/a=Not Applicable

==Links==

* [http://kdepim.kde.org Homepage of the KDE PIM]
* [http://kontact.kde.org/ Homepage of Kontact]

[[Category:PIM]]

Projects/Games (fr)

2007-06-30T06:17:04Z

Fatalerrors:

{{Template:I18n/Language Navigation Bar|Projects/Games}}
Intro to do

===See also===
* [http://doc.trolltech.com/4.2/qsvgrenderer.html QSvgRenderer Class Reference]
* [http://developer.kde.org/documentation/library/cvs-api/kdelibs-apidocs/kdecore/html/classKSvgRenderer.html KSvgRenderer Class Reference]
* [http://websvn.kde.org/trunk/KDE/kdegames/katomic/ KAtomic KDE4 code in websvn]

==Development==

* [[Projects/Games/Maintainers| Game's maintainers]]
* [[Projects/Games/UI and usability|UI and usability]]
* [[Projects/Games/libkdegames Usage|libkdegames Usage]]

==Status==

* [[Projects/Games/Status_Ready|Ready]]
* [[Projects/Games/Status_Should_be_Ready|Should be ready]]
* [[Projects/Games/Status_Playground|kdegames playground (kdegame's candidate or unready) ]]
* [[Projects/Games/Status|old status page]]

==Meeting==

===IRC===

We are doing meeting on [irc://irc.kde.org/#kdegames IRC] every month to talk about the games development. The New people a

[[Projects/Games/IRC Meeting|Next Meeting : 1st June]]

Last meetings' logs:
* [[Projects/Games/IRC Meeting-1stjune|1stjuneIRC Meeting]]

===akademy===

On the [http://conference2007.kde.org/ 2007's akademy], we will giving a common [http://conference2007.kde.org/conference/talks/31.php KDEgame's talk] managed by Mauricio Piacentini. Each kdegames dude will talk about what he did / is doing.

We have 30' for the presentation:
* 0' to 4' - Mauricio Piacentini (intro / KMahjongg)
* 4' to 7'30" - Paolo Capriotti (KBattleship)
* 7'30" to 11' - Maurizio Monge (KGameCanvas)
* 11' to 14'30" - Matt Williams (KSquares/KScoreDialog)
* 14'30" to 18' - Nicolas Roffet (KBlackbox/KSirtet??)
* 18' to 25' - Johann Ollivier Lapeyre and Eugene Trounev (Art and Release manager duties)
* 25' to 28'30" - Josef Spillner (KNewStuff2)
* 28'30" - Thanks and Q&A (possibly going informally into coffe break)

Presentation odp (Impress) including intro and initial slides (Mauricio Piacentini) can be found [http://www.tabuleiro.com/mauricio/kdegames_01.odp here]. You can use it to make your own slides, and we will collect and merge them all during Saturday's lunch. The laptop that will run the presentation will have Inkscape and versions of all kdegames for KDE3 and KDE4. There is no time to switch machines, so we will all use the same one.

For more discussion during aKademy we will also have a [http://akademy.kde.org/codingmarathon/bof.php BoF] on Wednesday, July 4th, from 11:00 to 12:00 AM.

===Agenda===

* akademy obviously, see above ^
* Development tutorials for libkdegames [[Development/Tutorials#Using_the_KDE_Games_Library]]

Projects/Games

2007-06-30T06:14:13Z

Fatalerrors: add langage bar

{{Template:I18n/Language Navigation Bar|Projects/Games}}
Intro to do

===See also===
* [http://doc.trolltech.com/4.2/qsvgrenderer.html QSvgRenderer Class Reference]
* [http://developer.kde.org/documentation/library/cvs-api/kdelibs-apidocs/kdecore/html/classKSvgRenderer.html KSvgRenderer Class Reference]
* [http://websvn.kde.org/trunk/KDE/kdegames/katomic/ KAtomic KDE4 code in websvn]

==Development==

* [[/Maintainers| Game's maintainers]]
* [[/UI and usability|UI and usability]]
* [[/libkdegames Usage|libkdegames Usage]]

==Status==

* [[/Status_Ready|Ready]]
* [[/Status_Should_be_Ready|Should be ready]]
* [[/Status_Playground|kdegames playground (kdegame's candidate or unready) ]]
* [[/Status|old status page]]

==Meeting==

===IRC===

We are doing meeting on [irc://irc.kde.org/#kdegames IRC] every month to talk about the games development. The New people a

[[/IRC Meeting|Next Meeting : 1st June]]

Last meetings' logs:
* [[/IRC Meeting-1stjune|1stjuneIRC Meeting]]

===akademy===

On the [http://conference2007.kde.org/ 2007's akademy], we will giving a common [http://conference2007.kde.org/conference/talks/31.php KDEgame's talk] managed by Mauricio Piacentini. Each kdegames dude will talk about what he did / is doing.

We have 30' for the presentation:
* 0' to 4' - Mauricio Piacentini (intro / KMahjongg)
* 4' to 7'30" - Paolo Capriotti (KBattleship)
* 7'30" to 11' - Maurizio Monge (KGameCanvas)
* 11' to 14'30" - Matt Williams (KSquares/KScoreDialog)
* 14'30" to 18' - Nicolas Roffet (KBlackbox/KSirtet??)
* 18' to 25' - Johann Ollivier Lapeyre and Eugene Trounev (Art and Release manager duties)
* 25' to 28'30" - Josef Spillner (KNewStuff2)
* 28'30" - Thanks and Q&A (possibly going informally into coffe break)

Presentation odp (Impress) including intro and initial slides (Mauricio Piacentini) can be found [http://www.tabuleiro.com/mauricio/kdegames_01.odp here]. You can use it to make your own slides, and we will collect and merge them all during Saturday's lunch. The laptop that will run the presentation will have Inkscape and versions of all kdegames for KDE3 and KDE4. There is no time to switch machines, so we will all use the same one.

For more discussion during aKademy we will also have a [http://akademy.kde.org/codingmarathon/bof.php BoF] on Wednesday, July 4th, from 11:00 to 12:00 AM.

===Agenda===

* akademy obviously, see above ^
* Development tutorials for libkdegames [[Development/Tutorials#Using_the_KDE_Games_Library]]

Projects/Edu (fr)

2007-06-30T06:12:04Z

Fatalerrors: -- oops just a little link to correct

{{Template:I18n/Language Navigation Bar|Projects/Edu}}
Logiciels éducatifs pour KDE

[[Projects/Edu/ProjectSuggestions|Suggestion pour le projet (en anglais)]]: une liste de suggestions pour de future projets éducatif (et certains non-éducatifs). Si vous êtes développeur, et que vous chercher quelque chose à faire, retenez des suggestions et voyez ce que vous pouvez faire avec ! :)

== Ressources de développement les applications ==

=== Langues ===
{| style="width:100%" border="0"
|-
|align="center"|[[Projects/Edu/KAnagram|KAnagram]] || align="center"|[[Projects/Edu/KHangman|KHangman]] || align="center"|[[Projects/Edu/Kiten|Kiten]] || align="center"|[[Projects/Edu/KLatin|KLatin]]
|-
|align="center"|[[Projects/Edu/KLettres|KLettres]] || align="center"|[[Projects/Edu/KVerbos|KVerbos]] || align="center"|[[Projects/Edu/KVocTrain|KVocTrain]]
|-
|}

=== Mathematiques ===
{| style="width:100%" border="0"
|-
|align="center"|[[Projects/Edu/KBruch|KBruch]] || align="center"|[[Projects/Edu/Kig|Kig]] || align="center"|[[Projects/Edu/KmPlot|KmPlot]] || align="center"|[[Projects/Edu/KPercentage|KPercentage]]
|-
|align="center"|[[Projects/Edu/Kalcul|Kalcul]] || align="center"|[[Projects/Edu/KMathTool|KMathTool]]
|-
|}

=== Divers ===
{| style="width:100%" border="0"
|-
|align="center"|[[Projects/Edu/blinKen|blinKen]] || align="center"|[[Projects/Edu/KGeography|KGeography]] || align="center"|[[Projects/Edu/KTouch|KTouch]] || align="center"|[[/KTurtle|KTurtle]]
|-
|align="center"|[[Projects/Edu/KWordQuiz|KWordQuiz]] || align="center"|[[Projects/Edu/Kard|Kard]] || align="center"|[[Projects/Edu/KidsPlay|KidsPlay]]
|-
|}

=== Science ===
{| style="width:100%" border="0"
|-
|align="center"|[[Projects/Edu/Kalzium|Kalzium]] || align="center"|[[Projects/Edu/KStars|KStars]]
|-
|}

=== Outils d'apprentissage ===
{| style="width:100%" border="0"
|-
|align="center"|[[Projects/Edu/KEduca|KEduca]]
|-
|}

== Ressources ==

Vous trouverez ici des ressources générique de développement pour KDE-Edu.

* [[Projects/Edu/Using_Custom_Fonts|Utiliser des fontes personnalisé]]

[[Category:education]]

Projects/Edu (fr)

2007-06-30T06:10:17Z

Fatalerrors:

{{Template:I18n/Language Navigation Bar|Projects/Edu}}
Logiciels éducatifs pour KDE

[[/ProjectSuggestions|Suggestion pour le projet]]: une liste de suggestions pour de future projets éducatif (et certains non-éducatifs). Si vous êtes développeur, et que vous chercher quelque chose à faire, retenez des suggestions et voyez ce que vous pouvez faire avec ! :)

== Ressources de développement les applications ==

=== Langues ===
{| style="width:100%" border="0"
|-
|align="center"|[[Projects/Edu/KAnagram|KAnagram]] || align="center"|[[Projects/Edu/KHangman|KHangman]] || align="center"|[[Projects/Edu/Kiten|Kiten]] || align="center"|[[Projects/Edu/KLatin|KLatin]]
|-
|align="center"|[[Projects/Edu/KLettres|KLettres]] || align="center"|[[Projects/Edu/KVerbos|KVerbos]] || align="center"|[[Projects/Edu/KVocTrain|KVocTrain]]
|-
|}

=== Mathematiques ===
{| style="width:100%" border="0"
|-
|align="center"|[[Projects/Edu/KBruch|KBruch]] || align="center"|[[Projects/Edu/Kig|Kig]] || align="center"|[[Projects/Edu/KmPlot|KmPlot]] || align="center"|[[Projects/Edu/KPercentage|KPercentage]]
|-
|align="center"|[[Projects/Edu/Kalcul|Kalcul]] || align="center"|[[Projects/Edu/KMathTool|KMathTool]]
|-
|}

=== Divers ===
{| style="width:100%" border="0"
|-
|align="center"|[[Projects/Edu/blinKen|blinKen]] || align="center"|[[Projects/Edu/KGeography|KGeography]] || align="center"|[[Projects/Edu/KTouch|KTouch]] || align="center"|[[/KTurtle|KTurtle]]
|-
|align="center"|[[Projects/Edu/KWordQuiz|KWordQuiz]] || align="center"|[[Projects/Edu/Kard|Kard]] || align="center"|[[Projects/Edu/KidsPlay|KidsPlay]]
|-
|}

=== Science ===
{| style="width:100%" border="0"
|-
|align="center"|[[Projects/Edu/Kalzium|Kalzium]] || align="center"|[[Projects/Edu/KStars|KStars]]
|-
|}

=== Outils d'apprentissage ===
{| style="width:100%" border="0"
|-
|align="center"|[[Projects/Edu/KEduca|KEduca]]
|-
|}

== Ressources ==

Vous trouverez ici des ressources générique de développement pour KDE-Edu.

* [[Projects/Edu/Using_Custom_Fonts|Utiliser des fontes personnalisé]]

[[Category:education]]

Projects/Edu

2007-06-30T06:00:36Z

Fatalerrors: add langage bar

{{Template:I18n/Language Navigation Bar|Projects/Edu}}
Educational Software for KDE

[[/ProjectSuggestions|Project Suggestions]]: a list of suggestions for future Edu (and some non-Edu) projects. If you're a developer, and in need of something to do, pick a suggestion and see what you can come up with! :)

== Developer Resources for Applications ==

=== Languages ===
{| style="width:100%" border="0"
|-
|align="center"|[[/KAnagram|KAnagram]] || align="center"|[[/KHangman|KHangman]] || align="center"|[[/Kiten|Kiten]] || align="center"|[[/KLatin|KLatin]]
|-
|align="center"|[[/KLettres|KLettres]] || align="center"|[[/KVerbos|KVerbos]] || align="center"|[[/KVocTrain|KVocTrain]]
|-
|}

=== Mathematics ===
{| style="width:100%" border="0"
|-
|align="center"|[[/KBruch|KBruch]] || align="center"|[[/Kig|Kig]] || align="center"|[[/KmPlot|KmPlot]] || align="center"|[[/KPercentage|KPercentage]]
|-
|align="center"|[[/Kalcul|Kalcul]] || align="center"|[[/KMathTool|KMathTool]]
|-
|}

=== Miscellaneous ===
{| style="width:100%" border="0"
|-
|align="center"|[[/blinKen|blinKen]] || align="center"|[[/KGeography|KGeography]] || align="center"|[[/KTouch|KTouch]] || align="center"|[[/KTurtle|KTurtle]]
|-
|align="center"|[[/KWordQuiz|KWordQuiz]] || align="center"|[[/Kard|Kard]] || align="center"|[[/KidsPlay|KidsPlay]]
|-
|}

=== Science ===
{| style="width:100%" border="0"
|-
|align="center"|[[/Kalzium|Kalzium]] || align="center"|[[/KStars|KStars]]
|-
|}

=== Teaching Tools ===
{| style="width:100%" border="0"
|-
|align="center"|[[/KEduca|KEduca]]
|-
|}

== Resources ==

Here you have generic development resources for KDE-Edu.

* [[/Using_Custom_Fonts|Using Custom Fonts]]

[[Category:education]]

Projects (fr)

2007-06-30T05:57:57Z

Fatalerrors:

{{Template:I18n/Language Navigation Bar|Projects}}
{| style="margin: 1em 2.5% 0 2.5%; padding: 0 5px;" cellpadding="5"
|-
|[[Image:Klogo-official-crystal.svg|noframe|left|40px]] ||
;[http://www.kde.org/getinvolved Soyez impliqué dans KDE]
:Informations générales pour vous impliquer dans les projets de KDE. Cela inclu un répertoire d'apprentissage pour différents projets.
|-
|[[Image:Action_book.svg|noframe|left|40px]] ||
;[[Projects/Edu_(fr)|Projets éducatifs de KDE]]
:Développer des logiciels éducatifs pour KDE.
|-
|[[Image:Devices_joystick.svg|noframe|left|40px]] ||
;[[Projects/Games_(fr)|Projets des jeux de KDE]]
:Développer des jeux de bureau pour KDE.
|-
|[[Image:Action_kontact_mail.svg|noframe|left|40px]] ||
;[[Projects/kdepim_(fr)|Projet PIM de KDE]]
: Système de gestion des informations personelles (PIM) de KDE.
|-
|[[Image:Klogo-official-crystal.svg|noframe|left|40px]] ||
;[[Projects/kde.org_(fr)|kde.org]]
:Information concernant les différents sites internet *.kde.org.
|-
|[[Image:Action_fileprint.svg|noframe|left|40px]] ||
;[[Projects/KDEPrint_(fr)|KDEPrint]]
:Informations relatives à l'impression dans KDE.
|-
|[[Image:Action_pencil.svg|noframe|left|40px]] ||
;[http://wiki.koffice.org KOffice.org]
:Développement d'une suite bureautique basé sur KDE.
|-
|[[Image:logo_oxygen.png|noframe|left|40px]] ||
;[[Projects/Oxygen_(fr)|Le projet Oxygen]]
:Oeuvres artistiques dans KDE4.
|-
|[[Image:Action_world.svg|noframe|left|40px]] ||
;[[Projects/Partners_(fr)|Programme de partenariat]]
:Programme de partenariat de KDE destiné aux fournisseurs indépendants de logiciels (ISV).
|-
| ||
;[[Projects/Plasma_(fr)|Plasma]]
:Le projet Plasma. Un nouveau cheminement vers le bureau.
|-
| ||
;[[Projects/Summer_of_Code_(fr)|Le projet "Été de code"]]
:Information sur le projet "Été de code" et perspectives relatives à KDE
|-
|[[Image:Kopete.svg|noframe|left|40px]] ||
;[[Projects/Kopete_(fr)|Kopete]]
:Kopete, le programme de messagerie instantané de KDE.
|-
|[[Image:superkaramba.png|noframe|left|40px]] ||
;[[Projects/SuperKaramba_(fr)|SuperKaramba]]
:SuperKaramba est un outil qui vous autorise à créé facilement des application visuelles interactives sur votre bureau KDE.
|-
| ||
;[[Projects/Okular_(fr)|Okular]]
:Okular, le visualisateur universel de document.
|-
| ||
;[[Projects/Widgets and Classes_(fr)|Widgets & Classes]]
:Widgets et classes qui ne se trouve pas dans kdelibs mais que vous pourrez trouver utiles.
|}

__NOTOC__

Getting Started/Build/KDE4 (fr)

2007-06-29T09:51:58Z

Fatalerrors: /* General troubleshooting */ -- traduction + ajout "rester à jours

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquets requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquets openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquets suivants (et leurs dépendences):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous arrez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

Vous pouvez utiliser tout les ebuilds stables récents mais rappelez vous de toujours synchroniser votre portage avant de commencer.

Il faut être démasqué et/ou conserver une version inférieure pour continuer ''(note du traducteur : à vérifier)''.

<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>

Ceux-ci sont les paquets que nous aurons besoins d'installer, certain pouvant être déja installé. Vous pourrez donc éviter l'installation de certain d'entre eux en ajoutant le paramètre de mise à jour à 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

Vous commencerez à compiler à la main à partir de la section [[Getting_Started/Build/KDE4#kdesupport|section kdesupport]].

Bonne chance !

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.60 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous avez une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
<code bash>
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 sub-src sub-tools
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;
</code>

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. '''Notez :''' Il vous faudra peut-être lancer la commande <tt>xhost +local:kde-devel</tt> en tant qu'utilisateur normal de KDE3 pour démarrer cette application. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== kdesupport ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|Mise en place de l'environnement]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Il existe plusieurs bibliothèques dont les applications KDE se servent dans le module appelé kdesupport. Ceci inclus Strigi et Soprano pour les recherche de fichiers et la création de métadata, eigen pour les effets visuels dans des applications tels que Kalzium, taglib pour les applications multimédia et qca pour certains besoins en cryptographie.

Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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/
cd kdesupport
cmakekde

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/kdesupport}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

Si vous avez :
CMake Error: Could NOT find REDLAND
alors il vous faudra librdf depuis Redland. Si votre distribution ne fournis pas le paquet librdf, vous pourrez trouver son code source ici : [http://download.librdf.org/source/] et le compiler. (Pour les utilisateurs de Gentoo: L'ebuild de librdf est appelé dev-libs/redland)

Si vous avez :
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
regardez [[Getting_Started/Sources/Using_Subversion_with_KDE|Utiliser Subversion avec KDE]]

Si vous avez :
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.
- - -
make: *** [install] Error 255
Vérifiez que les chemins sont corrects dans le fichier .bashrc décris plus haut.

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

cs #cs n'est pas une commande unix
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.
* Si vous avez : <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> cela signifie que vous avez compilé Qt sans le support de Qt3 (et le liens vers une bonne installation de Qt3 ne fonctionne pas).

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs
* Si vous obtenez l'erreur "‘XserverRegion’ does not name a type", vérifiez que vous avez les en-têtes de libxcomposite installé (libxcomposite-dev dans Ubuntu).

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/
Si vous le souhaiter répétez l'oppération pour chaque module :
cd <répertoire de base du module>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

== Rester à jours ==

Pour garder une installation de KDE4 à jours, chaque module installé doit êttre mis à jour de manière périodique. Le lundi étant le jour des grosses modifications sur kdelibs, le mardi est le meilleur jours pour le faire. Pour chaque module que vous contrôlerez utilisez les commandes "svn up" puis "make" et "make install".

Par exemple :
<code bash>
cs kdesupport # cs n'est pas une commande unix
svn up
cb # cb n'est pas une commande unix
make -j2 VERBOSE=1 && make install
</code>

== Problèmes généraux ==

Ce qu'il peut arriver après quelques temps, après quelques commandes <tt>svn up</tt>, est que certain des outils utilisés dans la chaîne de compilation de KDE peuvent changer de format de sortie. Par exemple, les fichiers <tt>kcfg</tt> sont lu par <tt>kconfig_compiler</tt> pour produire les dialogues de configuration. CMake ne peut détecter ces changements, et dans ce cas la compilation échoue. Une solution consiste à forcer la re-génération de tout ces fichiers :
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
Le même principe s'applique aux fichiers <tt>ui</tt> produits par le Qt designer.

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started/Build/KDE4 (fr)

2007-06-29T09:36:35Z

Fatalerrors: /* Générer localement la documentation de l'API */ -- typo correction

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquets requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquets openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquets suivants (et leurs dépendences):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous arrez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

Vous pouvez utiliser tout les ebuilds stables récents mais rappelez vous de toujours synchroniser votre portage avant de commencer.

Il faut être démasqué et/ou conserver une version inférieure pour continuer ''(note du traducteur : à vérifier)''.

<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>

Ceux-ci sont les paquets que nous aurons besoins d'installer, certain pouvant être déja installé. Vous pourrez donc éviter l'installation de certain d'entre eux en ajoutant le paramètre de mise à jour à 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

Vous commencerez à compiler à la main à partir de la section [[Getting_Started/Build/KDE4#kdesupport|section kdesupport]].

Bonne chance !

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.60 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous avez une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
<code bash>
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 sub-src sub-tools
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;
</code>

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. '''Notez :''' Il vous faudra peut-être lancer la commande <tt>xhost +local:kde-devel</tt> en tant qu'utilisateur normal de KDE3 pour démarrer cette application. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== kdesupport ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|Mise en place de l'environnement]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Il existe plusieurs bibliothèques dont les applications KDE se servent dans le module appelé kdesupport. Ceci inclus Strigi et Soprano pour les recherche de fichiers et la création de métadata, eigen pour les effets visuels dans des applications tels que Kalzium, taglib pour les applications multimédia et qca pour certains besoins en cryptographie.

Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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/
cd kdesupport
cmakekde

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/kdesupport}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

Si vous avez :
CMake Error: Could NOT find REDLAND
alors il vous faudra librdf depuis Redland. Si votre distribution ne fournis pas le paquet librdf, vous pourrez trouver son code source ici : [http://download.librdf.org/source/] et le compiler. (Pour les utilisateurs de Gentoo: L'ebuild de librdf est appelé dev-libs/redland)

Si vous avez :
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
regardez [[Getting_Started/Sources/Using_Subversion_with_KDE|Utiliser Subversion avec KDE]]

Si vous avez :
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.
- - -
make: *** [install] Error 255
Vérifiez que les chemins sont corrects dans le fichier .bashrc décris plus haut.

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

cs #cs n'est pas une commande unix
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.
* Si vous avez : <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> cela signifie que vous avez compilé Qt sans le support de Qt3 (et le liens vers une bonne installation de Qt3 ne fonctionne pas).

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs
* Si vous obtenez l'erreur "‘XserverRegion’ does not name a type", vérifiez que vous avez les en-têtes de libxcomposite installé (libxcomposite-dev dans Ubuntu).

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/
Si vous le souhaiter répétez l'oppération pour chaque module :
cd <répertoire de base du module>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

== General troubleshooting ==
''Note du traducteur: A traduire rapidement...''

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.

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started/Build/KDE4 (fr)

2007-06-29T09:32:08Z

Fatalerrors: /* En cas de problèmes */

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquets requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquets openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquets suivants (et leurs dépendences):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous arrez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

Vous pouvez utiliser tout les ebuilds stables récents mais rappelez vous de toujours synchroniser votre portage avant de commencer.

Il faut être démasqué et/ou conserver une version inférieure pour continuer ''(note du traducteur : à vérifier)''.

<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>

Ceux-ci sont les paquets que nous aurons besoins d'installer, certain pouvant être déja installé. Vous pourrez donc éviter l'installation de certain d'entre eux en ajoutant le paramètre de mise à jour à 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

Vous commencerez à compiler à la main à partir de la section [[Getting_Started/Build/KDE4#kdesupport|section kdesupport]].

Bonne chance !

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.60 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous avez une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
<code bash>
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 sub-src sub-tools
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;
</code>

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. '''Notez :''' Il vous faudra peut-être lancer la commande <tt>xhost +local:kde-devel</tt> en tant qu'utilisateur normal de KDE3 pour démarrer cette application. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== kdesupport ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|Mise en place de l'environnement]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Il existe plusieurs bibliothèques dont les applications KDE se servent dans le module appelé kdesupport. Ceci inclus Strigi et Soprano pour les recherche de fichiers et la création de métadata, eigen pour les effets visuels dans des applications tels que Kalzium, taglib pour les applications multimédia et qca pour certains besoins en cryptographie.

Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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/
cd kdesupport
cmakekde

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/kdesupport}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

Si vous avez :
CMake Error: Could NOT find REDLAND
alors il vous faudra librdf depuis Redland. Si votre distribution ne fournis pas le paquet librdf, vous pourrez trouver son code source ici : [http://download.librdf.org/source/] et le compiler. (Pour les utilisateurs de Gentoo: L'ebuild de librdf est appelé dev-libs/redland)

Si vous avez :
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
regardez [[Getting_Started/Sources/Using_Subversion_with_KDE|Utiliser Subversion avec KDE]]

Si vous avez :
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.
- - -
make: *** [install] Error 255
Vérifiez que les chemins sont corrects dans le fichier .bashrc décris plus haut.

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

cs #cs n'est pas une commande unix
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.
* Si vous avez : <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> cela signifie que vous avez compilé Qt sans le support de Qt3 (et le liens vers une bonne installation de Qt3 ne fonctionne pas).

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs
* Si vous obtenez l'erreur "‘XserverRegion’ does not name a type", vérifiez que vous avez les en-têtes de libxcomposite installé (libxcomposite-dev dans Ubuntu).

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/
Si vous le souhaiter répétez l'oppération pour chaque module :
cd <répertoire de base du module>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

== General troubleshooting ==
''Note du traducteur: A traduire rapidement...''

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.

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started/Build/KDE4 (fr)

2007-06-29T09:27:00Z

Fatalerrors: /* Procédure */

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquets requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquets openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquets suivants (et leurs dépendences):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous arrez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

Vous pouvez utiliser tout les ebuilds stables récents mais rappelez vous de toujours synchroniser votre portage avant de commencer.

Il faut être démasqué et/ou conserver une version inférieure pour continuer ''(note du traducteur : à vérifier)''.

<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>

Ceux-ci sont les paquets que nous aurons besoins d'installer, certain pouvant être déja installé. Vous pourrez donc éviter l'installation de certain d'entre eux en ajoutant le paramètre de mise à jour à 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

Vous commencerez à compiler à la main à partir de la section [[Getting_Started/Build/KDE4#kdesupport|section kdesupport]].

Bonne chance !

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.60 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous avez une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
<code bash>
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 sub-src sub-tools
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;
</code>

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. '''Notez :''' Il vous faudra peut-être lancer la commande <tt>xhost +local:kde-devel</tt> en tant qu'utilisateur normal de KDE3 pour démarrer cette application. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== kdesupport ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|Mise en place de l'environnement]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Il existe plusieurs bibliothèques dont les applications KDE se servent dans le module appelé kdesupport. Ceci inclus Strigi et Soprano pour les recherche de fichiers et la création de métadata, eigen pour les effets visuels dans des applications tels que Kalzium, taglib pour les applications multimédia et qca pour certains besoins en cryptographie.

Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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/
cd kdesupport
cmakekde

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/kdesupport}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

Si vous avez :
CMake Error: Could NOT find REDLAND
alors il vous faudra librdf depuis Redland. Si votre distribution ne fournis pas le paquet librdf, vous pourrez trouver son code source ici : [http://download.librdf.org/source/] et le compiler. (Pour les utilisateurs de Gentoo: L'ebuild de librdf est appelé dev-libs/redland)

Si vous avez :
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
regardez [[Getting_Started/Sources/Using_Subversion_with_KDE|Utiliser Subversion avec KDE]]

Si vous avez :
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.
- - -
make: *** [install] Error 255
Vérifiez que les chemins sont corrects dans le fichier .bashrc décris plus haut.

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

cs #cs n'est pas une commande unix
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.
* Si vous avez : <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> cela signifie que vous avez compilé Qt sans le support de Qt3 (et le liens vers une bonne installation de Qt3 ne fonctionne pas).

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/
Si vous le souhaiter répétez l'oppération pour chaque module :
cd <répertoire de base du module>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

== General troubleshooting ==
''Note du traducteur: A traduire rapidement...''

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.

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started/Build/KDE4 (fr)

2007-06-29T09:24:38Z

Fatalerrors: /* En cas de difficultés */

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquets requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquets openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquets suivants (et leurs dépendences):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous arrez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

Vous pouvez utiliser tout les ebuilds stables récents mais rappelez vous de toujours synchroniser votre portage avant de commencer.

Il faut être démasqué et/ou conserver une version inférieure pour continuer ''(note du traducteur : à vérifier)''.

<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>

Ceux-ci sont les paquets que nous aurons besoins d'installer, certain pouvant être déja installé. Vous pourrez donc éviter l'installation de certain d'entre eux en ajoutant le paramètre de mise à jour à 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

Vous commencerez à compiler à la main à partir de la section [[Getting_Started/Build/KDE4#kdesupport|section kdesupport]].

Bonne chance !

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.60 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous avez une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
<code bash>
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 sub-src sub-tools
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;
</code>

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. '''Notez :''' Il vous faudra peut-être lancer la commande <tt>xhost +local:kde-devel</tt> en tant qu'utilisateur normal de KDE3 pour démarrer cette application. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== kdesupport ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|Mise en place de l'environnement]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Il existe plusieurs bibliothèques dont les applications KDE se servent dans le module appelé kdesupport. Ceci inclus Strigi et Soprano pour les recherche de fichiers et la création de métadata, eigen pour les effets visuels dans des applications tels que Kalzium, taglib pour les applications multimédia et qca pour certains besoins en cryptographie.

Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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/
cd kdesupport
cmakekde

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/kdesupport}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

Si vous avez :
CMake Error: Could NOT find REDLAND
alors il vous faudra librdf depuis Redland. Si votre distribution ne fournis pas le paquet librdf, vous pourrez trouver son code source ici : [http://download.librdf.org/source/] et le compiler. (Pour les utilisateurs de Gentoo: L'ebuild de librdf est appelé dev-libs/redland)

Si vous avez :
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
regardez [[Getting_Started/Sources/Using_Subversion_with_KDE|Utiliser Subversion avec KDE]]

Si vous avez :
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.
- - -
make: *** [install] Error 255
Vérifiez que les chemins sont corrects dans le fichier .bashrc décris plus haut.

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.
* Si vous avez : <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> cela signifie que vous avez compilé Qt sans le support de Qt3 (et le liens vers une bonne installation de Qt3 ne fonctionne pas).

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/
Si vous le souhaiter répétez l'oppération pour chaque module :
cd <répertoire de base du module>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

== General troubleshooting ==
''Note du traducteur: A traduire rapidement...''

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.

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Projects (fr)

2007-06-25T10:15:48Z

Fatalerrors:

{{Template:I18n/Language Navigation Bar|Projects}}
{| style="margin: 1em 2.5% 0 2.5%; padding: 0 5px;" cellpadding="5"
|-
|[[Image:Klogo-official-crystal.svg|noframe|left|40px]] ||
;[http://www.kde.org/getinvolved Get Involved with KDE]
:General information for getting involved with KDE projects. Includes a mentor directory for many projects.
|-
|[[Image:Action_book.svg|noframe|left|40px]] ||
;[[/Edu|KDE Education Project]]
:Developing educational software for KDE.
|-
|[[Image:Devices_joystick.svg|noframe|left|40px]] ||
;[[/Games|KDE Games Project]]
:Developing desktop's games for KDE.
|-
|[[Image:Action_kontact_mail.svg|noframe|left|40px]] ||
;[[/kdepim|KDE PIM Project]]
:KDE Personal Information Management.
|-
|[[Image:Klogo-official-crystal.svg|noframe|left|40px]] ||
;[[/kde.org|kde.org]]
:Information around the *.kde.org websites.
|-
|[[Image:Action_fileprint.svg|noframe|left|40px]] ||
;[[/KDEPrint|KDEPrint]]
:Printing related information for KDE.
|-
|[[Image:Action_pencil.svg|noframe|left|40px]] ||
;[http://wiki.koffice.org KOffice.org]
:Developing an Office suite based on KDE.
|-
|[[Image:logo_oxygen.png|noframe|left|40px]] ||
;[[/Oxygen|The Oxygen Project]]
:Artwork for KDE4.
|-
|[[Image:Action_world.svg|noframe|left|40px]] ||
;[[/Partners|Partner Program]]
:KDE partner program targetting ISVs.
|-
| ||
;[[/Plasma|Plasma]]
:Plasma project. A new way to desktop. (Yes, it's now a verb)
|-
| ||
;[[/Summer_of_Code|Summer of Code Projects]]
:Information on Summer of Code projects and prospects related to KDE
|-
|[[Image:Kopete.svg|noframe|left|40px]] ||
;[[/Kopete|Kopete]]
:Kopete, the KDE Instant Messaging program.
|-
|[[Image:superkaramba.png|noframe|left|40px]] ||
;[[/SuperKaramba|SuperKaramba]]
:SuperKaramba is a tool that allows you to easily create interactive eye-candy on your KDE desktop.
|-
| ||
;[[/Okular|Okular]]
:Okular, the unified document viewer.
|-
| ||
;[[/Widgets and Classes|Widgets & Classes]]
:Widgets and classes that are not in kdelibs but which you may find useful.
|}

__NOTOC__

Projects

2007-06-25T10:14:56Z

Fatalerrors: add langage bar

{{Template:I18n/Language Navigation Bar|Projects}}
{| style="margin: 1em 2.5% 0 2.5%; padding: 0 5px;" cellpadding="5"
|-
|[[Image:Klogo-official-crystal.svg|noframe|left|40px]] ||
;[http://www.kde.org/getinvolved Get Involved with KDE]
:General information for getting involved with KDE projects. Includes a mentor directory for many projects.
|-
|[[Image:Action_book.svg|noframe|left|40px]] ||
;[[/Edu|KDE Education Project]]
:Developing educational software for KDE.
|-
|[[Image:Devices_joystick.svg|noframe|left|40px]] ||
;[[/Games|KDE Games Project]]
:Developing desktop's games for KDE.
|-
|[[Image:Action_kontact_mail.svg|noframe|left|40px]] ||
;[[/kdepim|KDE PIM Project]]
:KDE Personal Information Management.
|-
|[[Image:Klogo-official-crystal.svg|noframe|left|40px]] ||
;[[/kde.org|kde.org]]
:Information around the *.kde.org websites.
|-
|[[Image:Action_fileprint.svg|noframe|left|40px]] ||
;[[/KDEPrint|KDEPrint]]
:Printing related information for KDE.
|-
|[[Image:Action_pencil.svg|noframe|left|40px]] ||
;[http://wiki.koffice.org KOffice.org]
:Developing an Office suite based on KDE.
|-
|[[Image:logo_oxygen.png|noframe|left|40px]] ||
;[[/Oxygen|The Oxygen Project]]
:Artwork for KDE4.
|-
|[[Image:Action_world.svg|noframe|left|40px]] ||
;[[/Partners|Partner Program]]
:KDE partner program targetting ISVs.
|-
| ||
;[[/Plasma|Plasma]]
:Plasma project. A new way to desktop. (Yes, it's now a verb)
|-
| ||
;[[/Summer_of_Code|Summer of Code Projects]]
:Information on Summer of Code projects and prospects related to KDE
|-
|[[Image:Kopete.svg|noframe|left|40px]] ||
;[[/Kopete|Kopete]]
:Kopete, the KDE Instant Messaging program.
|-
|[[Image:superkaramba.png|noframe|left|40px]] ||
;[[/SuperKaramba|SuperKaramba]]
:SuperKaramba is a tool that allows you to easily create interactive eye-candy on your KDE desktop.
|-
| ||
;[[/Okular|Okular]]
:Okular, the unified document viewer.
|-
| ||
;[[/Widgets and Classes|Widgets & Classes]]
:Widgets and classes that are not in kdelibs but which you may find useful.
|}

__NOTOC__

ISV/Roadmap (fr)

2007-06-25T10:12:53Z

Fatalerrors:

{{Template:I18n/Language Navigation Bar|ISV/Roadmap}}
This page intends to help '''Independent Software Vendors''' (ISVs) understanding the background of the KDE Roadmap.

== KDE stable releases ==

The current KDE release is KDE version 3.5.6. Based on the knowledge and experiences of the first KDE 3.x releases the KDE 3.5 series is a well matured and stable platform to rely on.

The development of the KDE 3.5.x series will continue to improve this platform without breaking any compatibility, ensuring that every developer can rely on it. Different from previous KDE release, however, the KDE 3.5.x series will include selected new features to include new technologies and provide new possibilities while the long KDE 4 development cycle takes place.

The Roadmap of KDE 3.5.x is divided into the [[Schedules/KDE_3.5_Release_Schedule|Release Schedule]] and the [http://developer.kde.org/development-versions/kde-3.5-features.html Feature Plan].

== KDE development ==

The current KDE development concentrates on KDE 4, which will be a major release. It will include several new features as well as new APIs and frameworks and therefore will break the API compatibility. However, at the same time there are several efforts in the community making porting apps to KDE 4 quite easy.

The Roadmap of KDE 4 is divided into the [[Schedules/KDE_4.0_Release_Schedule| Release Schedule]] and the [http://developer.kde.org/development-versions/kde-4.0-features.html Feature Plan].

== Sub-projects ==

Some KDE sub-projects have their own roadmaps:
* [http://multimedia.kde.org/roadmap.php KDE Multimedia project] - supported by [http://phonon.kde.org/ Phonon], a new multimedia API.
* [http://koffice.kde.org/developer/ KOffice] - a free, integrated office suite for KDE

[[Category:ISV]]

ISV/Roadmap

2007-06-25T10:12:13Z

Fatalerrors: add langage bar

ISV/KDE Community (fr)

2007-06-25T10:07:07Z

Fatalerrors:

{{Template:I18n/Language Navigation Bar|ISV/KDE Community}}
{{improve}}

KDE attracts many people with different backgrounds. As such, the day-by-day growing KDE community includes many '''developers''', '''translators''', '''artists''' as well as '''usability and accessibility experts''' and - of course - '''lots of users'''. For several years now all those people are welcome to meet at the '''annual KDE Conference [http://akademy.kde.org/ aKademy]''' to discuss KDE related topics and shape the ''roadmap'' for future development.

ISV/KDE Community

2007-06-25T10:06:39Z

Fatalerrors: ooops

ISV/KDE Community

2007-06-25T10:05:49Z

Fatalerrors: add langage bar

{{Template:I18n/Language Navigation Bar|ISV}}
{{improve}}

KDE attracts many people with different backgrounds. As such, the day-by-day growing KDE community includes many '''developers''', '''translators''', '''artists''' as well as '''usability and accessibility experts''' and - of course - '''lots of users'''. For several years now all those people are welcome to meet at the '''annual KDE Conference [http://akademy.kde.org/ aKademy]''' to discuss KDE related topics and shape the ''roadmap'' for future development.

ISV/Developer Information (fr)

2007-06-25T10:03:45Z

Fatalerrors:

{{Template:I18n/Language Navigation Bar|ISV/Developer Information}}
== Tools ==
*You can use the [http://subversion.tigris.org Subversion] version control system to access the KDE source repository.
*There is a list of tools available, that can be used for developing KDE applications. These include low-level debuggers, as well as the KDevelop *Integrated Development Environment (IDE), and various design programs.
*You may also want to read the Compilation FAQ.
*Several volumes of [[Development|development documentation]] will help you getting started with your development.

== Libraries and Interfaces ==
=== DCOP and D-Bus ===
* '''DCOP''' is the message bus built into KDE 3, that is used for inter-process communication (IPC) between different KDE applications. DCOP can be used in order to remotely control KDE applications from your own application or to provide scriptable interfaces for your own application.

*[http://developer.kde.org/documentation/tutorials/dot/dcopiface/dcop-interface.html Creating a DCOP Interface] <br />''This tutorial shows you how to create a DCOP interface to a KDE application.''

*[http://developer.kde.org/documentation/tutorials/automation/index.html KDE Automation writeup]<br />''Document by Olaf Zanger showing an overview of the scripting capabilities in KDE 2.x. Includes usage of "dcop", "kdcop", scripting languages, xmlrpc, and a FAQ.''

*[http://www-106.ibm.com/developerworks/linux/library/l-dcop/index.html?ca=dgr-kdeml01KDEDCOP Connect KDE applications using DCOP]<br />''IBM DeveloperWorks tutorial, shows how to use kdcop and dcop with several examples such as instantly messaging a contact in kopete when he comes online, and also how to create a simple DCOP-aware application.''
D-Bus will be the message bus used in KDE 4.
*[[Development/Tutorials#D-Bus|D-Bus Tutorials]]<br/>''This tutorials show what D-Bus is and how to use it.<br/>See also: [http://dbus.freedesktop.org/doc/dbus-tutorial.html D-Bus tutorial] at freedesktop.org.''

=== KIO-Slaves ===

KDE is network transparent. This means that each application can access files via many network protocols just as if they were stored locally. There exist access modules (KIO-Slaves) for Samba (Windows Shares), HTTP, FTP and many other protocols.
*[http://developer.kde.org/documentation/design/kde/ioslaves/index.html Using IOSlaves]<br />''IOSlaves are the subprocesses KDE uses to fetch remote files without blocking the user interface. This document discusses how they work and how to use them. (Somewhat dated, but might still be useful).''

=== Portland: xdg-utils and DAPI ===

KDE actively supports [http://developer.kde.org/portland/ The Portland Project] aiming at making cross-desktop application development easier. For more information on this fairly young project, please refer to [http://portland.freedesktop.org The Portland Project's] website hosted on [http://www.freedesktop.org Freedesktop.org].

ISV/Developer Information

2007-06-25T10:03:02Z

Fatalerrors: add langage bar

ISV/Licensing (fr)

2007-06-25T10:00:46Z

Fatalerrors:

{{Template:I18n/Language Navigation Bar|ISV/Licensing}}
=== Licensing ===
An often arising question is: ''Can I use KDE to develop commercial applications?'' - '''Yes, you can develop commercial applications for KDE'''. KDE's foundation libraries {{path|kdelibs}} and {{path|kdepimlibs}}, as well as KOffice libraries and other major supporting applications, are licensed under the [http://www.gnu.org/copyleft/lesser.html LGPL]. The [http://www.gnu.org/copyleft/lesser.html LGPL] allows the linking of closed source applications against those libraries. Though, a [http://www.trolltech.com/products/qt/licenses Qt developer license] is required for closed source development.

[[Category:ISV]]

ISV/Licensing

2007-06-25T10:00:06Z

Fatalerrors: add langage bar

ISV/Support

2007-06-25T09:57:54Z

Fatalerrors: ooops

{{Template:I18n/Language Navigation Bar|ISV/Support}}
== Community-Based Support==

There are e-mail discussion lists for almost all topics surrounding KDE. An overview of these lists can be found [http://www.kde.org/mailinglists/ here].

Particularly the [http://mail.kde.org/mailman/listinfo/kde-devel kde-devel mailing list] is of interest to everybody who want to develop KDE-based applications or want to develop for KDE itself.

Please keep in mind that all these lists are largely driven by volunteers - demands and threats are sometimes met with cynicism and rejection, while technical questions and legit criticism is usually dealt with quickly and nicely.

== Commercial Support ==

If you need guaranteed response times and business level support, there are several options to chose from:

[http://www.trolltech.com Trolltech] provides [http://www.trolltech.com/support commercial support] for their [http://www.trolltech.com/products/qt Qt-Toolkit], on which KDE is based.

A list of companies supporting KDE can be found in KDEs [http://enterprise.kde.org/bizdir/ Business Directory].

[[Category:ISV]]

ISV/Support (fr)

2007-06-25T09:57:17Z

Fatalerrors: ooops

ISV/Support (fr)

2007-06-25T09:56:28Z

Fatalerrors:

{{Template:I18n/Language Navigation Bar|ISV}}
== Community-Based Support==

There are e-mail discussion lists for almost all topics surrounding KDE. An overview of these lists can be found [http://www.kde.org/mailinglists/ here].

Particularly the [http://mail.kde.org/mailman/listinfo/kde-devel kde-devel mailing list] is of interest to everybody who want to develop KDE-based applications or want to develop for KDE itself.

Please keep in mind that all these lists are largely driven by volunteers - demands and threats are sometimes met with cynicism and rejection, while technical questions and legit criticism is usually dealt with quickly and nicely.

== Commercial Support ==

If you need guaranteed response times and business level support, there are several options to chose from:

[http://www.trolltech.com Trolltech] provides [http://www.trolltech.com/support commercial support] for their [http://www.trolltech.com/products/qt Qt-Toolkit], on which KDE is based.

A list of companies supporting KDE can be found in KDEs [http://enterprise.kde.org/bizdir/ Business Directory].

[[Category:ISV]]

ISV/Support

2007-06-25T09:56:00Z

Fatalerrors: add langage bar

ISV/Why use KDE (fr)

2007-06-25T09:53:54Z

Fatalerrors:

{{Template:I18n/Language Navigation Bar|ISV/Why use KDE}}
This page intends to help '''Independent Software Vendors (ISVs)''' getting into KDE related topics. This includes companies developing commercial applications as well as other Open Source Projects.

== The KDE Community ==
The KDE project attracts many people with different backgrounds. As such, the day-by-day growing KDE community includes many '''developers''', '''translators''', '''artists''' as well as '''usability and accessibility experts''' and - of course - '''lots of users'''. For several years now all those people are welcome to meet at the '''annual KDE Conference [http://akademy.kde.org/ aKademy]''' to discuss KDE related topics and shape the ''roadmap'' for future development.

== KDE e.V. ==
The non-profit organization [http://ev.kde.org KDE e.V.] helps in creating and distributing KDE by securing cash, hardware, and other donations, then using donations to aid KDE development and promotion. All its members are part of the KDE community which means the KDE e.V. plays an important role in the KDE project. Members of the KDE e.V. form several '''working groups''' like the [http://www.spreadkde.org/handbook/mwg/charter Marketing Working Group (MWG)] and the [http://ev.kde.org/workinggroups/hci.php Human-Computer Interaction (HCI) Working Group] to help realize KDE's vision.

== Adoption of KDE ==
KDE is one of the biggest Open Source projects making the Linux/UNIX desktop's experience much more user friendly. As such, distributions strongly support KDE by actively taking part in its development process and ship KDE as their default desktop environment. Many companies use KDE for production use.

== Development ==
The KDE development process takes place in steady release cycles. '''[http://developer.kde.org/development-versions/release.html Release schedules]''' and '''feature plans''' help the KDE project coordinating a KDE release by introducing several ''phases'' like ''feature freeze'' and ''message freeze''. This phases make sure that developers concentrate on polishing the release and the translation teams have time enough to translate all the KDE software into many different languages. Further information about KDE development tools can be found on the [[Development|development pages]].

=== Documentation ===
The KDE project provides excellent documentation about its API and its technologies, such as KParts or KXmlGui. There are many '''Tutorials and HOWTOs''' which help getting into KDE development. An overview can be found at the [[Development|development pages]].

=== Technologies ===
KDE provides a wide range of '''powerful technologies''' such as [http://khtml.info KHTML and KJS] which are adopted by other companies like Apple (Safari browsers) and Nokia. Additionally there are several '''development frameworks''' like KParts (KDE's component technology), KIO (network/protocol architecture) or KXmlGui (build GUIs based on XML definitions).

KDE uses '''well-known standards''' like DCOP in KDE 3 or [http://hal.freedesktop.org HAL (Hardware Abstraction Layer)] and [http://dbus.freedesktop.org D-Bus] (interprocess communication) in upcoming KDE 4.

=== Compatibility & Integration ===
The last major KDE release was KDE 3. All KDE 3.x versions are '''binary compatible''', i.e. software written five years ago is compatible to the latest stable release KDE 3.5. As KDE is based on standards it is for instance easy to integrate applications with plain [http://todo-link-to-howto .desktop files].

==== Freedesktop.org & Portland ====
As an ISV, your target is probably not only KDE but all Linux/UNIX desktops. This is made possible due to '''strong collaboration between KDE and other projects''' like [http://freedesktop.org freedesktop.org] which defines standards and software that helps integrating applications in all standard conform desktop environments.

One of those projects is the [http://developer.kde.org/portland/ Portland project], which intends to develop a common set of Linux Desktop Programming Interfaces and Tools to allow applications to '''easily integrate''' with the free desktop configuration an end user has chosen to work with.

=== Sub-Projects ===
KDE has many sub-projects to more specifically coordinate unique project goals of major supporting applications. Several of these significant projects are noted below:

; KDE Pim
: The goal of [http://pim.kde.org KDE Pim] (Personal information management) is to provide an application suite to manage personal information. This includes applications like an email client, a calender etc. The main result is '''KDE Kontact''', our personal information manager.

; KOffice
: [http://koffice.kde.org KOffice] is an '''integrated office suite''' using KDE-technology and features a full set of applications which work together seamlessly to provide the best user experience possible. The office suite contains applications like KWord, KSpread, KPresenter, Krita and many more.

; KDevelop
: [http://kdevelop.kde.org KDevelop] is an '''Integrated Development Environment''' (IDE) for KDE. It supports language like C/C++ and Java and helps with rapid application development.

=== Licensing ===
An often arising question is: ''Can I use KDE to develop commercial applications?'' - '''Yes, you can develop commercial applications for KDE'''. KDE's foundation libraries {{path|kdelibs}} and {{path|kdepimlibs}} but also KOffice libraries and several of its major apps are licensed under the LGPL, which means you can link closed source applications against those libraries. A valid Qt developer license is required for closed source development, however.

== Roadmap ==
KDE development follows a release schedule in order to coordinate releases. These usually cover for minor releases the last 10 weeks and for major releases the last 20 weeks before the official release. The features planned for a release are usually published at the same time as the schedule.

Further details can be found in the [[../Roadmap|roadmap page]].

[[Category:ISV]]

ISV/Why use KDE

2007-06-25T09:53:19Z

Fatalerrors: add langage bar

ISV (fr)

2007-06-25T09:51:53Z

Fatalerrors: notoc

__NOTOC__
{{Template:I18n/Language Navigation Bar|ISV}}
Bienvenue au Guide pour les Fournisseurs Indépendant de Logiciels (ISV).

Cette page présentes un aperçu des pages des développeurs KDE, en particulier pour les les Fournisseurs Indépendant de Logiciels qu'ils soient intéressés par l'adoption du K Desktop Environment pour une utilisation quotidienne, ou qu'ils veulent réaliser leurs logiciels avec une bonne intégration dans KDE.



Il existe un certain nombre de sections qui pourraient vous intéresser :

<table width="100%" style="border-collapse:separate; border-spacing:10px;">
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Why use KDE_(fr)|Pourquoi utiliser KDE?]]</h3>
Apprenez pourquoi KDE est le bon choix.</td>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Support_(fr)|Obtenir du support]]</h3>
Apprenez comment obtenir du support.</td>
</tr>
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Licensing_(fr)|Licence]]</h3>
Informez vous des licences que KDE utilise.</td>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Developer Information_(fr)|Outils et Bibliothèques]]</h3>
Découvrez les outils utiles et les bibliothèques.</td>
</tr>
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/KDE Community_(fr)|Communauté KDE]]</h3>
Regardez qui sont les ''forces conductrices'' derrière KDE.</td>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[http://enterprise.kde.org/bizcase/ Déploiements réussis]</h3>
Apprenez quel sont les déploiements KDE réussis.</td>
</tr>
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;" colspan="2">

<h3 style="text-align:center;">[[ISV/Roadmap_(fr)|Feuille de route]]</h3>
Apprenez quel sont les versions et le calendrier des nouvelles fonctionnalités.</td>
</tr>
</table>



[[Category:ISV]]

ISV

2007-06-25T09:50:56Z

Fatalerrors: add notoc for a better look ;)

__NOTOC__
{{Template:I18n/Language Navigation Bar|ISV}}
Welcome to the guide for Independent Software Vendors.

This page presents an overview about KDE's developer pages in particular for Independent Software Vendors (ISVs) who either are interested in adopting the K Desktop Environment for daily use or want to release their software with seamless integration into KDE.



There are several sections you might be interested in:

<table width="100%" style="border-collapse:separate; border-spacing:10px;">
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Why use KDE|Why use KDE?]]</h3>
Read more about why KDE is the right choice.</td>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Support|Getting Support]]</h3>
Read more about how to get support.</td>
</tr>
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Licensing|Licensing]]</h3>
Read more about the licenses KDE is using.</td>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Developer Information|Tools and Libraries]]</h3>
Read more about useful tools and libraries.</td>
</tr>
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/KDE Community|KDE Community]]</h3>
Read more about the ''driving forces'' behind KDE.</td>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[http://enterprise.kde.org/bizcase/ Success Stories]</h3>
Read more about successful KDE deployments.</td>
</tr>
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;" colspan="2">
<h3 style="text-align:center;">[[ISV/Roadmap|Roadmap]]</h3>
Read more about the release and features schedules.</td>
</tr>
</table>



[[Category:ISV]]

ISV (fr)

2007-06-25T09:48:43Z

Fatalerrors: Succès existant --> déploiements réussis (plus cohérent)

{{Template:I18n/Language Navigation Bar|ISV}}
Bienvenue au Guide pour les Fournisseurs Indépendant de Logiciels (ISV).

Cette page présentes un aperçu des pages des développeurs KDE, en particulier pour les les Fournisseurs Indépendant de Logiciels qu'ils soient intéressés par l'adoption du K Desktop Environment pour une utilisation quotidienne, ou qu'ils veulent réaliser leurs logiciels avec une bonne intégration dans KDE.



Il existe un certain nombre de sections qui pourraient vous intéresser :

<table width="100%" style="border-collapse:separate; border-spacing:10px;">
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Why use KDE_(fr)|Pourquoi utiliser KDE?]]</h3>
Apprenez pourquoi KDE est le bon choix.</td>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Support_(fr)|Obtenir du support]]</h3>
Apprenez comment obtenir du support.</td>
</tr>
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Licensing_(fr)|Licence]]</h3>
Informez vous des licences que KDE utilise.</td>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Developer Information_(fr)|Outils et Bibliothèques]]</h3>
Découvrez les outils utiles et les bibliothèques.</td>
</tr>
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/KDE Community_(fr)|Communauté KDE]]</h3>
Regardez qui sont les ''forces conductrices'' derrière KDE.</td>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[http://enterprise.kde.org/bizcase/ Déploiements réussis]</h3>
Apprenez quel sont les déploiements KDE réussis.</td>
</tr>
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;" colspan="2">

<h3 style="text-align:center;">[[ISV/Roadmap_(fr)|Feuille de route]]</h3>
Apprenez quel sont les versions et le calendrier des nouvelles fonctionnalités.</td>
</tr>
</table>



[[Category:ISV]]

ISV (fr)

2007-06-25T09:45:15Z

Fatalerrors:

{{Template:I18n/Language Navigation Bar|ISV}}
Bienvenue au Guide pour les Fournisseurs Indépendant de Logiciels (ISV).

Cette page présentes un aperçu des pages des développeurs KDE, en particulier pour les les Fournisseurs Indépendant de Logiciels qu'ils soient intéressés par l'adoption du K Desktop Environment pour une utilisation quotidienne, ou qu'ils veulent réaliser leurs logiciels avec une bonne intégration dans KDE.



Il existe un certain nombre de sections qui pourraient vous intéresser :

<table width="100%" style="border-collapse:separate; border-spacing:10px;">
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Why use KDE_(fr)|Pourquoi utiliser KDE?]]</h3>
Apprenez pourquoi KDE est le bon choix.</td>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Support_(fr)|Obtenir du support]]</h3>
Apprenez comment obtenir du support.</td>
</tr>
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Licensing_(fr)|Licence]]</h3>
Informez vous des licences que KDE utilise.</td>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Developer Information_(fr)|Outils et Bibliothèques]]</h3>
Découvrez les outils utiles et les bibliothèques.</td>
</tr>
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/KDE Community_(fr)|Communauté KDE]]</h3>
Regardez qui sont les ''forces conductrices'' derrière KDE.</td>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[http://enterprise.kde.org/bizcase/ Succès existant]</h3>
Apprenez quel sont les déploiements KDE réussis.</td>
</tr>
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;" colspan="2">
<h3 style="text-align:center;">[[ISV/Roadmap_(fr)|Feuille de route]]</h3>
Apprenez quel sont les versions et le calendrier des nouvelles fonctionnalités.</td>
</tr>
</table>



[[Category:ISV]]

ISV

2007-06-25T09:22:41Z

Fatalerrors: just a little mistake

{{Template:I18n/Language Navigation Bar|ISV}}
Welcome to the guide for Independent Software Vendors.

This page presents an overview about KDE's developer pages in particular for Independent Software Vendors (ISVs) who either are interested in adopting the K Desktop Environment for daily use or want to release their software with seamless integration into KDE.



There are several sections you might be interested in:

<table width="100%" style="border-collapse:separate; border-spacing:10px;">
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Why use KDE|Why use KDE?]]</h3>
Read more about why KDE is the right choice.</td>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Support|Getting Support]]</h3>
Read more about how to get support.</td>
</tr>
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Licensing|Licensing]]</h3>
Read more about the licenses KDE is using.</td>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Developer Information|Tools and Libraries]]</h3>
Read more about useful tools and libraries.</td>
</tr>
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/KDE Community|KDE Community]]</h3>
Read more about the ''driving forces'' behind KDE.</td>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[http://enterprise.kde.org/bizcase/ Success Stories]</h3>
Read more about successful KDE deployments.</td>
</tr>
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;" colspan="2">
<h3 style="text-align:center;">[[ISV/Roadmap|Roadmap]]</h3>
Read more about the release and features schedules.</td>
</tr>
</table>



[[Category:ISV]]

ISV (fr)

2007-06-25T09:21:00Z

Fatalerrors:

{{Template:I18n/Language Navigation Bar|ISV}}
me to the guide for Independent Software Vendors.

This page presents an overview about KDE's developer pages in particular for Independent Software Vendors (ISVs) who either are interested in adopting the K Desktop Environment for daily use or want to release their software with seamless integration into KDE.



There are several sections you might be interested in:

<table width="100%" style="border-collapse:separate; border-spacing:10px;">
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Why use KDE|Why use KDE?]]</h3>
Read more about why KDE is the right choice.</td>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Support|Getting Support]]</h3>
Read more about how to get support.</td>
</tr>
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Licensing|Licensing]]</h3>
Read more about the licenses KDE is using.</td>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/Developer Information|Tools and Libraries]]</h3>
Read more about useful tools and libraries.</td>
</tr>
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[[ISV/KDE Community|KDE Community]]</h3>
Read more about the ''driving forces'' behind KDE.</td>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;">
<h3 style="text-align:center;">[http://enterprise.kde.org/bizcase/ Success Stories]</h3>
Read more about successful KDE deployments.</td>
</tr>
<tr>
<td align="center" style="border: solid 1px #1e90ff; background-color:#f8f8ff; padding:0 1em 1em 1em;" colspan="2">
<h3 style="text-align:center;">[[ISV/Roadmap|Roadmap]]</h3>
Read more about the release and features schedules.</td>
</tr>
</table>



[[Category:ISV]]

ISV

2007-06-25T09:19:29Z

Fatalerrors: add langage bar

Getting Started/Build/KDE4 (fr)

2007-06-24T18:15:44Z

Fatalerrors: /* General troubleshooting */

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquets requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquets openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquets suivants (et leurs dépendences):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous arrez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

Vous pouvez utiliser tout les ebuilds stables récents mais rappelez vous de toujours synchroniser votre portage avant de commencer.

Il faut être démasqué et/ou conserver une version inférieure pour continuer ''(note du traducteur : à vérifier)''.

<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>

Ceux-ci sont les paquets que nous aurons besoins d'installer, certain pouvant être déja installé. Vous pourrez donc éviter l'installation de certain d'entre eux en ajoutant le paramètre de mise à jour à 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

Vous commencerez à compiler à la main à partir de la section [[Getting_Started/Build/KDE4#kdesupport|section kdesupport]].

Bonne chance !

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.60 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous n'avez pas une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
<code bash>
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 sub-src sub-tools
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;
</code>

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. '''Notez :''' Il vous faudra peut-être lancer la commande <tt>xhost +local:kde-devel</tt> en tant qu'utilisateur normal de KDE3 pour démarrer cette application. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== kdesupport ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|Mise en place de l'environnement]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Il existe plusieurs bibliothèques dont les applications KDE se servent dans le module appelé kdesupport. Ceci inclus Strigi et Soprano pour les recherche de fichiers et la création de métadata, eigen pour les effets visuels dans des applications tels que Kalzium, taglib pour les applications multimédia et qca pour certains besoins en cryptographie.

Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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/
cd kdesupport
cmakekde

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/kdesupport}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

Si vous avez :
CMake Error: Could NOT find REDLAND
alors il vous faudra librdf depuis Redland. Si votre distribution ne fournis pas le paquet librdf, vous pourrez trouver son code source ici : [http://download.librdf.org/source/] et le compiler. (Pour les utilisateurs de Gentoo: L'ebuild de librdf est appelé dev-libs/redland)

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.
* Si vous avez : <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> cela signifie que vous avez compilé Qt sans le support de Qt3 (et le liens vers une bonne installation de Qt3 ne fonctionne pas).

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/
Si vous le souhaiter répétez l'oppération pour chaque module :
cd <répertoire de base du module>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

== General troubleshooting ==
''Note du traducteur: A traduire rapidement...''

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.

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started/Build/KDE4 (fr)

2007-06-24T18:13:02Z

Fatalerrors: /* Gentoo */

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquets requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquets openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquets suivants (et leurs dépendences):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous arrez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

Vous pouvez utiliser tout les ebuilds stables récents mais rappelez vous de toujours synchroniser votre portage avant de commencer.

Il faut être démasqué et/ou conserver une version inférieure pour continuer ''(note du traducteur : à vérifier)''.

<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>

Ceux-ci sont les paquets que nous aurons besoins d'installer, certain pouvant être déja installé. Vous pourrez donc éviter l'installation de certain d'entre eux en ajoutant le paramètre de mise à jour à 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

Vous commencerez à compiler à la main à partir de la section [[Getting_Started/Build/KDE4#kdesupport|section kdesupport]].

Bonne chance !

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.60 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous n'avez pas une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
<code bash>
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 sub-src sub-tools
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;
</code>

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. '''Notez :''' Il vous faudra peut-être lancer la commande <tt>xhost +local:kde-devel</tt> en tant qu'utilisateur normal de KDE3 pour démarrer cette application. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== kdesupport ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|Mise en place de l'environnement]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Il existe plusieurs bibliothèques dont les applications KDE se servent dans le module appelé kdesupport. Ceci inclus Strigi et Soprano pour les recherche de fichiers et la création de métadata, eigen pour les effets visuels dans des applications tels que Kalzium, taglib pour les applications multimédia et qca pour certains besoins en cryptographie.

Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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/
cd kdesupport
cmakekde

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/kdesupport}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

Si vous avez :
CMake Error: Could NOT find REDLAND
alors il vous faudra librdf depuis Redland. Si votre distribution ne fournis pas le paquet librdf, vous pourrez trouver son code source ici : [http://download.librdf.org/source/] et le compiler. (Pour les utilisateurs de Gentoo: L'ebuild de librdf est appelé dev-libs/redland)

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.
* Si vous avez : <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> cela signifie que vous avez compilé Qt sans le support de Qt3 (et le liens vers une bonne installation de Qt3 ne fonctionne pas).

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/
Si vous le souhaiter répétez l'oppération pour chaque module :
cd <répertoire de base du module>
$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.

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started/Build/KDE4 (fr)

2007-06-24T17:58:12Z

Fatalerrors: /* Félicitations ! */

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquets requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquets openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquets suivants (et leurs dépendences):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous arrez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

''A faire rapidement : Traduire ce texte...''

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!

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.60 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous n'avez pas une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
<code bash>
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 sub-src sub-tools
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;
</code>

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. '''Notez :''' Il vous faudra peut-être lancer la commande <tt>xhost +local:kde-devel</tt> en tant qu'utilisateur normal de KDE3 pour démarrer cette application. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== kdesupport ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|Mise en place de l'environnement]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Il existe plusieurs bibliothèques dont les applications KDE se servent dans le module appelé kdesupport. Ceci inclus Strigi et Soprano pour les recherche de fichiers et la création de métadata, eigen pour les effets visuels dans des applications tels que Kalzium, taglib pour les applications multimédia et qca pour certains besoins en cryptographie.

Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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/
cd kdesupport
cmakekde

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/kdesupport}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

Si vous avez :
CMake Error: Could NOT find REDLAND
alors il vous faudra librdf depuis Redland. Si votre distribution ne fournis pas le paquet librdf, vous pourrez trouver son code source ici : [http://download.librdf.org/source/] et le compiler. (Pour les utilisateurs de Gentoo: L'ebuild de librdf est appelé dev-libs/redland)

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.
* Si vous avez : <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> cela signifie que vous avez compilé Qt sans le support de Qt3 (et le liens vers une bonne installation de Qt3 ne fonctionne pas).

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/
Si vous le souhaiter répétez l'oppération pour chaque module :
cd <répertoire de base du module>
$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.

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started/Build/KDE4 (fr)

2007-06-24T17:56:00Z

Fatalerrors: /* Générer localement la documentation de l'API */

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquets requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquets openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquets suivants (et leurs dépendences):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous arrez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

''A faire rapidement : Traduire ce texte...''

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!

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.60 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous n'avez pas une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
<code bash>
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 sub-src sub-tools
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;
</code>

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. '''Notez :''' Il vous faudra peut-être lancer la commande <tt>xhost +local:kde-devel</tt> en tant qu'utilisateur normal de KDE3 pour démarrer cette application. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== kdesupport ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|Mise en place de l'environnement]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Il existe plusieurs bibliothèques dont les applications KDE se servent dans le module appelé kdesupport. Ceci inclus Strigi et Soprano pour les recherche de fichiers et la création de métadata, eigen pour les effets visuels dans des applications tels que Kalzium, taglib pour les applications multimédia et qca pour certains besoins en cryptographie.

Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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/
cd kdesupport
cmakekde

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/kdesupport}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

Si vous avez :
CMake Error: Could NOT find REDLAND
alors il vous faudra librdf depuis Redland. Si votre distribution ne fournis pas le paquet librdf, vous pourrez trouver son code source ici : [http://download.librdf.org/source/] et le compiler. (Pour les utilisateurs de Gentoo: L'ebuild de librdf est appelé dev-libs/redland)

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.
* Si vous avez : <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> cela signifie que vous avez compilé Qt sans le support de Qt3 (et le liens vers une bonne installation de Qt3 ne fonctionne pas).

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/
Si vous le souhaiter répétez l'oppération pour chaque module :
cd <répertoire de base du module>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started/Build/KDE4 (fr)

2007-06-24T17:53:05Z

Fatalerrors: /* En cas de difficultés */

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquets requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquets openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquets suivants (et leurs dépendences):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous arrez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

''A faire rapidement : Traduire ce texte...''

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!

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.60 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous n'avez pas une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
<code bash>
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 sub-src sub-tools
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;
</code>

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. '''Notez :''' Il vous faudra peut-être lancer la commande <tt>xhost +local:kde-devel</tt> en tant qu'utilisateur normal de KDE3 pour démarrer cette application. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== kdesupport ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|Mise en place de l'environnement]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Il existe plusieurs bibliothèques dont les applications KDE se servent dans le module appelé kdesupport. Ceci inclus Strigi et Soprano pour les recherche de fichiers et la création de métadata, eigen pour les effets visuels dans des applications tels que Kalzium, taglib pour les applications multimédia et qca pour certains besoins en cryptographie.

Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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/
cd kdesupport
cmakekde

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/kdesupport}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

Si vous avez :
CMake Error: Could NOT find REDLAND
alors il vous faudra librdf depuis Redland. Si votre distribution ne fournis pas le paquet librdf, vous pourrez trouver son code source ici : [http://download.librdf.org/source/] et le compiler. (Pour les utilisateurs de Gentoo: L'ebuild de librdf est appelé dev-libs/redland)

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.
* Si vous avez : <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> cela signifie que vous avez compilé Qt sans le support de Qt3 (et le liens vers une bonne installation de Qt3 ne fonctionne pas).

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started/Build/KDE4 (fr)

2007-06-24T17:48:19Z

Fatalerrors: /* Soprano */

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquets requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquets openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquets suivants (et leurs dépendences):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous arrez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

''A faire rapidement : Traduire ce texte...''

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!

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.60 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous n'avez pas une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
<code bash>
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 sub-src sub-tools
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;
</code>

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. '''Notez :''' Il vous faudra peut-être lancer la commande <tt>xhost +local:kde-devel</tt> en tant qu'utilisateur normal de KDE3 pour démarrer cette application. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== kdesupport ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|Mise en place de l'environnement]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Il existe plusieurs bibliothèques dont les applications KDE se servent dans le module appelé kdesupport. Ceci inclus Strigi et Soprano pour les recherche de fichiers et la création de métadata, eigen pour les effets visuels dans des applications tels que Kalzium, taglib pour les applications multimédia et qca pour certains besoins en cryptographie.

Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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/
cd kdesupport
cmakekde

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/kdesupport}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

Si vous avez :
CMake Error: Could NOT find REDLAND
alors il vous faudra librdf depuis Redland. Si votre distribution ne fournis pas le paquet librdf, vous pourrez trouver son code source ici : [http://download.librdf.org/source/] et le compiler. (Pour les utilisateurs de Gentoo: L'ebuild de librdf est appelé dev-libs/redland)

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started/Build/KDE4 (fr)

2007-06-24T17:46:48Z

Fatalerrors: /* Strigi */

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquets requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquets openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquets suivants (et leurs dépendences):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous arrez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

''A faire rapidement : Traduire ce texte...''

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!

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.60 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous n'avez pas une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
<code bash>
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 sub-src sub-tools
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;
</code>

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. '''Notez :''' Il vous faudra peut-être lancer la commande <tt>xhost +local:kde-devel</tt> en tant qu'utilisateur normal de KDE3 pour démarrer cette application. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== kdesupport ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|Mise en place de l'environnement]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Il existe plusieurs bibliothèques dont les applications KDE se servent dans le module appelé kdesupport. Ceci inclus Strigi et Soprano pour les recherche de fichiers et la création de métadata, eigen pour les effets visuels dans des applications tels que Kalzium, taglib pour les applications multimédia et qca pour certains besoins en cryptographie.

Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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/
cd kdesupport
cmakekde

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/kdesupport}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

Si vous avez :
CMake Error: Could NOT find REDLAND
alors il vous faudra librdf depuis Redland. Si votre distribution ne fournis pas le paquet librdf, vous pourrez trouver son code source ici : [http://download.librdf.org/source/] et le compiler. (Pour les utilisateurs de Gentoo: L'ebuild de librdf est appelé dev-libs/redland)

== Soprano ==
{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Le code pour obtenir le fichier kmedata s'appuie sur Soprano. Pour installer Soprano vous aurez besoin des libraires et en-têtes de librdf.

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1). On télécharge les sources de Soprano en utilisant subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/soprano}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

=== En cas de difficultés ===
Si vous obtenez
CMake Error: Could NOT find REDLAND
alors vous avez besoin de librdf du Redland.
Si votre distribution ne fournit pas le paquet librdf, vous pouvez télécharger les sources ici [http://download.librdf.org/source/ http://download.librdf.org/source/] et les compiler.

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started/Build/KDE4 (fr)

2007-06-24T17:31:05Z

Fatalerrors: /* Procédure */ MAJ lien

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquets requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquets openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquets suivants (et leurs dépendences):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous arrez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

''A faire rapidement : Traduire ce texte...''

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!

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.60 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous n'avez pas une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4_(fr)#Mise_en_place_de_l.27environnement|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
<code bash>
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 sub-src sub-tools
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;
</code>

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. '''Notez :''' Il vous faudra peut-être lancer la commande <tt>xhost +local:kde-devel</tt> en tant qu'utilisateur normal de KDE3 pour démarrer cette application. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== Strigi ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Le code pour obtenir les fichiers de métadata s'appuie maintenant sur Strigi. Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/strigi}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

== Soprano ==
{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Le code pour obtenir le fichier kmedata s'appuie sur Soprano. Pour installer Soprano vous aurez besoin des libraires et en-têtes de librdf.

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1). On télécharge les sources de Soprano en utilisant subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/soprano}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

=== En cas de difficultés ===
Si vous obtenez
CMake Error: Could NOT find REDLAND
alors vous avez besoin de librdf du Redland.
Si votre distribution ne fournit pas le paquet librdf, vous pouvez télécharger les sources ici [http://download.librdf.org/source/ http://download.librdf.org/source/] et les compiler.

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started/Build/KDE4 (fr)

2007-06-24T17:26:46Z

Fatalerrors: /* En cas de difficultés */

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquets requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquets openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquets suivants (et leurs dépendences):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous arrez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

''A faire rapidement : Traduire ce texte...''

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!

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.60 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous n'avez pas une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4#Setting_up_the_environment|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
<code bash>
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 sub-src sub-tools
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;
</code>

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. '''Notez :''' Il vous faudra peut-être lancer la commande <tt>xhost +local:kde-devel</tt> en tant qu'utilisateur normal de KDE3 pour démarrer cette application. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== Strigi ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Le code pour obtenir les fichiers de métadata s'appuie maintenant sur Strigi. Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/strigi}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

== Soprano ==
{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Le code pour obtenir le fichier kmedata s'appuie sur Soprano. Pour installer Soprano vous aurez besoin des libraires et en-têtes de librdf.

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1). On télécharge les sources de Soprano en utilisant subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/soprano}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

=== En cas de difficultés ===
Si vous obtenez
CMake Error: Could NOT find REDLAND
alors vous avez besoin de librdf du Redland.
Si votre distribution ne fournit pas le paquet librdf, vous pouvez télécharger les sources ici [http://download.librdf.org/source/ http://download.librdf.org/source/] et les compiler.

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started/Build/KDE4 (fr)

2007-06-24T17:21:17Z

Fatalerrors: /* Procédure */

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquets requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquets openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquets suivants (et leurs dépendences):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous arrez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

''A faire rapidement : Traduire ce texte...''

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!

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.60 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous n'avez pas une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4#Setting_up_the_environment|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
<code bash>
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 sub-src sub-tools
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;
</code>

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== Strigi ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Le code pour obtenir les fichiers de métadata s'appuie maintenant sur Strigi. Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/strigi}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

== Soprano ==
{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Le code pour obtenir le fichier kmedata s'appuie sur Soprano. Pour installer Soprano vous aurez besoin des libraires et en-têtes de librdf.

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1). On télécharge les sources de Soprano en utilisant subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/soprano}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

=== En cas de difficultés ===
Si vous obtenez
CMake Error: Could NOT find REDLAND
alors vous avez besoin de librdf du Redland.
Si votre distribution ne fournit pas le paquet librdf, vous pouvez télécharger les sources ici [http://download.librdf.org/source/ http://download.librdf.org/source/] et les compiler.

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started/Build/KDE4 (fr)

2007-06-24T17:17:11Z

Fatalerrors: /* D-Bus */ just a very little error

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquets requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquets openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquets suivants (et leurs dépendences):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous arrez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

''A faire rapidement : Traduire ce texte...''

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!

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.60 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous n'avez pas une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4#Setting_up_the_environment|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
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 sub-src sub-tools
# make install: only if QTDIR is not the current directory!
make install

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== Strigi ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Le code pour obtenir les fichiers de métadata s'appuie maintenant sur Strigi. Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/strigi}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

== Soprano ==
{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Le code pour obtenir le fichier kmedata s'appuie sur Soprano. Pour installer Soprano vous aurez besoin des libraires et en-têtes de librdf.

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1). On télécharge les sources de Soprano en utilisant subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/soprano}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

=== En cas de difficultés ===
Si vous obtenez
CMake Error: Could NOT find REDLAND
alors vous avez besoin de librdf du Redland.
Si votre distribution ne fournit pas le paquet librdf, vous pouvez télécharger les sources ici [http://download.librdf.org/source/ http://download.librdf.org/source/] et les compiler.

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started/Build/KDE4 (fr)

2007-06-24T17:13:53Z

Fatalerrors: /* Prérequis */

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquets requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquets openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquets suivants (et leurs dépendences):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous arrez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

''A faire rapidement : Traduire ce texte...''

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!

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.0 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous n'avez pas une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4#Setting_up_the_environment|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
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 sub-src sub-tools
# make install: only if QTDIR is not the current directory!
make install

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== Strigi ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Le code pour obtenir les fichiers de métadata s'appuie maintenant sur Strigi. Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/strigi}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

== Soprano ==
{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Le code pour obtenir le fichier kmedata s'appuie sur Soprano. Pour installer Soprano vous aurez besoin des libraires et en-têtes de librdf.

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1). On télécharge les sources de Soprano en utilisant subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/soprano}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

=== En cas de difficultés ===
Si vous obtenez
CMake Error: Could NOT find REDLAND
alors vous avez besoin de librdf du Redland.
Si votre distribution ne fournit pas le paquet librdf, vous pouvez télécharger les sources ici [http://download.librdf.org/source/ http://download.librdf.org/source/] et les compiler.

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started/Build/KDE4 (fr)

2007-06-24T17:11:06Z

Fatalerrors: /* openSUSE */

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

'''Paquets requis'''

La plupart des paquetages dont vous aurez besoin sont :
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

Vous pouvez sauter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant le dépôt de paquets openSUSE Build Service KDE4 à vos sources d'installation.

Pour openSUSE 10.2 ou plus récent faites :
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

Pour des versions plus anciennes de SUSE Linux faites :
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Maintenant installez les paquets suivants (et leurs dépendences):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

Et pour que le framework apidox soit pleinement fonctionnel vous arrez aussi besoin de :
<code>
graphviz
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.0 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous n'avez pas une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4#Setting_up_the_environment|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
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 sub-src sub-tools
# make install: only if QTDIR is not the current directory!
make install

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== Strigi ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Le code pour obtenir les fichiers de métadata s'appuie maintenant sur Strigi. Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/strigi}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

== Soprano ==
{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Le code pour obtenir le fichier kmedata s'appuie sur Soprano. Pour installer Soprano vous aurez besoin des libraires et en-têtes de librdf.

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1). On télécharge les sources de Soprano en utilisant subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/soprano}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

=== En cas de difficultés ===
Si vous obtenez
CMake Error: Could NOT find REDLAND
alors vous avez besoin de librdf du Redland.
Si votre distribution ne fournit pas le paquet librdf, vous pouvez télécharger les sources ici [http://download.librdf.org/source/ http://download.librdf.org/source/] et les compiler.

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Getting Started/Build/KDE4 (fr)

2007-06-24T17:03:27Z

Fatalerrors: /* Prérequis */

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

series=Démarrer avec KDE|

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]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]<br>[[../KDE4/FreeBSD|FreeBSD notes]]<br>[[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Résumé ==

Ce tutoriel détaille une procédure pour obtenir une version du tronc de KDE tournant sur les systèmes Linux/BSD. Tout au long de ce tutoriel le shell
bash est utilisé. Si vous souhaitez mettre en place KDE sur d'autres systèmes tels que Solaris, Mas OS ou Microsoft Windows, veuillez aller sur la page [[../|Build]] et jeter un oeil sur les liens en bas de page correspondant à votre système.

{{warning|Attendez-vous à avoir beaucoup d'erreurs de compilation '''les lundis''' lorsque des modifications critiques sont implémentées. Le [http://developer.kde.org/~dirk/dashboard/ dashboard] répertorie les plantages
non souhaités. Vous êtes encouragés à réparer les modules.}}

== Prérequis ==

Les éléments suivants doivent être installés sur votre machine avant de pouvoir continuer ce tutoriel :
* gcc et g++ du projet gcc, de préférence en version 4.1 minimum
* svn le client du système de gestion de version subversion
* Les bibliothèques de développement et les fichiers d'en-tête de 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 et libxslt
* Le script makeobj, qui fait partie du projet kdesdk. Vous pouvez l'installer avec kdesdk ou une partie de celui-ci (kdesdk-scripts sur une Debian) ou un paquetage similaire, ou encore le télécharger depuis [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN].
* Le paquetage [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info], le standard MIME du projet freedesktop que KDE utilise à présent
* [http://boost.org/ boost] est requis par kdebase; après la compilation et/ou l'installation de boost et dans le but d'informer cmake de son emplacement (FindBoost), ajoutez le répertoire de boost (celui contenant les sous-répertoire de fichiers include) à CMAKE_INCLUDE_PATH ou créez une variable d'environnement BOOST_ROOT que vous positionnerez sur le répertoire de boost.

Il est également nécessaire d'avoir le shell bash installé.

=== Kubuntu ===

Dans Kubuntu 7.04 (Fiesty) vous pouvez installer les dépendances dont vous avez besoin pour la construction avec la commande :
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
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 \
libungif4-dev libdbus-1-dev
</code>

Vous pouvez éviter l'installation manuelle de Qt 4.3, CMake 2.4.6 et DBus en installant les paquetages suivant (avec leurs dépendances). '''Veuillez noter:''' Cela ne fonctionnera pas avec Qt pour KDE4 après la version alpha 1 (Kubuntu Fiesty est fournie avec Qt 4.3 beta et non une version finale tel que requis par les futures versions de KDE4). Pour installer Qt pour KDE4 :
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

Pour un bon fonctionnement du framework [[apidox]] vous avez aussi besoin de :
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

Dans openSUSE 10.2 ou plus récent, vous pouvez installez les paquetages manquant avec [http://en.opensuse.org/Zypper Zypper] :
<code bash>
sudo zypper install <package-name>
</code>

Sur d'anciennes versions de SuSE, vous pouvez utiliser YaST :
<code bash>
su
yast2 -i <packagename>
</code>

La plupart des paquetages dont vous aurez besoin sont :
<code bash>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

Les paquetages binaires de CMake pour openSUSE sont disponible depuis [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

== Création d'un compte pour le développement de KDE4 ==

{{Note|
Certaines personnes aime avoir un compte utilisateur spécifique pour KDE4. Les instructions suivantes ont été écrites en ce sens.

Cependant il est beaucoup plus efficace de tout faire avec un seul compte utilisateur. Voir "[[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Les scripts pour accroire sa productivité dans KDE4]]" pour plus de détails.

Vous pouvez toujours suivre les instructions suivantes mais ne placez pas les variables d'environnement dans le fichier <tt>.bashrc</tt>.
Placez les dans un fichier séparés que vous sourcerez pour passer dans l'environnement de développement de KDE.
}}

=== Option 1 : En ligne de commande ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2 : Avec KControl ===

Au lieu d'utiliser la commande ci-dessus, vous pouvez aussi utiliser le module Utilisateur dans le centre de contrôle de KDE si KDE3 est déjà installé sur votre machine.

=== Mise en place de l'environnement ===

Copiez le fichier {{path|~/.bashrc}} depuis votre compte utilisateur normal vers le nouveau compte kde-devel. Ensuite, copiez et collez le contenu du script [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|d'exemple .bashrc]] dans {{path|~kde-devel/.bashrc}}. Assurez vous de commenter la ligne <tt>alias make=makeobj</tt> si vous n'avez pas la commande <tt>[[Getting Started/Build/KDE4#Required Software| makeobj]]</tt> disponible. Pour le faire démarrer, vous devez ouvrir un nouveau shell bash ou exécutez
<code bash>
source ~/.bashrc
</code>

Cela vous donnera accès à des commandes telles que <tt>cmakekde</tt> qui sont utilisées dans ce tutoriel de même que la vérification des chemins corrects pour les binaires de Qt, KDE et CMake.

Pour plus d'information, veuillez lire le tutoriel [[Getting Started/Increased Productivity in KDE4 with Scripts]].

=== Se logger avec le nouvel utilisateur ===
Changer pour l'utilisateur kde-devel : (n'oubliez pas le tiret)
<code bash>
su - kde-devel
</code>

Le reste de ce tutoriel suppose que vous tournez avec l'utilisateur <tt>kde-devel</tt>.

== Le shell du développeur ==

Sur certain système le shell par defaut pour les nouveaux utilisateurs est {{path|/bin/sh}}. Si ce n'est pas le cas pour votre système, vous pouvez sauter cette section. Utiliser {{path|/bin/sh}} peut poser beaucoup de problèmes et vous devriez le changer pour {{path|/bin/bash}} ou un autre shell.

=== Option 1 : En tant que l'utilisateur kde-devel ===

Si vous n'avez pas les privilèges root et que votre système vous permet le changement de votre shell pour l'application <tt>chsh</tt>, vous pouvez alors essayer de changer votre shell pour {{path|/bin/bash}} en utilisant la commande :
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2 : En tant qu'administrateur ===

Si votre système est fourni avec l'application <tt>usermod</tt> vous pouvez lancer la commande suivante en tant que root : <tt>usermod -s /bin/bash</tt>.

Une autre solution consiste à utiliser l'application <tt>vipw</tt> en tant que root pour éditer de manière sécurisée le fichier {{path|/etc/passwd}}. Localisez 'kde-devel' dans le fichier, remplacez '{{path|/bin/sh}}' à la fin de la ligne par '{{path|/bin/bash}}', sauvegardez vos modifications et quittez.

Le nouveau shell sera démarré automatiquement quand vous vous loggerez de nouveau en tant que kde-devel.

== D-Bus ==

QtDbus et KDE sont réputés tourner avec les versions de D-Bus 0.62, 0.92 et suivantes. Il y a des chances que les versions 0.0 et 0.61 fonctionnent meme si elles n'ont pas été testées. Il est acquis que les versions 0.90 and 0.91 ne fonctionnent pas. Nous recommandons l'utilisation des versions de type post-1.0 release (au moins 0.94), donc pensez à vous mettre à jour si vous ne l'avez pas encore fait.

Vous pouvez sauter cette section si vous n'avez pas une version récente de D-Bus
ou si vous ne voulez pas vous mettre à jour.

Avant d'aller plus en avant dans la procédure, assurez vous que vos headers et librairies X11 sont disponibles. Le script de configuration utilisé ligne 5 devrait afficher :

Building X11 code: yes

=== Procédure ===

{{tip|Assurez-vous d'avoir mis en place votre environnement tel qu'indiqué [[Getting_Started/Build/KDE4#Setting_up_the_environment|ci-dessus]]. C'est nécessaire pour que les fonctions <tt>cs</tt> et <tt>cb</tt> fonctionnent.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Après être allé dans le répertoire des sources (ligne 1), le code source de D-Bus est téléchargé depuis freedesktop.org (ligne 2) et désarchivé (ligne 3).
Une fois dans le répertoire de D-Bus nouvellement créé (ligne 4), la compilation
est mise en place avec l'aide du script de configuration fourni (ligne 5).
Après la compilation (ligne 6) et l'installation (ligne 7) de D-Bus, nous utilisons l'outil <tt>dbus-uuidgen</tt> pour installer un fichier
d'identification de la machine qui permet au bus de démarrer automatiquement
lorsque la session du bureau est lancée (ligne 8).

Notez que vous devez avoir un accès en écriture à {{path|/var}} pour les deux dernières étapes. Si votre système ne connait pas la commande sudo, vous pouvez utiliser <tt>su</tt> à la place, i.e. <tt>su -c "make install"</tt>.

=== En cas de difficultés ===

Si vous obtenez l'erreur '''makeobj: command not found''', c'est qu'il vous manque la commande <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Sautez cette étape si vous avez [http://cmake.org/ CMake] >=2.4.5.
Vous pouvez utiliser directement le paquet binaire disponible sur le [site CMake http://www.cmake.org/HTML/Download.html]. Vous y trouverez aussi des paquets spécifiques à certaines distributions.

=== Procédure ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
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

=== Ce qu'il se passe ===
Tout d'abord, nous devons retourner dans le répertoire de sources de l'utilisateur <tt>kde-devel</tt> (ligne 1), récupérer les sources de CMake (ligne 2) et les décompresser (ligne 3). On crée un répertoire cible pour construire CMake (ligne 4) et on va dedans (ligne 5). Enfin nous lançons le script de bootstrap de CMake afin de configurer sa construction (ligne 6), enfin on fais un <tt>make</tt> (ligne 7) et on l'installe (ligne 8) en utilisant les privilèges administrateurs (root).

Si votre système n'intègre pas la commande <tt>sudo</tt>, vous pouvez utliser à la place la commande <tt>su -c "make install"</tt>.

== Qt ==
Ensuite, il nous faut la version de Qt4 qui se situant dans les dépots KDE.
KDE se construira à coup sur avec Qt 4.3. Qt 4.2 et antérieurs ne sont pas supportés et ne fonctionneront pas. C'est toujours une version non distribuée, par conséquent votre distribution n'aura surement pas les paquets adéquats. Il est conseillé d'utiliser les copies dans les serveurs Subversion de KDE.

=== Procédure ===
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 sub-src sub-tools
# make install: only if QTDIR is not the current directory!
make install

=== Ce qu'il se passe ===
Nous revenons au répertoire racine de l'utilisateur <tt>kde-devel</tt> (ligne 1) et téléchargeons le code source avec l'aide de subversion (svn) depuis le
dépot KDE (ligne 2). Après etre allé dans le répertoire {{path|qt-copy}} résultant (ligne 3), on lance un script qui gère les patches venant avec <tt>qt-copy</tt> (ligne 4).

Une fois les patches appliqués, on met en place la compilation avec le script <tt>configure</tt> (lignes 5-7). Les différentes options utilisées sont expliquées dans le fichier {{path|qt-copy/README.qt-copy}}. Enfin, on construit le strict nécessaire pour KDE (ligne 8) et on installe Qt (lignes 9-10). Si vous souhaitez avoir tous les exemples et les démonstrations, vous pouvez soit les construire individuellement, soir faire un simple <tt>make</tt> depuis le répertoire {{path|qt-copy}}.

Notez que l'installation ne nécessite pas d'etre en root puisque tout est installé dans {{path|$QTDIR}}. Quoiqu'il en soit, l'installation est uniquement
nécessaire si {{path|$QTDIR}} diffère de {{path|$HOME/qt-copy}}, ce qui n'est pas le cas si vous avez scrupuleusement suivi les instructions précédentes.

=== En cas de difficultés ===
Si vous obtenez l'erreur : "error: X11/Xlib.h: No such file or directory", installez le paquet de developement de <tt>xorg</tt> (le nom actuel peu varier suivant votre système d'exploitation, par exemple il s'agit de <tt>xorg-dev</tt> sur les systèmes basé sur Ubuntu tel que Kubuntu).

Si vous obtenez une erreur dans l'étape de configuration à propos de defines manquant, vérifiez la valeur de <tt>$QMAKESPEC</tt>. Certaines distributions positionnent cette variable directement pour le Qt installé avec le système. Si tt>unset QMAKESPEC</tt> résoud le problème, vous devriez l'ajouter dans le script <tt>~/.bashrc</tt>.

Si vous obtenez une erreur du type ".pch/debug-shared/QtCore", c'est parceque Qt-4.3 active les en-tetes précompilés si votre gcc le supporte, mais pour une certaine raison cela ne marche pas chez vous. Si vous utilisez distcc, configurez qt avec -no-pch. Si vous utilisez icecream, mettez à jour votre version d'icecream depuis le tronc svn.

Essayez de faire tourner n'importe quel programme Qt, par exemple {{program|assistant}}. S'il plante sur QSpanData::adjustSpanMethods, alors votre problème vient du style oxygen. Essayez de supprimmer {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} et {{path|lib/kde4/plugins/styles/oxygen.so}} s'ils existent dans le préfixe d'installation de KDE.

== Strigi ==

{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Le code pour obtenir les fichiers de métadata s'appuie maintenant sur Strigi. Pour installer Strigi, vous avez besoin des librairies et en-têtes de libz, libbz2, openssl (libcrypto ou libssl), libcluene (=0.9.16; la version 0.9.17 ne fonctionnera '''pas'''), et soit libxm12 ou libexpart.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base de sources (ligne 1). On télécharge les sources pour Strigi avec subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/strigi}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

==== En cas de difficultés ====
Si vous obtenez :
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)
vous devez installer le paquet de développement de libxml2.

== Soprano ==
{{warning|Si vous arrivez directement à cette section sans avoir lu [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''la procédure suivante ne fonctionnera pas'''.

Les instructions données ne sont pas à remettre en cause; <tt>cs</tt> et <tt>cb</tt> ne sont pas des commandes unix. Votre environnement '''doit''' être correctement mis en place pour que ces instructions fonctionnent correctement.}}

Le code pour obtenir le fichier kmedata s'appuie sur Soprano. Pour installer Soprano vous aurez besoin des libraires et en-têtes de librdf.

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1). On télécharge les sources de Soprano en utilisant subversion (ligne 2), puis on va dans le nouveau répertoire {{path|~/src/soprano}} (ligne 3), et on commence la construction (ligne 4). Cela nous laissera dans le répertoire de construction une fois la compilation terminée.

=== En cas de difficultés ===
Si vous obtenez
CMake Error: Could NOT find REDLAND
alors vous avez besoin de librdf du Redland.
Si votre distribution ne fournit pas le paquet librdf, vous pouvez télécharger les sources ici [http://download.librdf.org/source/ http://download.librdf.org/source/] et les compiler.

== kdelibs ==
Avec Qt4 et Strigi compilés, nous pouvons maintenant passer à la construction
des librairies de base de KDE. Si vous avez utilisé le susnommé [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] c'est maintenant que ces nouvelles instructions deviennent utiles.

=== Procédure ===

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

=== Ce qu'il se passe ===
Nous allons dans le répertoire de base des sources (ligne 1) puis créons et allons dans le répertoire KDE (ligne 2). On télécharge les sources de kdelibs avec subversion (ligne 3), puis on va dans le nouveau répertoire {{path|~/src/KDE/kdelibs}} (ligne 4), et on commence la construction. Cela nous laissera dans le répertoire de construction <tt>kdelibs</tt> une fois la compilation terminée.

{{tip|Il se peut qu'il y ait des dépendances manquantes sur votre système ! Elles sont clairement mises en évidence dans la sortie de <tt>cmakekde</tt>.
Vous pouvez faire un <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> avant de compiler un module kde (comme kdelibs, kdepimlibs, etc.)}}

=== Modules additionnels de CMake spécifiques à KDE ===
Il y a des modules CMake additionnels dans {{path|kdelibs/cmake/modules/}} qui sont nécessaires pour construire les applications KDE4. Ils seront installées pour vous lorsque kdelibs sera installé.

=== En cas de difficultés ===
Si vous avez des problèmes lors de la compilation de kdelibs, premièrement assurez-vous que les logiciels cités dans la section [[Getting_Started/Build/KDE4_%28fr%29#Pr.C3.A9requis|Prérequis]] sont installés et fonctionnent. Une autre possibilité :
* si la commande <tt>cmakekde</tt> échoue en disant que CMake nécessite un
répertoire de compilation différent des sources, supprimmez le fichier {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and ressayez.

Si <tt>cmakekde</tt> donne toujours la même erreur, alors essayez ça :
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install

* Si vous recevez un mesasge d'erreur disant "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", alors vous avez besoin d'aller dans votre répertoire de construction avant de lancer cmakekde. (i.e. <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* Si Qt n'a pas été trouvé ou qu'une mauvaise version de Qt a été détectée, assurez que le qmake du Qt dont vous avez besoin est le premier dans le chemin de qmake.
* Si le problème persiste, essayez l'option de CMake <tt>--keep-going</tt>.
* Ici vous avez besoin de la librairie libungif, sinon vous aurez un message d'erreur du type : "<tt>Could NOT find GIF</tt>".
* mise à niveau de Qt-4.3 : si vous avez une erreur de lien dans kjsembed parlant de QScriptEngine, éditez le CMakeCache.txt dans les kdelibs et supprimmez les lignes parlant QT_QTUITOOLS_LIBRARY, et lancez un make (cette librairie statique a une nouvelle dépendance, et le code de cmake qui l'ajoute doit tourner.)
* Si vous obtenez l'erreur : <code>CMake Error: KDE Requires Qt to be built with SSL support,</code> installez openssl-devel, et recompilez Qt.

== kdepimlibs ==
Après <tt>kdelibs</tt>, mais avant ''kdebase'', vous devez compiler et installer ''kdepimlibs''.

=== Procédure ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== Ce qu'il se passe ===
On va dans le répertoire des sources de KDE (ligne 1), on télécharge le code source de kdepimlibs avec subversion (ligne 2) et ensuite on va dans le nouveau répertoire {{path|~/src/KDE/kdepimlibs}} (ligne 3). On commence ensuite la construction (ligne 4). Cela nous laissera dans le répertoire de construction de <tt>kdepimlibs</tt> une fois la compilation terminée.

== kdebase ==
Vous aurez probablement besoin de kdebase pour faire fonctionner certainnes choses comme kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== En cas de problèmes ===
Si vous avez des problèmes pour compiler kdebase:
* Assurez vous que vous avez installé <tt>libxss headers</tt>. (D'habitude vous avez des références d'objets xscreensaver non définies si vous n'avez pas ces en-têtes)
* <tt>which meinproc</tt> doit afficher {{path|/home/kde-devel/kde/bin/meinproc}}
* Si cmakekde ne peut trouver le chemin pour kdepimlibs, editez le fichier {{path|$KDE_BUILD/kdebase/CMakeCache.txt}} et fixez manuellement <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* Si vous avez une erreur disant "Please set the following variables: X11_XTest_LIB (ADVANCED)" en anglais, installez packet de développement de <tt>Xtst</tt>. Sur certains système, il est empaqueté séparément de <tt>xext</tt> et est appelé <tt>x11proto-xext-dev</tt> ou <tt>libxtst-dev</tt>. Vous arrez aussi besoin d'effacer le fichier CMakeCache.txt dans le répertoire de construction après avoir installé ce paquet.
* Idem pour "X11_Xinerama_LIB (ADVANCED)" pour lequel vous aurrez besoin du paquet de développement de <tt>xinerama</tt>.
* Si vous avez l'erreur "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", alors vous devez installer les en-tête libfontconfig
* Si vous avez l'erreur "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", vous devez installer soprano depuis kdesupport et recompiller kdelibs

== Générer localement la documentation de l'API ==
La documentation de l'API de KDE est disponible en ligne à l'adresse [http://api.kde.org api.kde.org], cependant il peut être parfois utile de l'avoir sur son propre disque. Par exemple lorsque vous voulez utiliser [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] pour parcourir la documentation ou si vous ne pouvez être connecté en permanence.

Il faut être attentif au fait que générer la documentation de l'API peut prendre plusieures heures et occuper près d'un demi gigaoctet d'espace disque.
Un script se situant dans {{path|kdelibs/doc/api}} s'occupe de générer la documentation, il vous faudra <tt>doxygen</tt> pour pouvoir l'utiliser.

Pour construire la documentation de l'API de kdelibs, tapez ce qui suit:

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs n'est pas une commande unix]]
mkdir apidox
cd apidox
../kdelibs/doc/api/doxygen.sh ../kdelibs/

== Félicitations ! ==

Vous êtes maintenant prêt à vous lancer dans les autres modules svn de la même manière que vous avez construit kdebase. Vous pouvez maintenant démarrer et tester KDE4 ou écrire vos propres correctifs et applications.

Jetez un oeil sur le tutoriel [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] pour savoir comment démarrer les applications KDE 4 et comment utiliser KDevelop pour travailler dessus.

[[Categorie:Build KDE]]
[[Categorie:KDE4]]

Development/Tutorials/API Documentation (fr)

2007-06-23T13:07:30Z

Fatalerrors:

{{Template:I18n/Language Navigation Bar|Development/Tutorials/API Documentation}}
__TOC__
{{Box|Definition|
'''API (''Application Programming Interface'') documentation''' is documentation that applies to ''a program'' and its interfaces. It is documentation that explains to a developer who is going to work with the program, or a developer who is going to work on a program, how things work and what methods are there to call.

API documentation is sometimes called an API reference manual. It needn't ''just'' be a reference manual, though, there can be extensive additional material, like tutorials, histories, etc. In this page, we will refer to all the material that documents and explains the API of a piece of code as "apidox."

Good apidox take some effort to write -- but I would say less than good ''user'' documentation, since you as a developer are writing for another developer, and explaining how code works and what it is supposed to do. So your audience is clear to start with. The benefits of apidox come when someone else (or maybe even you several months later) needs to (re)use the code, or extend it. Good apidox means that someone new can show up, understand your code, and produce meaningful patches (that is, ''help'') all the more quickly. Especially for libraries, good apidox make the library usable as a black box (and that's how they should be) because all the needed documentation is available in the apidox and not hidden in the (perhaps inaccessible) C code.|100%}}

== Preamble ==

APIDOX are what make a program accessible to other contributors. They are not essential, but they certainly help a great deal for new people who want to work on your code, or better yet, re-use it elsewhere with a minimum of modification.

Look at the [http://doc.trolltech.com/latest/ Qt documentation] to get a feeling of what good apidox look like. There is a consistency of style, a thoroughness which permeates all the documentation. It is possible to learn a lot about Qt just from reading the documentation. You do not necessarily need to run the tutorial programs or read the source code of the library to find out what a parameter flags does in some method of the library. It is all spelled out for you.

Writing apidox is a two-part process. One part is technical: you need to understand the code you are documenting -- or at least know what it is supposed to do and how it is meant to be used. The other part is plain discipline: apidox are most useful when they are exhaustive.

This document is going to try to prevent the apidox process from becoming exhausting, by giving straightforward tips about how to write apidox. There are also the [[Policies/Library Documentation Policy|library apidox policies]], which are much stricter, which provide measurable properties that apidox must adhere to. It does not hurt to glance at them now.

== APIDOX Basics ==

APIDOX are processed by the [http://www.doxygen.org Doxygen] documentation tool. This tool reads source code for your application (or library) and produces nicely formatted documentation from it. There is a good [http://www.stack.nl/~dimitri/doxygen/manual.html reference manual] available -- but let's hope to make it unnecessary to read, for basic use anyway.

{{Tip|You don't even need to have Doxygen installed to work on apidox for your application. Every few hours, the [http://www.englishbreakfastnetwork.org/ EnglishBreakfastNetwork] compiles apidox for all of the KDE modules we know about. Logfiles are kept and you can see your apidox on the site, or read the error messages and fix those. ...it might not be the fastest way to write and fix apidox, but it gets the job done, and if you spend just an hour at the end of the day writing some apidox, it's sufficiently useful.}}

Basic apidox are fun and simple: you write comments in your code explaining what things are supposed to be for. These comments are nearly indistinguishable from stuff you would be writing in the headers of your code ''anyway'', so that's not hard to do.

APIDOX are written in special comments. These comments start with /** (slash, star, star) -- that's what makes them special. The rest of the content of the comment is just plain text describing a part of your program. The plain text is interpreted by the Doxygen processor, so that you can write accurate descriptions of parameters, return types, and do some basic text markup. But documentation can be very straighforward: just write down what a method does, surrounded by /** and */, like this:

<code cppqt>
/** This method increases the sexyness of Kontact and should as
* such be called whenever possible (i.e. instead of having idle
* time, you might think of calling this method and helping
* Kontact gain even more popularity). You might even insert it
* into your own event loop to ensure it is called as often as
* possible. If these calls decrease the number of new features,
* it's still no problem to call it.
*/
void incSexyness(KInstance *instance);
</code>

For proper apidox, you need to document every "thing" in your program. "Things" here are directories, files, namespaces, classes, methods, enums, and member variables. You can actually leave out files and directories, and concentrate on the latter. Complete apidox looks something like this:

<code cppqt>
/** Namespace for KDE network-related classes */
namespace KDENetwork {
/** Wrapper for a TCP/IP socket */
class Socket {
public:
/** Constructor. Calls listen() on some random high port. */
Socket();
private:
int fd;
};
}
</code>

You can see here that each nesting level of "things" is documented with a comment -- the namespace, the class and the method. Things that are private do not need apidox, but things that are protected do.

It is important to document each level of nesting, because if you leave one level out, Doxygen will ignore the documentation in inner nesting levels, and you will be left wondering where it has gone. For instance, if we leave out the class documentation, then the method documentation for Socket() will vanish as well. This is one of the common pitfalls to writing apidox.

If you just do this -- write an explanation for every part of your program -- then you're already a long way on the road to having complete apidox. Writing all those explanations makes your program more accessible to other developers -- and often shows you where the design or choice of names is sub-optimal. So it's a win for you both ways.

You can consult the list of supported tags for examples of more fancy apidox -- explaining parameters, for instance, and annotating the apidox with credits and examples. It's also worthwhile to take a look at the section on enabling apidox, but it's also fine to divide the work: you write the apidox themselves, and ask me (mailto:groot@kde.org) to enable apidox generation for your module. And I will.

== Writing APIDOX in New Code ==

If you are writing new code and want to write apidox, use KDevelop. Really. Properly configured, it can automatically set up all the skeletons for apidox that you need, and what you do is write the descriptions. No messing with apidox commands.

If you're not in that fortunate position, the following little checklist should get you through the worst of writing apidox.

'''1. Write apidox as you code'''

The discipline it takes to write down the apidox for function foo() now as you are thinking of foo() and what it needs to do more than compensates the effort later where you have to remember what foo() was supposed to do, anyway.

This isn't to say you have to do it this way, but it is convenient. The apidox also document design decisions. They also document what you want a particular piece of code to do, regardless of what it actually does. That makes it possible to independently check that the code does what it's supposed to: because it's written down.

'''2. Document your headers completely'''

The headers are what's most visible to users (in this context, users are developers who are re-using) of your code, and they should be complete. Document each structural bit of the headers as you go along. This means:

*Every file should have a file-level comment. This is suggested in the KDE guidelines anyway -- near the top of your file, write down what the file is for, vaguely what it defines. Wrap this up in a /** @file */ comment and you are set.
*Every namespace should have a comment. A given namespace only needs a comment once in your source tree (or within one bunch of files that generate apidox together), but it can't hurt to repeat the description on each occasion -- just make it brief. These comments are just plain apidox comments wrapped up in /** */ ; there are no special markups needed like the @file for file comments.<br />Do make sure the comment is just before the namespace and doesn't get distanced from the namespace it documents. The following is fine:
<code cppqt>/** The Ungulate namespace collects classes and methods
pertaining to hooved animals. */

namespace Ungulate {
</code>
:In the next example, someone has snuck in some extra stuff between the apidox comment and the namespace it is documenting. This may cause Doxygen errors (so then it is easy to spot) or it may cause the namespace documentation to attach to something wildly different (and then it's hard to spot).
<code cppqt>
/** The Ungulate namespace collects classes and methods
pertaining to hooved animals. */
class Mammal;
namespace Ungulate {
</code>
:There is not much you can do about this except to be watching when you insert code -- don't separate apidox from the thing they are documenting.
*Every class should have a comment. Classes are the important building blocks of your application or library, so this is one place where writing lots helps. Write down why the class exists. Write down what it is supposed to do. Give an example of how to use it. Explain how not to use it, or what prerequisites it has (for instance, lots of classes need a KInstance object, but don't document that explicitly).<br />The same caveats apply as with namespace apidox: make sure the class follows its apidox immediately.
*Every method should have a comment explaining what it does and what the parameters are for. Method parameters should be documented using @param. Don't rely on the name of the method or the parameters to be fully self-documenting. Besides, writing these things down properly will trigger Doxygen errors if you change them in an incompatible way later -- and that is going to save you lots of time in finding source and binary incompatibilities and explaining to users why their code suddenly doesn't do what they expect (assuming it compiles at all). So good method apidox is an additional insurance against making bad changes. Same caveats apply.
*Every enumeration type should have a comment explaining what the enumeration is for, even if it's just /** Various constants */.
*Every enumeration value should have a comment too, to explain what it represents. Don't rely on the name of the enumeration value being sufficiently expressive.<br />For the purposes of readability, I suggest that you document enumeration values after the value, as opposed to the documentation format for namespaces, classes and methods where you write the documentation in front of the thing you are documenting. The format of the documentation is slightly different. Instead of writing /** Documentation */ in front, you write /**< Documentation afterards */, where the < denotes that the documentation applies to the thing just past.<br />It looks like this:
<code cppqt>
enum State {
none, /**< No bracket seen */
bracket, /**< Found a ( for grouping */
squote, /**< Found a single quote */
dquote /**< Found double quotes */
};
</code>

'''3. Watch this space!'''

Watch the [http://www.englishbreakfastnetwork.org/ English Breakfast Network] for the [http://www.englishbreakfastnetwork.org/apidocs/ results] of your apidox work. Check the log files for errors -- Doxygen can complain quite loudly.

'''4. Write a main page for your application.'''

This is usually done in a separate file {{path|Mainpage.dox}} in the top-level of a library or application. The file's content is just a single apidox comment that starts with /** @mainpage title ; the rest of the file is just a long comment about what the library or application is for.

== Fixing APIDOX in Old Code ==

Writing apidox in old code is a lot like writing the same apidox in new code, except that there is more cruft in the way. The number 1 tip to follow is: watch the logs on English Breakfast Network. Those will show you what errors there are in the apidox. However, Doxygen can't catch everything that is wrong with the documentation on its own, so you will have to do some reading yourself. The other tips for new apidox apply equally here: you want to document everything, in a consistent style. If methods show up on the generated apidox pages with no documentation, you know that you have more apidox to write. (Doxygen may provide an error message, but doesn't do that everywhere in the current setup because there would just be too many.)

In old apidox, you are more likely to suffer from the following symptoms:

*Missing parameter documentation (because parameters were renamed, or added, or removed, or something).
*Missing method documentation.
*Missing class documentation.
*Documentation that has wandered off on its own and is attached to the wrong thing now.

The first of these can be fixed by correcting the parameter documentation. See the examples section. The next two -- missing documentation that you can see is there in the source files but that does not show up in the generated HTML pages, is usually a matter of missing documentation on surrounding blocks. See the common pitfalls section, and make sure that the surrounding classes, namespaces and files all have documentation.

The last problem can best be fixed by moving the offending documentation back to where it belongs (really, it's not the documentation that is at fault, it's whatever has squeezed in -- the home-breaker -- between the documentation and the thing it was originally attached to). You could use some Doxygen special tags to avoid moving stuff around like that, but it does not help the understandability of the source much.

== Example APIDOX ==

So what does documentation look like in the headers? How do you write a method documenation that describes the parameters as well? This section contains boilerplate for most common situations. Doxygen does not require a strict style -- it will ignore whitespace and asterisks at the beginning of a line, so you can make the documentation ASCII-pretty.

'''Documentation for a file:''' The newline after @file is significant! The text after @author is listed in a special Authors section of the apidox; you can list multiple authors.

<code cppqt>
/** @file
* This file is part of AnApplication and defines
* classes Ungulate and Moose.
*
* @author Mostly by me
*/
</code>

'''Documentation for a namespace:'''

<code cppqt>
/**
* This namespace collects functions related to
* counting and enumeration of mammals and their limbs.
*/
</code>

'''Documentation for a class:''' Some Doxygen special commands are used here to provide additional information. @author (as with files) identifies authors of the code; these are collected in a special ''Authors:'' section of the apidox. You can list more than one author. The @since tag tells users since when the class has existed. It is usual to put a KDE release number here.

<code cppqt>
/**
* This class represents a Moose in the woodland
* simulator. A single Moose object can be created,
* but it is more useful to instantiate Moose::Factory
* by calling Moose::factory(), and then calling spawn()
* for each new Moose, since that maintains the ecological
* balance far better.
*
* @author Adriaan de Groot <degroot@kde.org>
* @since 3.5
*/
</code>

'''Method documentation:''' We can use @author and @since just like we do for classes. In addition, there are the parameters of the method that can be described. @p is used to refer to them in running text, and @param is used to construct a list of parameter descriptions that is specially formatted. Finally, @return entries describe the values that may be returned by the method.

<code cppqt>
/**
* This method names a particular Moose and as a side effect
* sets whether or not the Moose is treated as a Reindeer.
* When @p santa is @c true, the name of the moose is set to
* the next of the available Reindeer (if possible).
*
* @param name name to assign to the Moose, which is only
* relevant if the moose is not a Reindeer.
* @param santa is this Moose assigned to Santa? if so, the
* name is irrelevant.
*
* @return @c true if naming the Moose succeeded
* @return @c false if naming the Moose failed. This only
* happens if the Moose is assigned to Santa duty
* but there are already eight named Reindeer.
*/
bool name(const QString &name, bool santa = false);
</code>

Enum documentation is described in the section on writing new apidox. The same kind of documentation as for classes applies, with the addition of the documentation for each enumerated value which belongs inline.

== Common Pitfalls ==

This section lists common pitfalls in writing apidox. Typically, they are easily
overlooked mistakes that produce weird error messages, but I will also include
some stylistic pitfalls that should be avoided.

'''Missing APIDOX''': You ''know'' you wrote dox for class Moose, but after
generation they are not visible. You ''know'' that the file-scope function int
foo() is documented, but it's not there either! What is going on?

The most common pitfall, the one that leads to "missing" apidox, is forgetting
to document surrounding structure. The "structure" in the source comes from
files, namespaces, classes and methods. In order to document a class you must
document the namespace it is in (if there is one) and the file that it is in.
In order to document a method, you must document the class it is in (and thus
the namespace and file). So the easiest rule of thumb is to
document ''everything''.
{{note|This hard-and-fast rule is not quite accurate:
classes do not need the file to be documented,
so you can leave out the /** @file */ comment for
source files containing only classes (and namespaces).
Note that classes in a namespace require the namespace
to be documented, but classes in the :: namespace
don't need extra documentation.
I'm not sure about anonymous namespaces.

For file-scoped functions -- that is, functions
that are defined in a file, not in a namespace
and not in a class,
you ''must'' document the file
they are in. This applies mostly
to files which collect a bunch of non-method utility functions.}}

'''Broken parameter documentation:''' Documenting parameters to methods can be done two ways: you can document <em>none</em> of them, or you can document
''all'' of them for a given method. There is no middle ground (that doesn't
generate gobs of errors that you should fix).

If you document ''all'' of your parameters (which is a good thing to do,
and generates things in a nicely formatted fashion), then your method
apidox consists first of a general description of the method and then a
bunch of @param tags which describe each individual parameter. The @param
tag is followed by the name of the parameter -- watch out for spelling
and case-sensitivity! -- and then the description. The description can
span multiple lines.
<code cppqt>
/** Calculate the root-mean-square distance from the
* origin to the given integral coordinate.
*
* @param y y-coordinate, which is on an axis perpendicular to the
* x-axis, yet still in the same plane.
* @param x x-coordinate
*/
</code>

When you document all the parameters like this, Doxygen will complain if
you misspell parameter names, or forget some, or mention parameters that
are not there. This will force you to update the documentation if you
change the method signature. And that's a good thing.

Additional pitfalls are putting the type of the parameter in the list,
like @param int x, which makes "int" the name of the parameter. Another
pitfall is that @param should come <em>after</em> the general description.
Once the @param list starts, nothing can stop it except for other
list-style Doxygen tags like @since, @author or @return. So write @param
after the story and before, say, @return.

If you document ''none'' of the parameters, you do not use the @param tag
at all. You can talk about your parameters by writing @p before the name
of a parameter (or anything else, really, but it only makes sense in front
of a name of a parameter). Like this:
<code cppqt>
/** Calculate the root-mean-square distance from the origin to
* the given integral coordinate which is given as a pair @p x,
* @p y. If @p nonFree is true, use ESR instead of RMS in the
* computation.
*/
double distance(int x, int y, bool nonFree=false);
</code>

'''Misuse of tags in running text:''' This boils down to the warning
above about where to put @param: not every Doxygen tag can go anywhere.
Some start lists or basically end the general description part of a
description, so you need to avoid using them in running text.

'''Chosing between Doxygen errors and compiler warnings:''' If you are
going to document your parameters, you need to name them. If you are
defining a stub method, this can lead to compiler warnings.

'''Accidental tags:''' It can be easy to accidentally use Doxygen tags
in running text -- email addresses, backslash escapes, those are the
easy ones. Watch the Doxygen logs and escape that at sign with a backslash
when needed (i.e. write \@ to get an at sign). It's probably a good
idea to avoid the backslash style of apidox entirely; at the same time, if
you happen to write \moose, Doxygen will complain that that is an invalid
tag.

'''Accidental HTML:''' If you use < and > in your apidox, these may
confuse Doxygen -- especially if you write things like <service>
which look like HTML tags. This is a common way of writing some kind of
element that may be replaced in a method call or string or something, so
it crops up all the time. You know, you write some thing like this:
<code cppqt>
/** This method connects to a database. The connection string is
* composed of a username, password, host and database name as
* follows:
* <username>:<password>@<host>//<database>
*
* @return true if the connection succeeded.
*/
</code>

This bit of dox is terribly broken, because the whole sample connection
string will be interpreted as (bad) HTML and ignored. There are two
solutions:
<ol>
*Write \< instead of just < to escape the < and make Doxygen output it normally. Doxygen is smart enough to turn this into &lt; in HTML output. This has only a minimal impact on readability of the dox in the header files themselves.
*Use the HTML formatting that Doxygen makes available, and write <i>''foo''</i> instead of <<i>foo</i>>. This produces nicer output with italics instead of plain text, so it is easier to spot what is the replaceable part of the text. The downside is that it has a larger visible impact on the apidox in the headers.
</ol>

;Superfluous @ref
:It can be tempting -- certainly if you've written dox for other projects -- to use #method or @ref method to force a reference to another method somewhere. Relax, it's not needed and usually causes Doxygen warnings to boot. Just name the method normally, make apidox and watch the references appear naturally.

== KDE Specific Tags ==
'''@bc''': This tag indicated binary compatibility, much like ''@since'' does. The argument after ''@bc'' is the scope of binary compatibility (for instance, KDE4). Classes that are not marked with ''@bc'' may, in some modules, be flagged as incompatible so that they can be avoided.

Example:
<code cpp>
/**
* This class emulates a Moose.
* @bc KDE4.2 Compatibility is expected to break
* with next-generation mooses.
*/
</code>

'''@libs''': Use this tag to indicate what libraries should be linked in for the given class. Although this is usually the name of the directory the class lives in, this is not always the case.

Example:
<code cpp>
/**
* This class emulates a Moose.
* @libs
* @a -lkdeui or use \$(LIB_KDEUI) in the KDE build framework.
*/
</code>

== Code Examples in APIDOX ==

It can be useful to put example code in the APIDOX for a class.
Very useful, in fact, for the reader who is wondering
how exactly to use the class in a straightforward way.
Most classes in {{path|kdelibs/kdecore}} have example code.

One way to write example code is to use @code and @endcode around
blocks of example code in the Doxygen comments themselves, like this:
<code cppqt>
/**
* This class represents a Moose.
* The correct way of generating Meese is to use the factory:
*
* @code
* Moose::Factory outlet = Moose::factory();
* Moose *m = outlet.spawn();
* @endcode
*/
</code>

This is how most of the examples in {{path|kdelibs}}
are done, actually. It works reasonably well, you can pare the
example down to something really minimal and leave out all the
boilerplate.

An important drawback of this approach to writing example code is that
the code is never checked to see if it actually works.
The code is also ''so'' terse, usually, that it's hard
to expand into a complete example that actually compiles and runs.

To solve this problem, you can write ''real code'' that
actually compiles (as part of the test suite for the code
that you have anyway) and that illustrates exactly
how to use the class under consideration in an actual program.
Better yet, you do not need to include ''all'' the code
in the APIDOX, just the interesting bits.
The way to do this is to put the code in a file in the
<tt>tests/</tt> subdirectory of your code.
Then use Doxygen's @include tag to include the
code from that file into the API documentation.

{{warning|Do not use @example! It does something totally different
from what you might expect (it doesn't insert example code, for one thing).}}

[[Category:Documentation]]

Development/Tutorials/API Documentation

2007-06-23T13:07:03Z

Fatalerrors: add langage bar

Development/Further Information (fr)

2007-06-23T13:04:37Z

Fatalerrors:

{{Template:I18n/Language Navigation Bar|Development/Further Information}}
== Web Sites ==
* [http://www.KDE.org KDE Home]
* [http://dot.kde.org KDE Dot News]
* [http://www.planetkde.org Planet KDE]

==Blogs==

== Books ==
Below are a list of books associated with KDE 4 development. These may be specific to applications, using the Qt Toolkit, or specifically KDE 4 books.

===KDE 4 Development Books===

[mailto:manishchaks@gmail.com Manish Chakravarty ] from [http://kde.in KDE India] is working on a KDE 4 programming book.
The scheduled release date is the the 15th of August 2007

===Qt 4 Development Books===

==== English ====

[http://www.phptr.com/bookstore/product.asp?isbn=0131879057&rl=1|The Book of Qt 4: The Art of Building Qt Applications By Alan Ezust, Paul Ezust.]

[http://www.phptr.com/bookstore/product.asp?isbn=0131872494&rl=1|C++ GUI Programming with Qt 4 By Jasmin Blanchette, Mark Summerfield.]

==== German ====

[https://www.opensourcepress.de/index.php?26&backPID=15&tt_products=23 Qt 4: Einführung in die Applikationsentwicklung von Daniel Molkentin]

== IRC Channels ==
In general, IRC channels mentioned here are available on FreeNode. Connect to irc.kde.org, and check these channels out for further information.

*KDE 4 Development - [irc://irc.kde.org:6667/kde4-devel #kde4-devel]
*KDE Development - [irc://irc.kde.org:6667/kde-devel #kde-devel]
*KDevelop - [irc://irc.kde.org:6667/kdevelop #kdevelop]
*Phonon - [irc://irc.kde.org:6667/phonon #phonon]
*Decibel - [irc://irc.kde.org:6667/decibel #decibel]
*Solid - [irc://irc.kde.org:6667/solid #solid]

== Newsgroups ==
== Forums ==
== Events ==
== Courses and Certifications ==
== Audio and Video Casts ==
== Source Code Repositories ==

Development/Further Information

2007-06-23T13:03:36Z

Fatalerrors:

Development/FAQs (fr)

2007-06-23T12:49:52Z

Fatalerrors:

{{Template:I18n/Language Navigation Bar|Development/FAQs}}
{{improve}}
;[[Development/FAQs/General FAQ|General questions]]
:How to get involved in KDE development
;[[Development/FAQs/Technical FAQ|Technical questions]]
:Technical questions for KDE developers
;[[Development/FAQs/Debugging FAQ|Debugging questions]]
:How to debug your application

If you have questions which are not answered in the FAQs simply add them. Other contributors will probably answer.

Original question list by Philippe Fremy, answers by David Faure.<br /><br />
Contributions from: Marco Krohn, Malte Starostik, Andreas Pour, Waldo Bastian, Lars Knoll, Triskelios, Eric Sigra, Rolf Dubitzky, Martijn Klingens, Karl-Heinz Zimmer, George Staikos.<br /><br />
<tt>(TODO: replace this sentence with something like "Edit this page" ?)</tt>Please send additional questions, responses or comments to pfremy at kde dot org

[[Category:FAQs]]

Development/FAQs

2007-06-23T12:48:13Z

Fatalerrors: add langage bar

{{Template:I18n/Language Navigation Bar|Development/FAQs}}
{{improve}}
;[[/General FAQ|General questions]]
:How to get involved in KDE development
;[[/Technical FAQ|Technical questions]]
:Technical questions for KDE developers
;[[/Debugging FAQ|Debugging questions]]
:How to debug your application

If you have questions which are not answered in the FAQs simply add them. Other contributors will probably answer.

Original question list by Philippe Fremy, answers by David Faure.<br /><br />
Contributions from: Marco Krohn, Malte Starostik, Andreas Pour, Waldo Bastian, Lars Knoll, Triskelios, Eric Sigra, Rolf Dubitzky, Martijn Klingens, Karl-Heinz Zimmer, George Staikos.<br /><br />
<tt>(TODO: replace this sentence with something like "Edit this page" ?)</tt>Please send additional questions, responses or comments to pfremy at kde dot org

[[Category:FAQs]]

Contribute (fr)

2007-06-23T12:45:22Z

Fatalerrors: /* KDE */ -- links correction

{{Template:I18n/Language Navigation Bar|Contribute}}
Cette page a pour but de donner un aperçu des différents aspects du développement de KDE en particulier concernant sa programmation. '''Le projet KDE accueille avec plaisir tout ceux qui sont prêts à le faire avancer'''.

{{note|Il existe de nombreuses de façons de faire évoluer le développement de KDE. Elles peuvent être divisées en plusieurs catégories :
:''Documentation, traduction, développement, utilisation, accessibilité, travaux artistique, promotion.
'''Concernant les taches autres que le développement (écriture de code) les pages de KDE expliquant [http://kde.org/getinvolved/ comment participer] donnent un bon aperçu.'''
}}

== Ressources News et Mails ==
La direction générale du projet KDE est déterminée par ceux qui font le travail - il n'y a pas de planification globale de ce que KDE deviendra dans le futur.

Si vous voulez savoir ce qu'il se passe en ce moment, il y a un certain nombre de ressources que vous pouvez utiliser :
; [http://www.kde.org/mailinglists/ Mailing Lists]
: Surement la meilleure façon de se tenir au courant de ce qui se passe dans la développement de KDE. Des archive sont disponibles [http://lists.kde.org ici]

; [http://commitfilter.kde.org/ CommitFilter]
: Recevez des notifications des commits [http://en.wikipedia.org/wiki/Subversion] dans les sujets qui vous intéressent.

; [http://commit-digest.org/ KDE Commit-Digest]
: Résumé hebdomadaire de commits SVN.

; [http://dot.kde.org/ The Dot]
: Le site des news de KDE.

== Débuter en écrivant du code ==
Débuter en ''codant'' dans KDE est une façon de chercher quelque chose à corriger, et à le corriger. Vous devriez consulter la description générale du module pour essayer de trouver ce que vous cherchez; une fois la correction faite, vous voudrez l'envoyer sous forme d'un patch. Si vous faites cette opération régulièrement, you pourrez avoir accès à un compte SVN avec lequel vous pourrez faire vos corrections dirrectement.
* [[Contribute/List of KDE Modules|Description générale du module]]
* [[Contribute/Send Patches|Envoyer des patches]]
* [[Contribute/Get a SVN Account|Accèder à un compte SVN de KDE]]
* [[Contribute/First Steps with your KDE SVN Account|Premiers pas avec votre nouveau compte SVN]]

Pour le moment, il y a deux possibilités de développement au sein de KDE - vous pouvez travailler sur KDE3, ou KDE4. KDE3 est un bon choix pour la correction de bug, cependant le travail de développement principal (et toutes les nouvelles fonctionalités) sont sur KDE4. Se document s'orriente principalement sur le travail de support pour KDE4.

=== C++ ===
KDE est en grande partie écrit en C++. Si vous n'êtes pas un famillié du C++, vous devriez au moins faire quelques travaux avec. Il y a un grand nombre de bon livre sur C++ (quelques un en français, les meilleurs et ceux suscité sont cependant en anglais) - une source excellente est [http://mindview.net/Books/TICPP/ThinkingInCPP2e.html "Thinking in C++" de Bruce Eckel (en français "Penser en C++")], qui est disponnible à la fois en téléchargement gratuit et en document imprimé. Il n'est pas essenciel de tout comprendre avant de commencer avec KDE, mais vous devrez comprendre la syntaxe et les oppérations de base.

=== Qt ===
Pour devenir compétent avec la programmation de KDE, vous devrez comprendre le toolkit Qt. Si vous ne connaissez pas bien Qt, il vous faudras travailler à l'aide des tutoriaux inclus avec Qt ([http://doc.trolltech.com/latest/examples.html pour la version Qt4], [http://doc.trolltech.com/3.3/tutorial.html pour la version Qt3]).

Si vous préférez une introduction multimédia et vidéos vous serez heureux de passer deux folles minutes en regardant [http://www.trolltech.com/trolltech/products/qt/learnmore/video/demos/browser Créer un navigateur de documentation d'aide simple avec Qt4 Designer]. Si cela a retenu votre attention vous devriez aussi regarder la vidéo d'introduction [http://www.trolltechvideo.com/video/day1/room_a/a_1_1/video.html Bonjours Qt] de Mark Summerfield qui fait partie des [http://www.trolltech.com/company/newsroom/events/allevents/devdays2006/videolinks présentations du Trolltech Developer Days 2006]. Il faut noter que toutes ces vidéos sont en anglais.

Si vous avez besoin d'une introduction à Qt plus en douceur, ou si vous souhaiter avoir un point de vue alternatif, alors vous aimeriez jetter un oeuil au [http://qt4.digitalfanatics.org/tiqt/ Tutoriel Indépendent pour Qt (anglais)] (Actuellement hors ligne à cause de contrats littéraires).

D'autre suggestions sur la manière de devenir familier avec Qt4 are [http://doc.trolltech.com/latest/how-to-learn-qt.html également disponible ici]. Une copie de cette documentation est, par ailleurs, distribué avec Qt4.

Pour les documentations en français concernant Qt, le site de la [http://qtfr.org Communauté francophone Qt] est la meilleurs source d'information et de documentation en français.

=== KDE ===
Une gamme d'informations sur les technologie de KDE est disponible dans la [[Development/Tutorials_(fr)|catégorie des tutoriaux]] en Français. Notez que certains de ces tutoriaux sont toujours orienté pour KDE3, cependant ils devrais être au moins partiellement applicable.

Vous trouverez aussi des informations utiles sur la programmation de KDE dans la section des [[Development/FAQs|FAQs]]. Les informations que vous y trouverez pourrais également être quelque peu ancienne par rapport à KDE4, cependant la plus grande partie est largement applicable, même en dehors de KDE.

Vous pouvez aussi lire [[Development/Further Information_(fr)|livres de programmation KDE]] en français.

Enfin, KDE est lié à des classes étendues (API - Application Programmer Interface - Interface de programmation d'application) qui sont documenté. Cette documentation est dans le
[[Development/Tutorials/API Documentation_(fr)|Manuel de référence de l'API de KDE]] partiellement en français, qui contiens aussi nombres de liens utiles sur la manière d'écrire ou mettre à jours la documentation des classes. Vous pouvez aussi la générez sur votre machine, ou vous référer à une version en ligne plus à jours sur [http://www.englishbreakfastnetwork.org/apidocs/apidox-kde-4.0/kdelibs-apidocs/ The English Breakfast Network] en anglais.

Une description plus détaillé des étapes ci-dessus est disponible dans notre [http://quality.kde.org/develop/howto/howtohack.php guide du programmeur] en anglais.

== Participer à la chasse aux bugs et à l'amélioration des applications ==

There are a large number of applications within KDE, and not all of them have a maintainer dedicated to managing bugs and generally helping out with all the issues associated with turning some working code into a polished application.

If you are interested in helping out with KDE, but don't know where to start, becoming a member of the KDE Quality Team might appeal to you - see the [http://quality.kde.org Quality Team website] for more information. Note that you do not need any programming skills to become involved.

Of course, you can become involved in bug hunting without being part of the KDE Quality Team - just create yourself an account on the KDE [http://bugs.kde.org bug tracking system], and start searching / sorting through the bugs. Again, you don't have to have programming skills - it helps the programmers enormously just to have a procedure that allows a bug to be consistently reproduced.

The [[/Bugsquad|Bugsquad]] tries to keep track of bugs in KDE software and make sure that valid bugs are noticed by developers. You do not need any programming knowledge to be in the Bugsquad; in fact it is a great way to return something to the KDE community if you cannot program.

== Archives ==

; [http://www.kerneltraffic.org/kde/ Kernel Cousin KDE]
: Summary of the development mailing lists. The Kernel Cousin KDE ran for 76 issues, from 10 March 2001 until 16 April 2004. The KDE Commit-Digest (described above) is its logical successor.

Development/Tutorials (fr)

2007-06-23T12:43:15Z

Fatalerrors:

{{Template:I18n/Language Navigation Bar|Development/Tutorials}}
Tutorials are the fastest way of finding out what KDE will do for you, and how to do it. Here is a list of currently available tutorials '''for KDE4'''. Material for KDE3 and KDE2 is available on the bottom of this page.

== Getting started ==
;[[/Programming Tutorial KDE 4|Introduction To KDE 4 Programming]]
:''Are you interested in writing applications with KDE 4? This tutorial series is aimed at those completely new to KDE programming.''

;[[/KDE4 Porting Guide|Porting Your Application]]
:''Help Porting Applications from Qt3/KDE3 to Qt4/KDE4''

;[[/CMake|Introduction to CMake]] ([[/CMake_(zh_CN)|Simplified Chinese version]])
:''How to use the CMake build system used by KDE4.''

;[[/Common Programming Mistakes|Common Programming Mistakes]]
:''Various common mistakes made while developing Qt and KDE applications and how to avoid them.''

;[[/Using Qt Designer|Using Qt Designer to build user interfaces]]
:''How to create UI files with designer, and how to integrate them into a KDE program.''

;[[/Command-Line Options|Using Command-line Options]]
:''Processing and accessing command-line arguments the easy way with KDE's command line arguments classes.''

== Testing And Debugging ==

;[[/Debugging|Debugging your application]]
:''Tips, tools and techniques to apply when debugging your KDE application''

;[[Development/Tutorials/Unittests|Writing Unittests for Qt4 and KDE4 with QTestLib]] ([http://developer.kde.org/documentation/tutorials/writingunittests/writingunittests.html Original link])
:''Tutorial by [mailto:bradh@frogmouth.net Brad Hards] that describes how to write unit tests using the QTestLib framework. It is presented as an example based tutorial, and is still under development.''

;[[/Code_Checking|Semi-automatic ways to detect code errors]]
:''Techniques you can use to detect errors in KDE code''

== Managing Configuration Data With KConfig ==
;[[/KConfig|Introduction To KConfig]]
:''An overview of the KConfig classes and how to use them in your application code''

;[[/Using KConfig XT|Using KConfig XT]]
:''Tutorial on how to efficiently use the KConfig XT framework.''

== Localization ==
;[[/Localization/Unicode|Introduction To Unicode]]
:''An introduction to what Unicode is as well as how to handle Unicode data in KDE applications.''

; [[/Localization/i18n|Writing Applications With Localization In Mind]]
:''This tutorial covers what localization is, why it's important and how to ensure your application is ready to be localized. A must read for all application developers.''

; [[/Localization/i18n Mistakes|Avoiding Common Localization Pitfalls]]
:''There are several common mistakes that prevent applications from being properly localized. Find out what they are and how to easily avoid them in this tutorial.''

; [[/Localization/Building KDE's l10n Module|Building KDE's Localization Module]]
:''Building and installing language support from KDE's localization (l10n) module is a good idea for those working on applications in the main KDE repository. Doing so will allow you to test your application in another language and spot problem areas. Learn how to do just that in this tutorial.''

; [[/Localization/i18n Build Systems|Incorporating i18n Into the Build System]]
:''Once your application is ready to be localized, the next step is to ensure that translation files are built automatically and kept up to date. This tutorial covers the necessary CMakeFiles.txt additions as well the process of distributing the resulting message catalogs with your application.''

; [[/Localization/i18n Challenges|Common i18n Challenges and Solutions]]
:''This tutorial covers challenges that you may eventually run into such as translating handbooks and other data that exists outside of the source code, merging and handling obsolete .po files, dealing with freezes, coding in languages other than English and creating independent releases of or moving applications between KDE modules.''

== Documentation ==

;[[Development/Tutorials/API_Documentation|API Documentation]]
:''This tutorial explains how to document your APIs properly.''

== Application Automation and Scripting ==

=== D-Bus ===
; [[/D-Bus/Introduction|Introduction to D-Bus]]
:''A straight-forward introduction to the core concepts in D-Bus from an application developer's perspective, this tutorial covers what D-Bus is and how it can be used by applications.''
; [[/D-Bus/Accessing Interfaces|Accessing D-Bus Interfaces]]
:''A step-by-step guide to calling D-Bus methods and connecting to D-Bus signals using QtDBus.''
; [[/D-Bus/Intermediate_D-Bus|Intermediate D-Bus]]
:''Tips to make use of QtDBus when faced with problematic real-world interfaces.''
; [[/D-Bus/Creating Interfaces|Creating D-Bus Interfaces]]
:''Learn how to expose functionality in your application by creating and using custom D-Bus interfaces. Covers generating the XML descriptions, instantiating interfaces at run time and setting up the build system with CMake.''
; [[/D-Bus/Autostart Services|D-Bus Autostart Services]]
:''Turn your application into a D-Bus autostart service with this tutorial. This D-Bus feature, also known as "D-Bus service activation", will ensure that even when your application isn't running that D-Bus calls made to it will work by relying on the D-Bus daemon itself to start your app if and when needed.''
; [[/Porting_to_D-Bus|Porting from DCOP to D-Bus]]
: ''Port your applications from DCOP to D-Bus with this handy guide.''

=== Konqueror ===
; [[/Creating Konqueror Service Menus|Creating Konqueror Service Menus]]
:''This tutorial shows you how to create mimetype-specific actions in Konqueror's context menu (aka "servicemenus").''

=== Kross ===
; [[Development/Tutorials/Kross/Introduction|Introduction to Kross]]
:''An introduction to the Kross Scripting Framework.''

; [[Development/Tutorials/Kross/Scripts-as-Plugins|Scripts as Plugins with Kross]]
:''This tutorial provides a step-by-step introduction how to integrate scripts as plugins into a KDE application.''

; [[Development/Tutorials/Kross-Tutorial|Kross Tutorial]]
:''This tutorial explains how to integrate the Kross scripting framework into an application. '''TODO''' ''

=== KOffice ===
; [[Development/Tutorials/KOffice Overview]]
:''This document shows an overview of the different KOffice plugin types and tells you what each of their purpose and strengths are.'' If you are new with KOffice plugins, this is the place to start.

; [[Development/Tutorials/Write a Flake Plugin|Creating KOffice Flake Plugins]]
:''This tutorial shows you how you can build a plugin for KOffice applications to allow you embed content in ODF documents using Flake.''

; [[Development/Tutorials/KWord Scripting|KWord Scripting]]
:''This tutorial shows how to script KWord with Python, Ruby or JavaScript using Kross.''

; [[Development/Tutorials/KSpread Scripting|KSpread Scripting]]
:''This tutorial shows how to script KSpread with Python, Ruby or JavaScript using Kross.''

; [[Development/Tutorials/Krita Scripting|Krita Scripting]]
:''This tutorial shows how to script Krita with Python, Ruby or JavaScript using Kross.''

=== SuperKaramba ===
; [[Development/Tutorials/SuperKaramba|SuperKaramba Tutorial]]
:''This tutorial provides an overview of SuperKaramba, theme files and scripting with Python, Ruby and JavaScript.''

== Search and Metadata ==

=== Strigi ===

; [[/Writing file analyzers|Writing file analyzers]]
:''File analyzers extract data from files to display in the file dialogs and file managers. The data gathered this way is also used to search for files. KDE4 allows the use of multiple analyzers per file type. This tutorial describes how you can write new analyzers.''

=== Nepomuk ===

; [[/Metadata/KMetaData first steps|Nepomuk first steps]]
:''Nepomuk is the KDE library which provides easy access to metadata in the [http://nepomuk-kde.semanticdesktop.org Nepomuk-KDE] system. Learn how to make your application create and read metadata using the Nepomuk system.''

== Hardware Awareness (Solid) ==

;[[/Solid_Tutorials|Introduction to Solid]]
:''An introduction to using the Solid hardware discovery and interaction system in KDE applications.''

;[[/Solid_Network_Tutorial|Accessing Network Information]]
:''How to use the Solid system to get information about the network''

== Multimedia (Phonon) ==

;[[/Phonon/Introduction|Phonon]]
:''How to start with the multimedia API''

==Printing==

;[[/Printing Hello World|Hello World]]
:''Introduction to the KDE printing system''

;TODO Print Dialog
:''Using the KDE print dialog''

== Get Hot New Stuff ==
; [[Development/Tutorials/Introduction to Get Hot New Stuff|Introduction to Get Hot New Stuff]]
:''An introduction to the developer-friendly network update system that allows KDE applications to fetch new application data at runtime in a user friendly manner.''

;[[Development/Tutorials/KNewStuffSecure|KNewStuff Secure]] ([http://developer.kde.org/documentation/tutorials/knewstuffsecure/index.html Original Link])
:''Tutorial showing how to share resources in a secured way (KDE 3.4 and later).'' By András Mantia <amantia@kde.org>.

== Rapid Application Development ==

=== Python ===

;[[Development/Tutorials/Python introduction to signals and slots|101 Introduction to signals and slots]]
:''A simple introduction to Qt's signal and slot architecture.''

=== Ruby ===

;[http://developer.kde.org/language-bindings/ruby/kde3tutorial/index.html KDE Ruby Korundum tutorial]
:''A ruby version of Antonio Larrosa Jiménez's KDE tutorial by Richard Dale. See the [http://developer.kde.org/language-bindings/ruby/index.html Ruby Developers Corner] for Qt tutorials and other info.''

;[[Development/Tutorials/Qt4_Ruby_Tutorial|Qt4 Ruby Tutorial]]
:''Trolltech's fabulous introductory tutorial to Qt, translated to Ruby.''

=== Shell ===

;[[Development/Tutorials/Shell_Scripting_with_KDE_Dialogs|Shell Scripting with KDE dialogs]] ([http://developer.kde.org/documentation/tutorials/kdialog/t1.html Original Link]) [[Development/Tutorials/Shell_Scripting_with_KDE_Dialogs_(de)| (German version)]]
:''Tutorial by [mailto:bradh@frogmouth.net Brad Hards] that describes how to use KDE dialogs in shell scripts with kdialog. It is presented as an example based tutorial.''

== Other tutorials ==

=== Using the KDE Games Library ===
;[[/Games/KStandardGameAction| KStandardGameAction]]
:''Using libkdegames to make your game fit the kdegames standard''
;[[/Games/Highscores| Highscores]]
:''Implementing a simple highscore table into your game''
;[[/Games/Theme Selector| Theme Selector]]
:''Using the libkdegames theme selection dialog''

=== 2D Plotting (KPlotWidget) ===
;[[/KPlotWidget|Using the KDE data-plotting widget]]
:''This tutorial introduces KPlotWidget, which is used for 2-D data plotting. It includes information on simple usage of the widget (including adding and modifying data sets, and customizing the plot axes and labels), and advanced customization (including extending the widget through sub-classing).''

=== Spelling and Grammar Checking (Sonnet) ===
;[[/Sonnet/SonnetTutorial|Adding spell-checking or grammar-checking to KDE applications]]
:''This tutorial introduces Sonnet and how one may use it to add language correction to your KDE application. Sonnet's auxiliary features shall be described in a separate tutorial.''

== KDE2 and KDE3 Materials ==

;[[Development/Tutorials/KDE3|KDE3 Tutorials]]
:''These tutorials cover topics related to KDE3.''

;[[Development/Tutorials/KDE2|KDE2 Tutorials]]
:''These tutorials cover topics related to KDE2.''

[[Category:KDE4]]

Development/Tutorials

2007-06-23T12:42:45Z

Fatalerrors: ooops

Development/Tutorials

2007-06-23T12:41:32Z

Fatalerrors: add langage bar

{{Template:I18n/Language Navigation Bar|/Development/Tutorials}}
Tutorials are the fastest way of finding out what KDE will do for you, and how to do it. Here is a list of currently available tutorials '''for KDE4'''. Material for KDE3 and KDE2 is available on the bottom of this page.

== Getting started ==
;[[/Programming Tutorial KDE 4|Introduction To KDE 4 Programming]]
:''Are you interested in writing applications with KDE 4? This tutorial series is aimed at those completely new to KDE programming.''

;[[/KDE4 Porting Guide|Porting Your Application]]
:''Help Porting Applications from Qt3/KDE3 to Qt4/KDE4''

;[[/CMake|Introduction to CMake]] ([[/CMake_(zh_CN)|Simplified Chinese version]])
:''How to use the CMake build system used by KDE4.''

;[[/Common Programming Mistakes|Common Programming Mistakes]]
:''Various common mistakes made while developing Qt and KDE applications and how to avoid them.''

;[[/Using Qt Designer|Using Qt Designer to build user interfaces]]
:''How to create UI files with designer, and how to integrate them into a KDE program.''

;[[/Command-Line Options|Using Command-line Options]]
:''Processing and accessing command-line arguments the easy way with KDE's command line arguments classes.''

== Testing And Debugging ==

;[[/Debugging|Debugging your application]]
:''Tips, tools and techniques to apply when debugging your KDE application''

;[[Development/Tutorials/Unittests|Writing Unittests for Qt4 and KDE4 with QTestLib]] ([http://developer.kde.org/documentation/tutorials/writingunittests/writingunittests.html Original link])
:''Tutorial by [mailto:bradh@frogmouth.net Brad Hards] that describes how to write unit tests using the QTestLib framework. It is presented as an example based tutorial, and is still under development.''

;[[/Code_Checking|Semi-automatic ways to detect code errors]]
:''Techniques you can use to detect errors in KDE code''

== Managing Configuration Data With KConfig ==
;[[/KConfig|Introduction To KConfig]]
:''An overview of the KConfig classes and how to use them in your application code''

;[[/Using KConfig XT|Using KConfig XT]]
:''Tutorial on how to efficiently use the KConfig XT framework.''

== Localization ==
;[[/Localization/Unicode|Introduction To Unicode]]
:''An introduction to what Unicode is as well as how to handle Unicode data in KDE applications.''

; [[/Localization/i18n|Writing Applications With Localization In Mind]]
:''This tutorial covers what localization is, why it's important and how to ensure your application is ready to be localized. A must read for all application developers.''

; [[/Localization/i18n Mistakes|Avoiding Common Localization Pitfalls]]
:''There are several common mistakes that prevent applications from being properly localized. Find out what they are and how to easily avoid them in this tutorial.''

; [[/Localization/Building KDE's l10n Module|Building KDE's Localization Module]]
:''Building and installing language support from KDE's localization (l10n) module is a good idea for those working on applications in the main KDE repository. Doing so will allow you to test your application in another language and spot problem areas. Learn how to do just that in this tutorial.''

; [[/Localization/i18n Build Systems|Incorporating i18n Into the Build System]]
:''Once your application is ready to be localized, the next step is to ensure that translation files are built automatically and kept up to date. This tutorial covers the necessary CMakeFiles.txt additions as well the process of distributing the resulting message catalogs with your application.''

; [[/Localization/i18n Challenges|Common i18n Challenges and Solutions]]
:''This tutorial covers challenges that you may eventually run into such as translating handbooks and other data that exists outside of the source code, merging and handling obsolete .po files, dealing with freezes, coding in languages other than English and creating independent releases of or moving applications between KDE modules.''

== Documentation ==

;[[Development/Tutorials/API_Documentation|API Documentation]]
:''This tutorial explains how to document your APIs properly.''

== Application Automation and Scripting ==

=== D-Bus ===
; [[/D-Bus/Introduction|Introduction to D-Bus]]
:''A straight-forward introduction to the core concepts in D-Bus from an application developer's perspective, this tutorial covers what D-Bus is and how it can be used by applications.''
; [[/D-Bus/Accessing Interfaces|Accessing D-Bus Interfaces]]
:''A step-by-step guide to calling D-Bus methods and connecting to D-Bus signals using QtDBus.''
; [[/D-Bus/Intermediate_D-Bus|Intermediate D-Bus]]
:''Tips to make use of QtDBus when faced with problematic real-world interfaces.''
; [[/D-Bus/Creating Interfaces|Creating D-Bus Interfaces]]
:''Learn how to expose functionality in your application by creating and using custom D-Bus interfaces. Covers generating the XML descriptions, instantiating interfaces at run time and setting up the build system with CMake.''
; [[/D-Bus/Autostart Services|D-Bus Autostart Services]]
:''Turn your application into a D-Bus autostart service with this tutorial. This D-Bus feature, also known as "D-Bus service activation", will ensure that even when your application isn't running that D-Bus calls made to it will work by relying on the D-Bus daemon itself to start your app if and when needed.''
; [[/Porting_to_D-Bus|Porting from DCOP to D-Bus]]
: ''Port your applications from DCOP to D-Bus with this handy guide.''

=== Konqueror ===
; [[/Creating Konqueror Service Menus|Creating Konqueror Service Menus]]
:''This tutorial shows you how to create mimetype-specific actions in Konqueror's context menu (aka "servicemenus").''

=== Kross ===
; [[Development/Tutorials/Kross/Introduction|Introduction to Kross]]
:''An introduction to the Kross Scripting Framework.''

; [[Development/Tutorials/Kross/Scripts-as-Plugins|Scripts as Plugins with Kross]]
:''This tutorial provides a step-by-step introduction how to integrate scripts as plugins into a KDE application.''

; [[Development/Tutorials/Kross-Tutorial|Kross Tutorial]]
:''This tutorial explains how to integrate the Kross scripting framework into an application. '''TODO''' ''

=== KOffice ===
; [[Development/Tutorials/KOffice Overview]]
:''This document shows an overview of the different KOffice plugin types and tells you what each of their purpose and strengths are.'' If you are new with KOffice plugins, this is the place to start.

; [[Development/Tutorials/Write a Flake Plugin|Creating KOffice Flake Plugins]]
:''This tutorial shows you how you can build a plugin for KOffice applications to allow you embed content in ODF documents using Flake.''

; [[Development/Tutorials/KWord Scripting|KWord Scripting]]
:''This tutorial shows how to script KWord with Python, Ruby or JavaScript using Kross.''

; [[Development/Tutorials/KSpread Scripting|KSpread Scripting]]
:''This tutorial shows how to script KSpread with Python, Ruby or JavaScript using Kross.''

; [[Development/Tutorials/Krita Scripting|Krita Scripting]]
:''This tutorial shows how to script Krita with Python, Ruby or JavaScript using Kross.''

=== SuperKaramba ===
; [[Development/Tutorials/SuperKaramba|SuperKaramba Tutorial]]
:''This tutorial provides an overview of SuperKaramba, theme files and scripting with Python, Ruby and JavaScript.''

== Search and Metadata ==

=== Strigi ===

; [[/Writing file analyzers|Writing file analyzers]]
:''File analyzers extract data from files to display in the file dialogs and file managers. The data gathered this way is also used to search for files. KDE4 allows the use of multiple analyzers per file type. This tutorial describes how you can write new analyzers.''

=== Nepomuk ===

; [[/Metadata/KMetaData first steps|Nepomuk first steps]]
:''Nepomuk is the KDE library which provides easy access to metadata in the [http://nepomuk-kde.semanticdesktop.org Nepomuk-KDE] system. Learn how to make your application create and read metadata using the Nepomuk system.''

== Hardware Awareness (Solid) ==

;[[/Solid_Tutorials|Introduction to Solid]]
:''An introduction to using the Solid hardware discovery and interaction system in KDE applications.''

;[[/Solid_Network_Tutorial|Accessing Network Information]]
:''How to use the Solid system to get information about the network''

== Multimedia (Phonon) ==

;[[/Phonon/Introduction|Phonon]]
:''How to start with the multimedia API''

==Printing==

;[[/Printing Hello World|Hello World]]
:''Introduction to the KDE printing system''

;TODO Print Dialog
:''Using the KDE print dialog''

== Get Hot New Stuff ==
; [[Development/Tutorials/Introduction to Get Hot New Stuff|Introduction to Get Hot New Stuff]]
:''An introduction to the developer-friendly network update system that allows KDE applications to fetch new application data at runtime in a user friendly manner.''

;[[Development/Tutorials/KNewStuffSecure|KNewStuff Secure]] ([http://developer.kde.org/documentation/tutorials/knewstuffsecure/index.html Original Link])
:''Tutorial showing how to share resources in a secured way (KDE 3.4 and later).'' By András Mantia <amantia@kde.org>.

== Rapid Application Development ==

=== Python ===

;[[Development/Tutorials/Python introduction to signals and slots|101 Introduction to signals and slots]]
:''A simple introduction to Qt's signal and slot architecture.''

=== Ruby ===

;[http://developer.kde.org/language-bindings/ruby/kde3tutorial/index.html KDE Ruby Korundum tutorial]
:''A ruby version of Antonio Larrosa Jiménez's KDE tutorial by Richard Dale. See the [http://developer.kde.org/language-bindings/ruby/index.html Ruby Developers Corner] for Qt tutorials and other info.''

;[[Development/Tutorials/Qt4_Ruby_Tutorial|Qt4 Ruby Tutorial]]
:''Trolltech's fabulous introductory tutorial to Qt, translated to Ruby.''

=== Shell ===

;[[Development/Tutorials/Shell_Scripting_with_KDE_Dialogs|Shell Scripting with KDE dialogs]] ([http://developer.kde.org/documentation/tutorials/kdialog/t1.html Original Link]) [[Development/Tutorials/Shell_Scripting_with_KDE_Dialogs_(de)| (German version)]]
:''Tutorial by [mailto:bradh@frogmouth.net Brad Hards] that describes how to use KDE dialogs in shell scripts with kdialog. It is presented as an example based tutorial.''

== Other tutorials ==

=== Using the KDE Games Library ===
;[[/Games/KStandardGameAction| KStandardGameAction]]
:''Using libkdegames to make your game fit the kdegames standard''
;[[/Games/Highscores| Highscores]]
:''Implementing a simple highscore table into your game''
;[[/Games/Theme Selector| Theme Selector]]
:''Using the libkdegames theme selection dialog''

=== 2D Plotting (KPlotWidget) ===
;[[/KPlotWidget|Using the KDE data-plotting widget]]
:''This tutorial introduces KPlotWidget, which is used for 2-D data plotting. It includes information on simple usage of the widget (including adding and modifying data sets, and customizing the plot axes and labels), and advanced customization (including extending the widget through sub-classing).''

=== Spelling and Grammar Checking (Sonnet) ===
;[[/Sonnet/SonnetTutorial|Adding spell-checking or grammar-checking to KDE applications]]
:''This tutorial introduces Sonnet and how one may use it to add language correction to your KDE application. Sonnet's auxiliary features shall be described in a separate tutorial.''

== KDE2 and KDE3 Materials ==

;[[Development/Tutorials/KDE3|KDE3 Tutorials]]
:''These tutorials cover topics related to KDE3.''

;[[Development/Tutorials/KDE2|KDE2 Tutorials]]
:''These tutorials cover topics related to KDE2.''

[[Category:KDE4]]

Contribute (fr)

2007-06-23T12:36:58Z

Fatalerrors: /* KDE */

{{Template:I18n/Language Navigation Bar|Contribute}}
Cette page a pour but de donner un aperçu des différents aspects du développement de KDE en particulier concernant sa programmation. '''Le projet KDE accueille avec plaisir tout ceux qui sont prêts à le faire avancer'''.

{{note|Il existe de nombreuses de façons de faire évoluer le développement de KDE. Elles peuvent être divisées en plusieurs catégories :
:''Documentation, traduction, développement, utilisation, accessibilité, travaux artistique, promotion.
'''Concernant les taches autres que le développement (écriture de code) les pages de KDE expliquant [http://kde.org/getinvolved/ comment participer] donnent un bon aperçu.'''
}}

== Ressources News et Mails ==
La direction générale du projet KDE est déterminée par ceux qui font le travail - il n'y a pas de planification globale de ce que KDE deviendra dans le futur.

Si vous voulez savoir ce qu'il se passe en ce moment, il y a un certain nombre de ressources que vous pouvez utiliser :
; [http://www.kde.org/mailinglists/ Mailing Lists]
: Surement la meilleure façon de se tenir au courant de ce qui se passe dans la développement de KDE. Des archive sont disponibles [http://lists.kde.org ici]

; [http://commitfilter.kde.org/ CommitFilter]
: Recevez des notifications des commits [http://en.wikipedia.org/wiki/Subversion] dans les sujets qui vous intéressent.

; [http://commit-digest.org/ KDE Commit-Digest]
: Résumé hebdomadaire de commits SVN.

; [http://dot.kde.org/ The Dot]
: Le site des news de KDE.

== Débuter en écrivant du code ==
Débuter en ''codant'' dans KDE est une façon de chercher quelque chose à corriger, et à le corriger. Vous devriez consulter la description générale du module pour essayer de trouver ce que vous cherchez; une fois la correction faite, vous voudrez l'envoyer sous forme d'un patch. Si vous faites cette opération régulièrement, you pourrez avoir accès à un compte SVN avec lequel vous pourrez faire vos corrections dirrectement.
* [[Contribute/List of KDE Modules|Description générale du module]]
* [[Contribute/Send Patches|Envoyer des patches]]
* [[Contribute/Get a SVN Account|Accèder à un compte SVN de KDE]]
* [[Contribute/First Steps with your KDE SVN Account|Premiers pas avec votre nouveau compte SVN]]

Pour le moment, il y a deux possibilités de développement au sein de KDE - vous pouvez travailler sur KDE3, ou KDE4. KDE3 est un bon choix pour la correction de bug, cependant le travail de développement principal (et toutes les nouvelles fonctionalités) sont sur KDE4. Se document s'orriente principalement sur le travail de support pour KDE4.

=== C++ ===
KDE est en grande partie écrit en C++. Si vous n'êtes pas un famillié du C++, vous devriez au moins faire quelques travaux avec. Il y a un grand nombre de bon livre sur C++ (quelques un en français, les meilleurs et ceux suscité sont cependant en anglais) - une source excellente est [http://mindview.net/Books/TICPP/ThinkingInCPP2e.html "Thinking in C++" de Bruce Eckel (en français "Penser en C++")], qui est disponnible à la fois en téléchargement gratuit et en document imprimé. Il n'est pas essenciel de tout comprendre avant de commencer avec KDE, mais vous devrez comprendre la syntaxe et les oppérations de base.

=== Qt ===
Pour devenir compétent avec la programmation de KDE, vous devrez comprendre le toolkit Qt. Si vous ne connaissez pas bien Qt, il vous faudras travailler à l'aide des tutoriaux inclus avec Qt ([http://doc.trolltech.com/latest/examples.html pour la version Qt4], [http://doc.trolltech.com/3.3/tutorial.html pour la version Qt3]).

Si vous préférez une introduction multimédia et vidéos vous serez heureux de passer deux folles minutes en regardant [http://www.trolltech.com/trolltech/products/qt/learnmore/video/demos/browser Créer un navigateur de documentation d'aide simple avec Qt4 Designer]. Si cela a retenu votre attention vous devriez aussi regarder la vidéo d'introduction [http://www.trolltechvideo.com/video/day1/room_a/a_1_1/video.html Bonjours Qt] de Mark Summerfield qui fait partie des [http://www.trolltech.com/company/newsroom/events/allevents/devdays2006/videolinks présentations du Trolltech Developer Days 2006]. Il faut noter que toutes ces vidéos sont en anglais.

Si vous avez besoin d'une introduction à Qt plus en douceur, ou si vous souhaiter avoir un point de vue alternatif, alors vous aimeriez jetter un oeuil au [http://qt4.digitalfanatics.org/tiqt/ Tutoriel Indépendent pour Qt (anglais)] (Actuellement hors ligne à cause de contrats littéraires).

D'autre suggestions sur la manière de devenir familier avec Qt4 are [http://doc.trolltech.com/latest/how-to-learn-qt.html également disponible ici]. Une copie de cette documentation est, par ailleurs, distribué avec Qt4.

Pour les documentations en français concernant Qt, le site de la [http://qtfr.org Communauté francophone Qt] est la meilleurs source d'information et de documentation en français.

=== KDE ===
Une gamme d'informations sur les technologie de KDE est disponible dans la [[Contribute/Development/Tutorials_(fr)|catégorie des tutoriaux]] en Français. Notez que certains de ces tutoriaux sont toujours orienté pour KDE3, cependant ils devrais être au moins partiellement applicable.

Vous trouverez aussi des informations utiles sur la programmation de KDE dans la section des [[Contribute/Development/FAQs|FAQs]]. Les informations que vous y trouverez pourrais également être quelque peu ancienne par rapport à KDE4, cependant la plus grande partie est largement applicable, même en dehors de KDE.

Vous pouvez aussi lire [[Contribute/Development/Further Information_(fr)|livres de programmation KDE]] en français.

Enfin, KDE est lié à des classes étendues (API - Application Programmer Interface - Interface de programmation d'application) qui sont documenté. Cette documentation est dans le
[[Contribute/Development/Tutorials/API Documentation_(fr)|Manuel de référence de l'API de KDE]] partiellement en français, qui contiens aussi nombres de liens utiles sur la manière d'écrire ou mettre à jours la documentation des classes. Vous pouvez aussi la générez sur votre machine, ou vous référer à une version en ligne plus à jours sur [http://www.englishbreakfastnetwork.org/apidocs/apidox-kde-4.0/kdelibs-apidocs/ The English Breakfast Network] en anglais.

Une description plus détaillé des étapes ci-dessus est disponible dans notre [http://quality.kde.org/develop/howto/howtohack.php guide du programmeur] en anglais.

== Participer à la chasse aux bugs et à l'amélioration des applications ==

There are a large number of applications within KDE, and not all of them have a maintainer dedicated to managing bugs and generally helping out with all the issues associated with turning some working code into a polished application.

If you are interested in helping out with KDE, but don't know where to start, becoming a member of the KDE Quality Team might appeal to you - see the [http://quality.kde.org Quality Team website] for more information. Note that you do not need any programming skills to become involved.

Of course, you can become involved in bug hunting without being part of the KDE Quality Team - just create yourself an account on the KDE [http://bugs.kde.org bug tracking system], and start searching / sorting through the bugs. Again, you don't have to have programming skills - it helps the programmers enormously just to have a procedure that allows a bug to be consistently reproduced.

The [[/Bugsquad|Bugsquad]] tries to keep track of bugs in KDE software and make sure that valid bugs are noticed by developers. You do not need any programming knowledge to be in the Bugsquad; in fact it is a great way to return something to the KDE community if you cannot program.

== Archives ==

; [http://www.kerneltraffic.org/kde/ Kernel Cousin KDE]
: Summary of the development mailing lists. The Kernel Cousin KDE ran for 76 issues, from 10 March 2001 until 16 April 2004. The KDE Commit-Digest (described above) is its logical successor.

Contribute (fr)

2007-06-23T12:03:04Z

Fatalerrors: /* Qt */

{{Template:I18n/Language Navigation Bar|Contribute}}
Cette page a pour but de donner un aperçu des différents aspects du développement de KDE en particulier concernant sa programmation. '''Le projet KDE accueille avec plaisir tout ceux qui sont prêts à le faire avancer'''.

{{note|Il existe de nombreuses de façons de faire évoluer le développement de KDE. Elles peuvent être divisées en plusieurs catégories :
:''Documentation, traduction, développement, utilisation, accessibilité, travaux artistique, promotion.
'''Concernant les taches autres que le développement (écriture de code) les pages de KDE expliquant [http://kde.org/getinvolved/ comment participer] donnent un bon aperçu.'''
}}

== Ressources News et Mails ==
La direction générale du projet KDE est déterminée par ceux qui font le travail - il n'y a pas de planification globale de ce que KDE deviendra dans le futur.

Si vous voulez savoir ce qu'il se passe en ce moment, il y a un certain nombre de ressources que vous pouvez utiliser :
; [http://www.kde.org/mailinglists/ Mailing Lists]
: Surement la meilleure façon de se tenir au courant de ce qui se passe dans la développement de KDE. Des archive sont disponibles [http://lists.kde.org ici]

; [http://commitfilter.kde.org/ CommitFilter]
: Recevez des notifications des commits [http://en.wikipedia.org/wiki/Subversion] dans les sujets qui vous intéressent.

; [http://commit-digest.org/ KDE Commit-Digest]
: Résumé hebdomadaire de commits SVN.

; [http://dot.kde.org/ The Dot]
: Le site des news de KDE.

== Débuter en écrivant du code ==
Débuter en ''codant'' dans KDE est une façon de chercher quelque chose à corriger, et à le corriger. Vous devriez consulter la description générale du module pour essayer de trouver ce que vous cherchez; une fois la correction faite, vous voudrez l'envoyer sous forme d'un patch. Si vous faites cette opération régulièrement, you pourrez avoir accès à un compte SVN avec lequel vous pourrez faire vos corrections dirrectement.
* [[Contribute/List of KDE Modules|Description générale du module]]
* [[Contribute/Send Patches|Envoyer des patches]]
* [[Contribute/Get a SVN Account|Accèder à un compte SVN de KDE]]
* [[Contribute/First Steps with your KDE SVN Account|Premiers pas avec votre nouveau compte SVN]]

Pour le moment, il y a deux possibilités de développement au sein de KDE - vous pouvez travailler sur KDE3, ou KDE4. KDE3 est un bon choix pour la correction de bug, cependant le travail de développement principal (et toutes les nouvelles fonctionalités) sont sur KDE4. Se document s'orriente principalement sur le travail de support pour KDE4.

=== C++ ===
KDE est en grande partie écrit en C++. Si vous n'êtes pas un famillié du C++, vous devriez au moins faire quelques travaux avec. Il y a un grand nombre de bon livre sur C++ (quelques un en français, les meilleurs et ceux suscité sont cependant en anglais) - une source excellente est [http://mindview.net/Books/TICPP/ThinkingInCPP2e.html "Thinking in C++" de Bruce Eckel (en français "Penser en C++")], qui est disponnible à la fois en téléchargement gratuit et en document imprimé. Il n'est pas essenciel de tout comprendre avant de commencer avec KDE, mais vous devrez comprendre la syntaxe et les oppérations de base.

=== Qt ===
Pour devenir compétent avec la programmation de KDE, vous devrez comprendre le toolkit Qt. Si vous ne connaissez pas bien Qt, il vous faudras travailler à l'aide des tutoriaux inclus avec Qt ([http://doc.trolltech.com/latest/examples.html pour la version Qt4], [http://doc.trolltech.com/3.3/tutorial.html pour la version Qt3]).

Si vous préférez une introduction multimédia et vidéos vous serez heureux de passer deux folles minutes en regardant [http://www.trolltech.com/trolltech/products/qt/learnmore/video/demos/browser Créer un navigateur de documentation d'aide simple avec Qt4 Designer]. Si cela a retenu votre attention vous devriez aussi regarder la vidéo d'introduction [http://www.trolltechvideo.com/video/day1/room_a/a_1_1/video.html Bonjours Qt] de Mark Summerfield qui fait partie des [http://www.trolltech.com/company/newsroom/events/allevents/devdays2006/videolinks présentations du Trolltech Developer Days 2006]. Il faut noter que toutes ces vidéos sont en anglais.

Si vous avez besoin d'une introduction à Qt plus en douceur, ou si vous souhaiter avoir un point de vue alternatif, alors vous aimeriez jetter un oeuil au [http://qt4.digitalfanatics.org/tiqt/ Tutoriel Indépendent pour Qt (anglais)] (Actuellement hors ligne à cause de contrats littéraires).

D'autre suggestions sur la manière de devenir familier avec Qt4 are [http://doc.trolltech.com/latest/how-to-learn-qt.html également disponible ici]. Une copie de cette documentation est, par ailleurs, distribué avec Qt4.

Pour les documentations en français concernant Qt, le site de la [http://qtfr.org Communauté francophone Qt] est la meilleurs source d'information et de documentation en français.

=== KDE ===
A range of information on KDE techniques is available in the [[Development/Tutorials|tutorial section]]. Note that some of these tutorials still target KDE3, though they should be at least partly applicable.

You will also find useful information on KDE coding in the [[Development/FAQs|FAQs]] section. This information may also be somewhat dated for KDE4, however much of it is broadly applicable, even outside KDE.

You can also read [[Development/Further Information|KDE coding books]].

Last, but by no means least, KDE comes with extensive class (Application Programmer Interface) documentation. This is available in the
[[Development/Tutorials/API Documentation|KDE API Reference Manuals]] section, which also contains a number of useful links on how to write or update the class documentation. You can also generate these on your own machine, or refer to a more up-to-date online version at [http://www.englishbreakfastnetwork.org/apidocs/apidox-kde-4.0/kdelibs-apidocs/ The English Breakfast Network].

A more detailed description of the steps above is available in our [http://quality.kde.org/develop/howto/howtohack.php Programming Guide].

== Participer à la chasse aux bugs et à l'amélioration des applications ==

There are a large number of applications within KDE, and not all of them have a maintainer dedicated to managing bugs and generally helping out with all the issues associated with turning some working code into a polished application.

If you are interested in helping out with KDE, but don't know where to start, becoming a member of the KDE Quality Team might appeal to you - see the [http://quality.kde.org Quality Team website] for more information. Note that you do not need any programming skills to become involved.

Of course, you can become involved in bug hunting without being part of the KDE Quality Team - just create yourself an account on the KDE [http://bugs.kde.org bug tracking system], and start searching / sorting through the bugs. Again, you don't have to have programming skills - it helps the programmers enormously just to have a procedure that allows a bug to be consistently reproduced.

The [[/Bugsquad|Bugsquad]] tries to keep track of bugs in KDE software and make sure that valid bugs are noticed by developers. You do not need any programming knowledge to be in the Bugsquad; in fact it is a great way to return something to the KDE community if you cannot program.

== Archives ==

; [http://www.kerneltraffic.org/kde/ Kernel Cousin KDE]
: Summary of the development mailing lists. The Kernel Cousin KDE ran for 76 issues, from 10 March 2001 until 16 April 2004. The KDE Commit-Digest (described above) is its logical successor.

Contribute (fr)

2007-06-20T09:56:28Z

Fatalerrors: /* Débuter en écrivant du code */

{{Template:I18n/Language Navigation Bar|Contribute}}
Cette page a pour but de donner un aperçu des différents aspects du développement de KDE en particulier concernant sa programmation. '''Le projet KDE accueille avec plaisir tout ceux qui sont prêts à le faire avancer'''.

{{note|Il existe de nombreuses de façons de faire évoluer le développement de KDE. Elles peuvent être divisées en plusieurs catégories :
:''Documentation, traduction, développement, utilisation, accessibilité, travaux artistique, promotion.
'''Concernant les taches autres que le développement (écriture de code) les pages de KDE expliquant [http://kde.org/getinvolved/ comment participer] donnent un bon aperçu.'''
}}

== Ressources News et Mails ==
La direction générale du projet KDE est déterminée par ceux qui font le travail - il n'y a pas de planification globale de ce que KDE deviendra dans le futur.

Si vous voulez savoir ce qu'il se passe en ce moment, il y a un certain nombre de ressources que vous pouvez utiliser :
; [http://www.kde.org/mailinglists/ Mailing Lists]
: Surement la meilleure façon de se tenir au courant de ce qui se passe dans la développement de KDE. Des archive sont disponibles [http://lists.kde.org ici]

; [http://commitfilter.kde.org/ CommitFilter]
: Recevez des notifications des commits [http://en.wikipedia.org/wiki/Subversion] dans les sujets qui vous intéressent.

; [http://commit-digest.org/ KDE Commit-Digest]
: Résumé hebdomadaire de commits SVN.

; [http://dot.kde.org/ The Dot]
: Le site des news de KDE.

== Débuter en écrivant du code ==
Débuter en ''codant'' dans KDE est une façon de chercher quelque chose à corriger, et à le corriger. Vous devriez consulter la description générale du module pour essayer de trouver ce que vous cherchez; une fois la correction faite, vous voudrez l'envoyer sous forme d'un patch. Si vous faites cette opération régulièrement, you pourrez avoir accès à un compte SVN avec lequel vous pourrez faire vos corrections dirrectement.
* [[Contribute/List of KDE Modules|Description générale du module]]
* [[Contribute/Send Patches|Envoyer des patches]]
* [[Contribute/Get a SVN Account|Accèder à un compte SVN de KDE]]
* [[Contribute/First Steps with your KDE SVN Account|Premiers pas avec votre nouveau compte SVN]]

Pour le moment, il y a deux possibilités de développement au sein de KDE - vous pouvez travailler sur KDE3, ou KDE4. KDE3 est un bon choix pour la correction de bug, cependant le travail de développement principal (et toutes les nouvelles fonctionalités) sont sur KDE4. Se document s'orriente principalement sur le travail de support pour KDE4.

=== C++ ===
KDE est en grande partie écrit en C++. Si vous n'êtes pas un famillié du C++, vous devriez au moins faire quelques travaux avec. Il y a un grand nombre de bon livre sur C++ (quelques un en français, les meilleurs et ceux suscité sont cependant en anglais) - une source excellente est [http://mindview.net/Books/TICPP/ThinkingInCPP2e.html "Thinking in C++" de Bruce Eckel (en français "Penser en C++")], qui est disponnible à la fois en téléchargement gratuit et en document imprimé. Il n'est pas essenciel de tout comprendre avant de commencer avec KDE, mais vous devrez comprendre la syntaxe et les oppérations de base.

=== Qt ===
Pour devenir compétent avec la programmation de KDE, vous devrez comprendre le toolkit Qt. Si vous ne connaissez pas bien Qt, il vous faudras travailler à l'aide des tutoriaux inclus avec Qt ([http://doc.trolltech.com/latest/examples.html pour la version Qt4], [http://doc.trolltech.com/3.3/tutorial.html pour la version Qt3]).

If you are more into multimedia and videos for a start you might want to spend two amazing minutes on watching [http://www.trolltech.com/trolltech/products/qt/learnmore/video/demos/browser Building a Simple Help Documentation Browser with Qt4 Designer]. If that got your attention you might also want to watch the video introduction [http://www.trolltechvideo.com/video/day1/room_a/a_1_1/video.html Hello Qt] by Mark Summerfield which is part of the [http://www.trolltech.com/company/newsroom/events/allevents/devdays2006/videolinks Trolltech Developer Days 2006 presentations].

If you need a gentler introduction to Qt, or would just like an alternative view, then you may wish to look at the [http://qt4.digitalfanatics.org/tiqt/ The Independent Qt Tutorial] (Currently offline due to book contract).

More suggestions on becoming familiar with Qt4 are [http://doc.trolltech.com/latest/how-to-learn-qt.html available here as well]. A copy of this documentation is also provided with Qt4.

=== KDE ===
A range of information on KDE techniques is available in the [[Development/Tutorials|tutorial section]]. Note that some of these tutorials still target KDE3, though they should be at least partly applicable.

You will also find useful information on KDE coding in the [[Development/FAQs|FAQs]] section. This information may also be somewhat dated for KDE4, however much of it is broadly applicable, even outside KDE.

You can also read [[Development/Further Information|KDE coding books]].

Last, but by no means least, KDE comes with extensive class (Application Programmer Interface) documentation. This is available in the
[[Development/Tutorials/API Documentation|KDE API Reference Manuals]] section, which also contains a number of useful links on how to write or update the class documentation. You can also generate these on your own machine, or refer to a more up-to-date online version at [http://www.englishbreakfastnetwork.org/apidocs/apidox-kde-4.0/kdelibs-apidocs/ The English Breakfast Network].

A more detailed description of the steps above is available in our [http://quality.kde.org/develop/howto/howtohack.php Programming Guide].

== Participer à la chasse aux bugs et à l'amélioration des applications ==

There are a large number of applications within KDE, and not all of them have a maintainer dedicated to managing bugs and generally helping out with all the issues associated with turning some working code into a polished application.

If you are interested in helping out with KDE, but don't know where to start, becoming a member of the KDE Quality Team might appeal to you - see the [http://quality.kde.org Quality Team website] for more information. Note that you do not need any programming skills to become involved.

Of course, you can become involved in bug hunting without being part of the KDE Quality Team - just create yourself an account on the KDE [http://bugs.kde.org bug tracking system], and start searching / sorting through the bugs. Again, you don't have to have programming skills - it helps the programmers enormously just to have a procedure that allows a bug to be consistently reproduced.

The [[/Bugsquad|Bugsquad]] tries to keep track of bugs in KDE software and make sure that valid bugs are noticed by developers. You do not need any programming knowledge to be in the Bugsquad; in fact it is a great way to return something to the KDE community if you cannot program.

== Archives ==

; [http://www.kerneltraffic.org/kde/ Kernel Cousin KDE]
: Summary of the development mailing lists. The Kernel Cousin KDE ran for 76 issues, from 10 March 2001 until 16 April 2004. The KDE Commit-Digest (described above) is its logical successor.

User talk:Dhaumann

2007-06-20T08:51:54Z

Fatalerrors: /* Title Translation */

== Title Translation ==

Hi guy !!!
I would like to know if menu bar translation is possible... If true, how could I do this?
Thank you...

:You can use the template <nowiki>{{DISPLAYTITLE:foo}}</nowiki>, where 'foo' is the translation. However, the display title reflects the wiki link, that's why a text "link to this page as <nowiki>[[...]]</nowiki>" will appear then. --[[User:Dhaumann|Dhaumann]] 15:40, 18 June 2007 (CEST)

::Actually not, I have hidden that text with display:none for on-screen printing. One bug though: When using DISPLAYTITLE, the <title> tag is not filled for some reason... --[[User:Danimo|Danimo]] 16:33, 18 June 2007 (CEST)

:::Damn... If you need help with this, you can ask me as you want for help... ;) --[[User:Fatalerrors|Fatalerrors]] 10:52, 20 June 2007 (CEST)

----

Hi, Dhaumann, can you read and write Chinese? Cool!
--[[User:Liangqi|Liangqi]] 23:00, 19 June 2007 (CEST)
: Unfortunately no. I can't read nor write it. But I still try my best to fix links in a language where I mostly see squares :-) --[[User:Dhaumann|Dhaumann]] 23:22, 18 June 2007 (CEST)

Contribute (fr)

2007-06-18T12:40:57Z

Fatalerrors:

{{Template:I18n/Language Navigation Bar|Contribute}}
Cette page a pour intention de donner un aperçu des différents aspects du développement de KDE en particulier concernant sa programmation. '''Le projet KDE fait sa bienvenue à tout ceux qui sont prêt à le faire avancer'''.

{{note|Il existe énormément de façons de faire évoluer le développement de KDE. Elles peuvent être diviser en plusieurs catégories:
:''Documentation, traduction, développement, utilisation, accessibilité, travaux artistique, promotion
'''Concernant les taches autre que le développement (écrire du code) les pages de KDE expliquant [http://kde.org/getinvolved/ comment participer] donne un bon aperçu.'''
}}

== Origine News et Courriers ==
The general direction of the KDE project is determined by those who do the work - there is no single high level plan for what KDE will look like in the future.

If you want to find out what is currently happening, then there are a number of sources you might like to consider:
; [http://www.kde.org/mailinglists/ Mailing Lists]
: Probably the best way to find out what's going on in KDE development. Archives are available [http://lists.kde.org here]

; [http://commitfilter.kde.org/ CommitFilter]
: Receive notification of [http://en.wikipedia.org/wiki/Subversion SVN] commits in areas that interest you.

; [http://commit-digest.org/ KDE Commit-Digest]
: Weekly summary of SVN commits.

; [http://dot.kde.org/ The Dot]
: The KDE news site.

== Débuter avec l'écriture de code ==
Getting started at ''coding'' in KDE is a matter of finding something to fix, and fixing it. You may want to consult the module overview to help find what you are looking for; once you have fixed something, you will want to send in a patch. If you do that a few times, you may want to apply for an SVN account so you can fix things directly.
* [[/List of KDE Modules|Module overview]]
* [[/Send Patches|Sending patches]]
* [[/Get a SVN Account|Applying for a KDE SVN Account]]
* [[/First Steps with your KDE SVN Account|First steps with your new SVN account]]

At the moment, there are two choices for development within KDE - you can work on KDE3, or KDE4. KDE3 is a good choice for bug fixing, however the main development work effort (and all new features) is on KDE4. This document mainly focuses on work in support of KDE4.

=== C++ ===
KDE is mostly written in C++. If you are not familiar with C++, you should do at least some work on it. There are a number of good books on C++ - an excellent source is [http://mindview.net/Books/TICPP/ThinkingInCPP2e.html Bruce Eckel's "Thinking in C++"], which is available both as a free download and as a printed document. It isn't essential to understand everything before you start in KDE, but you do need to understand basic syntax and operations.

=== Qt ===
To become proficient with KDE coding, you should understand the Qt toolkit. If you are not familiar with Qt, you should work through the tutorials included with Qt ([http://doc.trolltech.com/latest/examples.html Qt4 version], [http://doc.trolltech.com/3.3/tutorial.html Qt3 version]).

If you are more into multimedia and videos for a start you might want to spend two amazing minutes on watching [http://www.trolltech.com/trolltech/products/qt/learnmore/video/demos/browser Building a Simple Help Documentation Browser with Qt4 Designer]. If that got your attention you might also want to watch the video introduction [http://www.trolltechvideo.com/video/day1/room_a/a_1_1/video.html Hello Qt] by Mark Summerfield which is part of the [http://www.trolltech.com/company/newsroom/events/allevents/devdays2006/videolinks Trolltech Developer Days 2006 presentations].

If you need a gentler introduction to Qt, or would just like an alternative view, then you may wish to look at the [http://qt4.digitalfanatics.org/tiqt/ The Independent Qt Tutorial] (Currently offline due to book contract).

More suggestions on becoming familiar with Qt4 are [http://doc.trolltech.com/latest/how-to-learn-qt.html available here as well]. A copy of this documentation is also provided with Qt4.

=== KDE ===
A range of information on KDE techniques is available in the [[Development/Tutorials|tutorial section]]. Note that some of these tutorials still target KDE3, though they should be at least partly applicable.

You will also find useful information on KDE coding in the [[Development/FAQs|FAQs]] section. This information may also be somewhat dated for KDE4, however much of it is broadly applicable, even outside KDE.

You can also read [[Development/Further Information|KDE coding books]].

Last, but by no means least, KDE comes with extensive class (Application Programmer Interface) documentation. This is available in the
[[Development/Tutorials/API Documentation|KDE API Reference Manuals]] section, which also contains a number of useful links on how to write or update the class documentation. You can also generate these on your own machine, or refer to a more up-to-date online version at [http://www.englishbreakfastnetwork.org/apidocs/apidox-kde-4.0/kdelibs-apidocs/ The English Breakfast Network].

A more detailed description of the steps above is available in our [http://quality.kde.org/develop/howto/howtohack.php Programming Guide].

== Participer à la chasse aux Bugs et à la qualité des applications ==

There are a large number of applications within KDE, and not all of them have a maintainer dedicated to managing bugs and generally helping out with all the issues associated with turning some working code into a polished application.

If you are interested in helping out with KDE, but don't know where to start, becoming a member of the KDE Quality Team might appeal to you - see the [http://quality.kde.org Quality Team website] for more information. Note that you do not need any programming skills to become involved.

Of course, you can become involved in bug hunting without being part of the KDE Quality Team - just create yourself an account on the KDE [http://bugs.kde.org bug tracking system], and start searching / sorting through the bugs. Again, you don't have to have programming skills - it helps the programmers enormously just to have a procedure that allows a bug to be consistently reproduced.

The [[/Bugsquad|Bugsquad]] tries to keep track of bugs in KDE software and make sure that valid bugs are noticed by developers. You do not need any programming knowledge to be in the Bugsquad; in fact it is a great way to return something to the KDE community if you cannot program.

== Sources Historique (archives) ==

; [http://www.kerneltraffic.org/kde/ Kernel Cousin KDE]
: Summary of the development mailing lists. The Kernel Cousin KDE ran for 76 issues, from 10 March 2001 until 16 April 2004. The KDE Commit-Digest (described above) is its logical successor.

Contribute (fr)

2007-06-18T12:28:34Z

Fatalerrors: création page

{{Template:I18n/Language Navigation Bar|Contribute}}
This page intends to give an overview of the different aspects of KDE development in particular for programming related issues. '''The KDE project welcomes anyone willing to help'''.

{{note|There are a lot of ways to get involved in KDE development, which can be summed up in several categories:
:''Documentation, Translation, Development, Usability, Accessibility, Artwork, Promotion
'''Especially for tasks other than development (writing code) KDE's pages about [http://kde.org/getinvolved/ how to get involved] give a good overview.'''
}}

== News and Mail Sources ==
The general direction of the KDE project is determined by those who do the work - there is no single high level plan for what KDE will look like in the future.

If you want to find out what is currently happening, then there are a number of sources you might like to consider:
; [http://www.kde.org/mailinglists/ Mailing Lists]
: Probably the best way to find out what's going on in KDE development. Archives are available [http://lists.kde.org here]

; [http://commitfilter.kde.org/ CommitFilter]
: Receive notification of [http://en.wikipedia.org/wiki/Subversion SVN] commits in areas that interest you.

; [http://commit-digest.org/ KDE Commit-Digest]
: Weekly summary of SVN commits.

; [http://dot.kde.org/ The Dot]
: The KDE news site.

== Getting Started with Coding ==
Getting started at ''coding'' in KDE is a matter of finding something to fix, and fixing it. You may want to consult the module overview to help find what you are looking for; once you have fixed something, you will want to send in a patch. If you do that a few times, you may want to apply for an SVN account so you can fix things directly.
* [[/List of KDE Modules|Module overview]]
* [[/Send Patches|Sending patches]]
* [[/Get a SVN Account|Applying for a KDE SVN Account]]
* [[/First Steps with your KDE SVN Account|First steps with your new SVN account]]

At the moment, there are two choices for development within KDE - you can work on KDE3, or KDE4. KDE3 is a good choice for bug fixing, however the main development work effort (and all new features) is on KDE4. This document mainly focuses on work in support of KDE4.

=== C++ ===
KDE is mostly written in C++. If you are not familiar with C++, you should do at least some work on it. There are a number of good books on C++ - an excellent source is [http://mindview.net/Books/TICPP/ThinkingInCPP2e.html Bruce Eckel's "Thinking in C++"], which is available both as a free download and as a printed document. It isn't essential to understand everything before you start in KDE, but you do need to understand basic syntax and operations.

=== Qt ===
To become proficient with KDE coding, you should understand the Qt toolkit. If you are not familiar with Qt, you should work through the tutorials included with Qt ([http://doc.trolltech.com/latest/examples.html Qt4 version], [http://doc.trolltech.com/3.3/tutorial.html Qt3 version]).

If you are more into multimedia and videos for a start you might want to spend two amazing minutes on watching [http://www.trolltech.com/trolltech/products/qt/learnmore/video/demos/browser Building a Simple Help Documentation Browser with Qt4 Designer]. If that got your attention you might also want to watch the video introduction [http://www.trolltechvideo.com/video/day1/room_a/a_1_1/video.html Hello Qt] by Mark Summerfield which is part of the [http://www.trolltech.com/company/newsroom/events/allevents/devdays2006/videolinks Trolltech Developer Days 2006 presentations].

If you need a gentler introduction to Qt, or would just like an alternative view, then you may wish to look at the [http://qt4.digitalfanatics.org/tiqt/ The Independent Qt Tutorial] (Currently offline due to book contract).

More suggestions on becoming familiar with Qt4 are [http://doc.trolltech.com/latest/how-to-learn-qt.html available here as well]. A copy of this documentation is also provided with Qt4.

=== KDE ===
A range of information on KDE techniques is available in the [[Development/Tutorials|tutorial section]]. Note that some of these tutorials still target KDE3, though they should be at least partly applicable.

You will also find useful information on KDE coding in the [[Development/FAQs|FAQs]] section. This information may also be somewhat dated for KDE4, however much of it is broadly applicable, even outside KDE.

You can also read [[Development/Further Information|KDE coding books]].

Last, but by no means least, KDE comes with extensive class (Application Programmer Interface) documentation. This is available in the
[[Development/Tutorials/API Documentation|KDE API Reference Manuals]] section, which also contains a number of useful links on how to write or update the class documentation. You can also generate these on your own machine, or refer to a more up-to-date online version at [http://www.englishbreakfastnetwork.org/apidocs/apidox-kde-4.0/kdelibs-apidocs/ The English Breakfast Network].

A more detailed description of the steps above is available in our [http://quality.kde.org/develop/howto/howtohack.php Programming Guide].

== Getting Involved in Bug Hunting and Application Quality ==

There are a large number of applications within KDE, and not all of them have a maintainer dedicated to managing bugs and generally helping out with all the issues associated with turning some working code into a polished application.

If you are interested in helping out with KDE, but don't know where to start, becoming a member of the KDE Quality Team might appeal to you - see the [http://quality.kde.org Quality Team website] for more information. Note that you do not need any programming skills to become involved.

Of course, you can become involved in bug hunting without being part of the KDE Quality Team - just create yourself an account on the KDE [http://bugs.kde.org bug tracking system], and start searching / sorting through the bugs. Again, you don't have to have programming skills - it helps the programmers enormously just to have a procedure that allows a bug to be consistently reproduced.

The [[/Bugsquad|Bugsquad]] tries to keep track of bugs in KDE software and make sure that valid bugs are noticed by developers. You do not need any programming knowledge to be in the Bugsquad; in fact it is a great way to return something to the KDE community if you cannot program.

== Historical Sources ==

; [http://www.kerneltraffic.org/kde/ Kernel Cousin KDE]
: Summary of the development mailing lists. The Kernel Cousin KDE ran for 76 issues, from 10 March 2001 until 16 April 2004. The KDE Commit-Digest (described above) is its logical successor.

Contribute

2007-06-18T12:26:09Z

Fatalerrors: add lagage bar

KDE System Administration (fr)

2007-06-18T12:20:08Z

Fatalerrors: petite amélioration sur "Liste des clés applicables pour l'utilisation de Kiosk"

{{Template:I18n/Language Navigation Bar|SysAdmin}}
Cette section fournit aux administrateurs système les informations nécessaires au bon déroulement du déploiement de KDE au sein de leur organisation.

== Système de Fichier ==
;[[SysAdmin/Configuration Files|Syntaxe des fichier de configuration]]
:''Les fichiers de configuration de KDE sont au format texte brut. Ils contiennent des groupes de paires clé-valeur. Cette section explique leur syntaxe. Cela couvre :''
* la gestion des langues
* les variables shell
* le vérouillage complet ou partiel des fichiers de configuration
* les utilitaires d'édition
* d'autres fonctionalités avancées

;[[SysAdmin/KDE Filesystem Hierarchy|Arborescence de KDE]]
:''Cet article décrit la façon dont KDE utilise le système de fichier, où il recherche les fichiers et où il les stocke. L'article explique comment changer ces endroits. On trouvera aussi une brève vue d'ensemble des réglages par défaut utilisé par les grands distributeurs de systèmes d'exploitation.''

== Lancement du Bureau ==

;[[SysAdmin/Environment Variables|Environment Variables]]
:''Un ensemble de variables d'environnement décrites dans cet article sont disponibles pour régler certains aspects de KDE et le comportement pendant leur lancement des applications KDE.''

;[[SysAdmin/Startup|Séquence de démarrage du bureau KDE]]
:''Pendant son démarrage KDE lance les composants visibles du bureau ainsi que différents services tournant en tache de fond. Cet article décrit la séquence de démarrage, donne une vue générale des services démarrés et explique comment modifier ceci.''

;[http://docs.kde.org/development/en/kdebase/kdm/ Gestionnaire de Connexion]
:''Le Gestionnaire Graphique de KDE (KDE Display Manager - KDM) fournit les services classiquement associés à un gestionnaire de connexion. Le premier contact que les utilisateurs auront avec KDE est typiquement l'écran de login de KDE. Cette section couvre les bases pour mettre en place KDM, plus certains sujets avancés comme la connexion à distance, la connexion automatique entre autres choses.''

== Profils de groupes et d'utilisateurs ==

;[[SysAdmin/Kiosk/Introduction|Introduction à Kiosk]]
:''L'infrastructure Kiosk fournit un ensemble de fonctionnalités pour définir et restreindre facilement les caractéristiques d'un environnement KDE basé sur les droits d'accès de groupes et d'utilisateurs. En plus d'une introduction générale, cet article couvre l'ensemble des paramètres de configuration vérouillables, les restrictions d'action et de ressource, l'association de profils utilisateurs et de groupes, parmi d'autres choses.''

;[[SysAdmin/Kiosk/Keys|Liste des clés applicables pour l'utilisation de Kiosk]]
:''Ce document détaille l'ensemble clés globales et spécifiques prédéfinies applicables à certaines applications pour les restrictions d'actions, de ressources et de liens internet faisant de ce guide une référence pour paramètrer des profils Kiosk.''

;[[SysAdmin/Kiosk/Resources|Ressources supplémentaires]]
:''Liens vers des outils, listes de diffusion et documentation supplémentaire à propos les profils d'utilisateurs et de groupes dans KDE.''

== Tools ==

;[http://extragear.kde.org/apps/kiosktool/ KioskTool]
:''Une application graphique pour gérer les profils d'utilisateurs et de groupes de KDE Kiosk.''

;[http://docs.kde.org/development/en/kdenetwork/krfb/ Le bureau partagé]

:''La fonctionnalité de bureau partagé permet de partager votre hureau à distance avec d'autres utilisateurs. Parmi de nombreuses autres applications, cette fonctionnalité est une grande avancée pour les équipes de support qui donnent une assistance téléphonique aux utilisateurs.''

;[[Development/Tutorials/Shell_Scripting_with_KDE_Dialogs|Utiliser les boites de dialogue KDE dans des scripts shell]]
:''Il est possible d'utiliser des scripts shell utilisant KDialog pour afficher diverses boites de dialogue KDE. Cela offre une intégration sans précédent de vos propres améliorations de l'interface graphique.''

KDE System Administration (fr)

2007-06-18T10:46:20Z

Fatalerrors: /* User & Group Profiles */

{{Template:I18n/Language Navigation Bar|SysAdmin}}
Cette section fournit aux administrateurs système les informations nécessaires au bon déroulement du déploiement de KDE au sein de leur organisation.

== Système de Fichier ==
;[[SysAdmin/Configuration Files|Syntaxe des fichier de configuration]]
:''Les fichiers de configuration de KDE sont au format texte brut. Ils contiennent des groupes de paires clé-valeur. Cette section explique leur syntaxe. Cela couvre :''
* la gestion des langues
* les variables shell
* le vérouillage complet ou partiel des fichiers de configuration
* les utilitaires d'édition
* d'autres fonctionalités avancées

;[[SysAdmin/KDE Filesystem Hierarchy|Arborescence de KDE]]
:''Cet article décrit la façon dont KDE utilise le système de fichier, où il recherche les fichiers et où il les stocke. L'article explique comment changer ces endroits. On trouvera aussi une brève vue d'ensemble des réglages par défaut utilisé par les grands distributeurs de systèmes d'exploitation.''

== Lancement du Bureau ==

;[[SysAdmin/Environment Variables|Environment Variables]]
:''Un ensemble de variables d'environnement décrites dans cet article sont disponibles pour régler certains aspects de KDE et le comportement pendant leur lancement des applications KDE.''

;[[SysAdmin/Startup|Séquence de démarrage du bureau KDE]]
:''Pendant son démarrage KDE lance les composants visibles du bureau ainsi que différents services tournant en tache de fond. Cet article décrit la séquence de démarrage, donne une vue générale des services démarrés et explique comment modifier ceci.''

;[http://docs.kde.org/development/en/kdebase/kdm/ Gestionnaire de Connexion]
:''Le Gestionnaire Graphique de KDE (KDE Display Manager - KDM) fournit les services classiquement associés à un gestionnaire de connexion. Le premier contact que les utilisateurs auront avec KDE est typiquement l'écran de login de KDE. Cette section couvre les bases pour mettre en place KDM, plus certains sujets avancés comme la connexion à distance, la connexion automatique entre autres choses.''

== Profils de groupes et d'utilisateur ==

;[[SysAdmin/Kiosk/Introduction|Introduction à Kiosk]]
:''L'infrastructure Kiosk fournis une collection de fonctionnalités rendant possible de facilement définir et restreindre les capacités d'un environnement KDE basé sur les droits d'accès de groupes et d'utilisateurs, tout ceci de manière très puissante. En plus d'un apperçu d'introduction, cet article couvre l'ensemble des paramètres de configuration vérouillable, les restrictions d'action et de ressource, l'association de profils utilisateurs et de groupes et encore bien plus.''

;[[SysAdmin/Kiosk/Keys|Clés de Kiosk]]
:''Ce document détails les clés global et d'applications spécifiques et connues pour les restrictions d'actions, de ressources et de liens internet faissant de ce guide une référence pour paramètrer des profils Kiosk.''

;[[SysAdmin/Kiosk/Resources|Ressources supplémentaires]]
:''Liens vers des outils, listes de diffusion et documentation sipplémentaire à propos les profils utilisateurs et de groupes dans KDE.''

== Tools ==

;[http://extragear.kde.org/apps/kiosktool/ KioskTool]
:''A graphical application that helps manage KDE Kiosk user and group profiles.''

;[http://docs.kde.org/development/en/kdenetwork/krfb/ Desktop Sharing]
:''The KDE Desktop Sharing capabilities make it possible to share your desktop remotely with others. Alongside numerous other uses, this feature is a great enabler for support staff who give direct assistance to users calling them.''

;[[Development/Tutorials/Shell_Scripting_with_KDE_Dialogs|Using KDE Dialogs in Shell Scripts]]
:''You can use KDialog shell scripts to show various KDE dialogs. This gives you seamless integration of your own custom GUI enhancements.''

User talk:Dhaumann

2007-06-18T10:19:43Z

Fatalerrors: Menu bar translation

== French for home page ==

Hi guy !

I'm one of the french translator of the wiki and I write to you for asking you to add a langage bar for the Home page of the wiki. This will get possible french (and maybe others) translation of the home page that is important I think. After translation of the home page I could write you again for protect it if needed.

Thank you and see you later...

:done --[[User:Dhaumann|Dhaumann]] 13:23, 14 June 2007 (CEST)

== Menu bar translation ==

Hi guy !!!
I would like to know if menu bar translation is possible... If true, how could I do this?
Thank you...

KDE System Administration (fr)

2007-06-18T10:14:24Z

Fatalerrors: /* Lancement du Bureau */ --> (login = connexion) + traduction des liens

{{Template:I18n/Language Navigation Bar|SysAdmin}}
Cette section fournit aux administrateurs système les informations nécessaires au bon déroulement du déploiement de KDE au sein de leur organisation.

== Système de Fichier ==
;[[SysAdmin/Configuration Files|Syntaxe des fichier de configuration]]
:''Les fichiers de configuration de KDE sont au format texte brut. Ils contiennent des groupes de paires clé-valeur. Cette section explique leur syntaxe. Cela couvre :''
* la gestion des langues
* les variables shell
* le vérouillage complet ou partiel des fichiers de configuration
* les utilitaires d'édition
* d'autres fonctionalités avancées

;[[SysAdmin/KDE Filesystem Hierarchy|Arborescence de KDE]]
:''Cet article décrit la façon dont KDE utilise le système de fichier, où il recherche les fichiers et où il les stocke. L'article explique comment changer ces endroits. On trouvera aussi une brève vue d'ensemble des réglages par défaut utilisé par les grands distributeurs de systèmes d'exploitation.''

== Lancement du Bureau ==

;[[SysAdmin/Environment Variables|Environment Variables]]
:''Un ensemble de variables d'environnement décrites dans cet article sont disponibles pour régler certains aspects de KDE et le comportement pendant leur lancement des applications KDE.''

;[[SysAdmin/Startup|Séquence de démarrage du bureau KDE]]
:''Pendant son démarrage KDE lance les composants visibles du bureau ainsi que différents services tournant en tache de fond. Cet article décrit la séquence de démarrage, donne une vue générale des services démarrés et explique comment modifier ceci.''

;[http://docs.kde.org/development/en/kdebase/kdm/ Gestionnaire de Connexion]
:''Le Gestionnaire Graphique de KDE (KDE Display Manager - KDM) fournit les services classiquement associés à un gestionnaire de connexion. Le premier contact que les utilisateurs auront avec KDE est typiquement l'écran de login de KDE. Cette section couvre les bases pour mettre en place KDM, plus certains sujets avancés comme la connexion à distance, la connexion automatique entre autres choses.''

== User & Group Profiles ==

;[[SysAdmin/Kiosk/Introduction|Introduction to Kiosk]]
:''The Kiosk framework provides a set of features that makes it possible to easily and powerfully define and restrict the capabilities of a KDE environment based on user and group credentials. In addition to an introductory overview, this article covers configuration setting lock down, action and resource restrictions, assigning profiles to users and groups and more.''

;[[SysAdmin/Kiosk/Keys|Kiosk Keys]]
:''This document details known global and application specific kiosk keys for action, resource and url restrictions making it a handy reference guide when setting up a Kiosk profile.''

;[[SysAdmin/Kiosk/Resources|Additional Resources]]
:''Links to tools, mailing lists and additional documentation relevant to user and group profiles in KDE.''

== Tools ==

;[http://extragear.kde.org/apps/kiosktool/ KioskTool]
:''A graphical application that helps manage KDE Kiosk user and group profiles.''

;[http://docs.kde.org/development/en/kdenetwork/krfb/ Desktop Sharing]
:''The KDE Desktop Sharing capabilities make it possible to share your desktop remotely with others. Alongside numerous other uses, this feature is a great enabler for support staff who give direct assistance to users calling them.''

;[[Development/Tutorials/Shell_Scripting_with_KDE_Dialogs|Using KDE Dialogs in Shell Scripts]]
:''You can use KDialog shell scripts to show various KDE dialogs. This gives you seamless integration of your own custom GUI enhancements.''