BerndPol Anne-MarieMahfouf installation Dans ce chapitre, nous étudierons les étapes nécessaires pour compiler et installer l'EDI &tdevelop; : Le document Comment obtenir &tdevelop; se concentre principalement sur le téléchargement des souces les plus récentes de &tdevelop; depuis SVN. Le document Conditions requises pour &tdevelop; énumère les programmes et bibliothèques qui doivent être installés pour réussir à compiler l'EDI. Le document Compilation et installation de &tdevelop; vous guide tout au long des étapes de compilation et d'installation de l'application. Le document Comment obtenir une documentation de l'&API; &tdevelop; décrit ce qu'est une API et comment vous procurer un outil si utile pour naviguer dans les sources de &tdevelop;. obtenir &tdevelop; &tdevelop; obtenir &tdevelop; est disponible sous forme d'exécutable dans différentes distributions &Linux; telles que SuSE, RedHat et autres. Ces exécutables sont conditionnés dans un format pratique, le plus souvent en RPM, pour une installation aisée. Pour l'installer, suivez les instructions standard fournies dans votre distribution. Vous pouvez également obtenir les sources de &tdevelop;, les compiler et les installer vous-même. Vous les trouverez sur la page d'accueil du projet http://www.kdevelop.org ou sur le site ftp de &kde;. svn Si vous vous souhaitez être à la pointe du développement actuel, des instantanés sont disponibles sur le référentiel SVN anonyme. Le nom du module est tdevelop à l'adresse svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/tdevelop. extraction &tdevelop; svn extraction Pour obtenir une version initiale de &tdevelop;, vous devez la télécharger depuis le SVN anonyme. Pour cette opération que l'on appelle extraction, suivez ces étapes. Nous partons du principe que vous placerez votre copie de &tdevelop; dans le sous-dossier kde3src de votre dossier personnel (~). # Créez le dossier de destination, si nécessaire : ~> mkdir kde3src ~> cd kde3src ~/kde3src> svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/tdevelop ~/kde3src> cd tdevelop Une fois que vous avez réussi à extraire votre version de &tdevelop;, vous pouvez suivre l'évolution des changements grâce à la procédure de mise à jour décrite dans la prochaine section. Maintenez la charge du serveur faible. Ne faites pas d'extraction chaque fois que vous souhaitez conserver votre &tdevelop; à jour ! Utilisez la mise à jour par SVN à cette fin. À présent, compilez votre version de &tdevelop; comme décrit dans la section Compilation et installation de &tdevelop;. mise à jour &tdevelop; svn mise à jour Après avoir extrait (et compilé avec succèe) &tdevelop; à partir de SVN comme décrit ci-dessus, vous devrez la garder à jour afin d'obtenir tous les correctifs. Suivez ces étapes. (Nous supposons à nouveau que vous avez placé votre copie de &tdevelop; dans le dossier kde3src.) Notez la commande up (= update) au lieu du co (qui signiifie checkout). ~> cd kde3src ~/kde3src> cd tdevelop ~/kde3src> svn up Gardez un œil sur les messages que SVN produit pendant la séquence de mise à jour. Les étapes exactes dans la séquence de compilation en dépendent. Maintenant, vous pouvez compiler une nouvelle version de &tdevelop; comme décrit dans le chapitre Considérations de compilation spéciales par SVN. conditions requises &tdevelop; conditions requises GNU conditions requises Afin de réussir à compiler et à utiliser &tdevelop;, vous avez besoin des programmes et bibliothèques suivants. Ils sont disponibles sur la plupart des plates-formes sous forme de paquetages dans votre distribution et peuvent de ce fait être installés aisément. gcc/g++ ≥ 2.95.3 (ou compatible) gcc conditions requises g++ conditions requises Disponible à l'adresse gcc.gnu.org &GNU; make (ou compatible) make conditions requises Disponible à l'adresse www.gnu.org/software/make &perl; 5.004 (ou supérieur) Perl conditions requises Disponible à l'adresse www.perl.com autoconf ≥ 2.52 (ou supérieur) autoconf conditions requises Disponible à l'adresse www.gnu.org/software/autoconf automake ≥ 1.6 (ou supérieur) automake conditions requises Disponible à l'adresse www.gnu.org/software/automake flex 2.5.4 (ou supérieur) flex conditions requises Disponible à l'adresse www.gnu.org/software/flex &Qt; ≥ 3.3.0 (ou supérieur) Qt conditions requises Disponible à l'adresse www.trolltech.com/products/qt KDE ≥ 3.4.0 (ou supérieur) KDE conditions requises Disponible à l'adresse www.kde.org L'outil d'exploration des sources ctags, disponible à l'adresse http://ctags.sourceforge.net, qui vous permet en quelques clics sur un nom présent dans l'éditeur, d'accéder rapidement à des déclarations et à des définitions. ctags dot, un compilateur graphique de langage, disponible à l'adresse http:/www.graphviz.org. Cet outil est nécessaire en association avec &doxygen; ci-dessous si vous souhaitez avoir des relations de classes affichées graphiquement (ce qui est vivement recommandé). dot L'outil de documentation &doxygen;, disponible à l'adresse http://www.doxygen.org pour pouvoir générer la documentation concise et puissante de l'API pour vos projets. doxygen valgrind disponible à l'adresse http://developer.kde.org/~sewardj/ vous aide à repérer des problèmes de gestion de la mémoire dans vos applications. valgrind svn à l'adresse http://subversion.tigris.org/ si vous souhaitez utiliser le système de contrôle de versions SVN. svn conditions requises Tous autres compilateur et/ou outil, au cas où vous souhaitiez développer pour un langage ou une plate-forme autres que C++ / &kde;, voire utiliser certaines fonctions spéciales. Vous pouvez, dans une certaine mesure, vous soustraire à la nécessité de &autoconf; ≥  2.52 et &automake; ≥ 1.6. Supprimez simplement le dossier admin dans votre dossier d'installation &tdevelop; et saisissez autoconf se soustraire à la nécessité d'une version automake se soustraire à la nécessité d'une version nécessité d'une version se soustraire pour autoconf / automake (votre-dossier-tdevelop)> ln -s $TDEDIR/share/apps/tdelibs/admin admin sur la console. Cette action amène &tdevelop; à utiliser les réglages par défaut dans le dossier admin de &kde; à la place. Veillez à ne pas mélanger plusieurs versions de &Qt;. Liez toujours &tdevelop; à la même version de &Qt; avec laquelle votre bibliothèque &kde; a été compilée. Sinon, vous rencontrerez certainement des comportements très étranges. &tdevelop; compilation &tdevelop; installation Une fois que toutes les conditions requises sont satisfaites, vous êtes prêt à compiler et à installer &tdevelop;. Cette annexe sera consacrée aux étapes nécessaires pour y parvenir. Le document Étapes préliminaires décrit la configuration d'un environnement adéquat. Le document Compiler &tdevelop; montre comment obtenir les sources de &tdevelop; depuis SVN, les préparer pour le processus d'installation, en terminant par la description des étapes nécessaires pour compiler et installer &tdevelop;. Le document Quelques notes sur la configuration des options vous explique comment exécuter &tdevelop; s'il a été installé dans un endroit autre que le dossier &kde;. préliminaires Installation de &tdevelop; TDEDIR QTDIR LD_LIBRARY_PATH LIBRARY_PATH PATH Avant de démarrer la séquence de compilation, vérifiez que toutes les bibliothèques et autres outils sont à la disposition du système « make ». Pour ce faire, il faut définir correctement certaines variables d'environnement. Les étapes réelles à exécuter dépendant de la console shell que vous utilisez. Pour éviter de saisir toutes les instructions qui définissent les variables d'environnement chaque fois que vous souhaitez compiler, placez-les dans votre fichier .bashrc ou .cshrc. Ainsi, les variables d'environnement seront correctement définies chaque fois que vous démarrez le shell. Si vous utilisez le shell bash, ajoutez les lignes suivantes : export TDEDIR=(chemin vers votre installation KDE) export QTDIR=(chemin vers votre bibliothèque Qt) export LD_LIBRARY_PATH=$QTDIR/lib:$TDEDIR/lib:$LD_LIBRARY_PATH export LIBRARY_PATH=$QTDIR/lib:$TDEDIR/lib:$LIBRARY_PATH export PATH=$QTDIR/bin:$TDEDIR/bin:$PATH Si vous utilisez le shell tcsh, ajoutez les lignes suivantes : setenv TDEDIR (chemin vers votre installation KDE) setenv QTDIR (chemin vers votre bibliothèque Qt) setenv LD_LIBRARY_PATH=$QTDIR/lib:$TDEDIR/lib:$LD_LIBRARY_PATH setenv LIBRARY_PATH $QTDIR/lib:$TDEDIR/lib:$LIBRARY_PATH setenv PATH $QTDIR/bin:$TDEDIR/bin:$PATH make Installation de &tdevelop; compiler &tdevelop; Dans l'étude suivante, nous supposons que vous avez placé vos sources &tdevelop; dans le dossier ~/kde3src/tdevelop. Au cas où vous utiliseriez un instantané &tdevelop; issu de SVN, les étapes initiales de compilation dépendent si vous avez juste fait une extraction complète ou seulement actualisé le source. Après une extraction de SVN Vous devez initialiser le système « make » après une récente extraction. La même chose est vraie chaque fois que vous devez démarrer ex nihilo. Saisissez : ~/kde3src/tdevelop> make -f admin/Makefile.common svn-clean puis toutes les étapes qui suivent. Vous pourrez être amené à accéder au référentiel SVN pour le nettoyage, si un fichier corrompu ou manquant doit être reconstruit. La commande cvs-clean supprime du dossier tout fichier non présent dans SVN ! Veillez à sauvegarder les informations qui présentent de l'intérêt avant d'émettre cette commande de nettoyage. Après une mise à jour par SVN La prochaine étape dépend de la sortie de la séquence de mise à jour par SVN. Si vous avez obtenu quelque chose comme (il peut s'agir d'un marqueur U ou P dans la colonne la plus à gauche, les deux indiquanr que le fichier a été modifié) : U /un_dossier_path/Makefile.am ou, si vous avez juste fait une extraction complète, saisissez : ~/kde3src/tdevelop> make -f Makefile.svn avant de poursuivre avec toutes les étapes suivantes. Dès lors que le système make de base est installé, vous devez décider quel type de système &tdevelop; vous souhaitez utiliser. Cette tâche s'effectue lors de l'étape configure suivante, qui construit les Makefiles réels que la commande make utilisera. Vous pouvez ignorer l'option --prefix dans les lignes de commande configure suivantes si vous voulez que &tdevelop; soit installé dans le dossier &kde; pa défaut. Reportez-vous au chapitre Quelques notes sur les options de configure pour ce faire. Une version compilée par « debug » Pour garder une trace de ce que fait votre application &tdevelop; au moment de l'exécution, construisez une version compilée par « debug » : il suffit d'utiliser la commande configure : ~/kde3src/tdevelop> ./configure --enable-debug=full --prefix=(où-se_trouve-votre-kde3) Une version compilée par « release » Si vous souhaitez n'utiliser &tdevelop; telle quelle, une version « release »(moins volumineuse mais qui s'exécute plus rapidement) suffit. configure règle celle-ci par défaut. ~/kde3src/tdevelop> ./configure --prefix=(où-se_trouve-votre-kde3) Pour construire votre propre documentation de l'API pour &tdevelop;, vous devez inclure encore une autre option dans la commande configure : ~/kde3src/tdevelop> ./configure --(options-comme-ci-dessus) \ --with-tdelibsdoxy-dir=$TDEDIR/share/doc/HTML/en/tdelibs-apidocs « Make » et « Install »er &tdevelop; configure vérifie le système et construit quelques Makefiles en fonction de ce qu'il a trouvé. La commande make utilise le Makefile principal par défaut. Ainsi ~/kde3src/tdevelop> make suffit. Si nécessaire, acquérez à présent les droits de l'utilisateur « root » à l'aide de la commande ~/kde3src/tdevelop> su et en saisissant le mot de passe « root ». Puis installez l'application : ~/kde3src/tdevelop> make install Vous avez terminé. Si vous avez installé &tdevelop; dans le dossier &kde; par défaut, exécutez maintenant l'EDI. Sinon, quelques étapes supplémentaires seront nécessaires, comme décrit dans la section Dossier d'installation autre que le dossier par défaut ci-dessous. En fait, trois applications basées sur &tdevelop; auront en principe été installées : L'EDI &tdevelop; — c'est l'endroit où vous travaillerez habituellement. Le navigateur autonome de documentation de l'assistant de &tdevelop; — isole l'ensemble des puissantes fonctions de documentation de l'EDI &tdevelop; dans un outil séparé. Celui-ci est pratique lorsque vous voulez chercher de la documentation mais que vous ne souhaitez pas démarrer l'EDI complet. Le Designer &tdevelop; — améliore le concepteur d'interface utilisateur de &Qt; par des éléments propres à &kde; et s'intègre parfaitement dans l'EDI &tdevelop;. &tdevelop; installation dossier autre que le dossier par défaut dossier autre que le dossier par défaut TDEDIRS tdebuildsycoca Par défaut, configure prépare l'EDI à être installé dans le dossier &kde; par défaut. Ceci est nécessaire parce que &tdevelop; suppose un accès direct à certains outils et parties qui y résident. Si vous souhaitez utiliser votre propre dossier d'installation, indiquez celui-ci à configure à l'aide de l'option --prefix : ~/kde3src/tdevelop> ./configure --prefix=(où-se_trouve-votre-kde3) Faites attention si vous procédez ainsi. Vous devez fournir un moyen à &tdevelop; d'accéder aux outils et aux parties requises dans le dossier &kde; lors de l'exécution. (Vous pouvez encore utiliser l'EDI sans faire cela, mais avec des possibilités très restreintes.) Appelez un shell et faites en sorte que les commandes suivantes soient exécutées avant de démarrer &tdevelop; à l'invite du shell. Veillez à utiliser le pluriel : Il s'agit de TDEDIRS, pas simplement de TDEDIR) ~> export TDEDIRS=/usr/local/kde:/opt/kde3 ~> tdebuildsycoca (Démarrez maintenant &tdevelop; :) ~> tdevelop La variable d'environnement TDEDIRS doit être positionnée sur la liste des dossiers &kde; actifs dans votre système. Nous n'utilisons /usr/local/kde:/opt/kde3 qu'à titre d'exemple. Le dossier /usr/local/kde peut, par exemple, contenir une version de &kde; incomplète que vous avez compilée à des fins de débogage ; en outre, le dossier /opt/kde3 est susceptible de contenir la version standard de &kde; issus de la distribution que vous employez pour votre travail au quotidien. Dans un shell tcsh, il faut définir les variables d'environnement en utilisant : ~> setenv TDEDIRS /usr/local/kde:/opt/kde3 La commande tdebuildsycoca (b uild s«ystem control cache ) lcherche les bibliothèques et met en cache leurs emplacement et version, de façon à ce que &tdevelop; puisse les trouver. À noter qu'elle prend un temps non négligeable — et qu'il faut la lancer chaque fois que vous appelez le shell pour démarrer &tdevelop; depuis un dossier autre que le dossier par défaut. Vous pouvez être amené à placer les commandes ci-dessus dans un script shell pour réduire l'effort de saisie. (Vous pourriez également placer ces lignes dans votre fichier .bashrc ou .cshrc, mais ce n'est pas à conseiller car tdebuildsycoca s'exécutera ensuite chaque fois que vous appellerez le shell.) La commande tdebuildsycoca ne s'exécute pas sous compte «root». Appelez-la à partir d'un compte utilisateur non « root ». (Mais ce n'est pas une très bonne idée de toute façon de développer des logiciels en tant que « root » !) API &tdevelop; &tdevelop; API compiler &tdevelop; API configure API &tdevelop; API est l'abrégé de « Application Program Interface ». En réalité, une telle API contient une série de descriptions (&cad; des conventions d'appel) par lesquelles un logiciel d'application peut accéder au système d'exploitation et à d'autres services. Dans notre contexte, toutefois, une définition générique a été adoptée. L'API d'une application &kde; ou &Qt; est un résumé des interfacesde classes et de méthodes, un synopsis à utiliser comme un dictionnaire pour naviguer dans les sources. La version de l'API la plus récente est disponible sur le site web de KDevelop. Comme elle est automatiquement actualisée toutes les 24 heures, vous pouvez continuer. Malheureusement, cette version est surtout utilisée en lecture seule sur l'internet. Si vous n'avez pas d'accès au Net, vous pouvez construire votre propre documentation de l'API à partir des sources de &tdevelop;. Pour ce faire, indiquez au système automake où trouver l'API KDELIBS dans votre système. Utilisez alors l'option spéciale --with-tdelibsdoxy-dir dans la commande configure quand vous vous préparez à compiler les sources de &tdevelop; : ~/kde3src/tdevelop> ./configure --(options-comme-d_habitude) \ --with-tdelibsdoxy-dir=$TDEDIR/share/doc/HTML/en/tdelibs-apidocs (make remplacera la variable globale $TDEDIR par le paramètre du dossier &kde; réel enregistré dedans.) Émettez ensuite une commande make comme d'habitude. Une fois que l'EDI &tdevelop; a été construit, vous avez le choix de construire l'API également. Pour cela, saisissez ~/kde3src/tdevelop> make apidocs Cette commande construit un Doxyfile dans votre dossier &tdevelop; de base, qui sera à son tour traité par l'application Doxygen pour construire une quantité considérable de fichiers d'API .html. Quand ce processus de construction d'API plutôt long (il peut durer plus d'une heure sur un système lent) arrive à sa fin, installez l'API tout comme vous le feriez pour l'EDI &tdevelop; lui-même. Si nécessaire, acquérez les droits de super-utilisateur (« root ») en ~/kde3src/tdevelop> su et en saisissant le mot de passe root. Puis installez les fichiers d'API : ~/kde3src/tdevelop> make install-apidox Ensuite, make vous indique dans queldossier vous pouvez enfin examiner le contenu de la documentation de l'API. Notez cette adresse, vous pouvez vous en servir dans &konqueror; ainsi que dans tdevelop;, au cas où vous auriez installé les sources de &tdevelop; elles-mêmes en tant que projet sur lequel travailler. Vous verrez probablement beaucoup de messages d'avertissement et/ou d'erreurs au cours de la construction de l'API exécutée par Doxygen. Il vaut mieux les ignorer, ils n'ont d'intérêt que pour les développeurs de &tdevelop;. Si la génération de l'API aboutit avec succès, les fichiers d'API .html seront utilisables.