Tutorial Comment utiliser KDevelop et le SDK de Qtopia pour

Tutorial
Comment utiliser KDevelop et le SDK de Qtopia
pour programmer le PMA400
Version 0.1
Installation
Matériel nécessaire
Qtopia SDK pour PMA400
Téléchargement:
ftp://ftp.trolltech.com/qtopia/sdk/
Prendre pour votre distribution. Le SDK s'installe dans /opt/Qtopia
Il contient les librairies, un cross-compilateur, et des programmes d'émulation pour Qtopia.
Kdevelop
Téléchargement:
http://www.kdevelop.org/
Il est généralement disponible dans toutes les distributions. Il faut au minimum une version
3.xx pour pouvoir générer une application Qtopia.
Variables d'environnement
Pour pouvoir utiliser le SDK, il est nécessaire de définir certains paramètres. Le plus simple
est d'utiliser un script qui définira les variables d'environnement à votre place.
# setup qtopia 1.6 sdk
export QTDIR=/opt/Qtopia
export QTEDIR=$QTDIR
export QPEDIR=$QTDIR
export PATH=$QTDIR/bin:/opt/Embedix/tools/bin/:$QTDIR/tmake/bin:$PATH
export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH
export TMAKEPATH=$QTDIR/tmake/lib/qws/linux-x86-g++/
Pour la suite du tutorial, nous supposerons que nous travaillons dans /home/dart/PMA/. Nous
y placerons le script que l'on appelera setup_qtopia.sh. Nous verrons plus tard comment
l'utiliser.
Préparation
Environnement
Première étape, ouvrir un terminal ( il en existe un grand choix Konsole, Eterm, aterm,
xterm....).
Placer vous dans le répertoire de travail:
/home/dart/PMA/ $ cd /home/dart/PMA/
/home/dart/PMA/ $
Puis, invoquons le script qui définira les variables d'environnements.
/home/dart/PMA/ $ source setup_qtopia.sh
/home/dart/PMA/ $
A cette étape, le terminal en cours et UNIQUEMENT celui-là est configuré pour compiler.
Lancement de l'IDE KDevelop
Il faut lancer le logiciel KDevelop dans le terminal précédent.
/home/dart/PMA/ $ kdevelop
Kdevelop étant très verbeux (il écrit beaucoup en console) il peut etre préférable d'utiliser un
second terminal pour lancer l'IDE, mais il faut impérativement lancer le script comme
précédemment.
Création d'un projet
Nous voilà dans KDevelop, nous allons pouvoir créer notre premier projet.
Ouvrez le menu Projet > Nouveau Projet
Un Wizard se lance:
Nous l'appelerons mon_projet et nous le créeront dans notre répertoire de travail. Nous
cliquerons sur next pour les autres fenetres et enfin sur finish.
Nous arriverons sur le premier fichier de notre projet:
Ouvrons le Qmake manager situé à droite:
Il représente les différents fichiers du projets, les headers, les sources et les interfaces. Ces
dernières est l'aspect visuel de notre application. Nous verrons cela un peu plus tard.
Première compilation
Nous allons maintenant effectuer notre première compilation. Normalement on devrait juste
lancer la compilation dans KDevelop et tout devrait fonctionner. Malheureusement, dans mon
environnement, il y a un problème avec tmake. Essayer chez vous de compiler avec la touche
F8 ou le menu Build > Build Project.
Si vous obtenez une erreur, voici la méthode pour le faire à la main:
1. Entrez dans le répertoire du projet
/home/dart/PMA/ $ cd mon_projet/
2. Puis lancer la commande suivante
tmake -o Makefile mon_projet.pro
3. Cela va créer le Makefile du projet
Désormais, nous pouvons lancer la compilation dans KDevelop. La compilation s'arrete alors
brusquement sur cette erreur:
Ne vous inquiéter pas, il faut simplement rajouter la librairie libqte dans le projet. Nous
pouvons le faire à la main, mais KDevelop peut s'en charger:
Dans le Qmake Manager, cliquez droit sur SubProjects puis Subprojects Settings.
Puis cliquez sur l'onglet Librairies:
Cliquer sur Add et rajouter -lqpe et validez. Faites de meme avec -luuid, -ljpeg, -lqtopia .
Vous pouvez ainsi rajouter des librairies en plus. (-lqpepim pour accéder aux contacts et
adresses par exemple).
ATTENTION: A chaque ajout de librairies, n'oublier pas de relancer la commande
tmake -o Makefile mon_projet.pro
si vous etes atteint du bug précédent.
Une fois ajoutée, relancer la compile, voilà normalement vous venez de compiler votre
première application Qtopia.
Le grand test
Essayons maintenant notre premier programme.
Dans un terminal, après avoir fait un source setup_qtopia.sh, lancer la commande;
/home/dart/PMA/ $ source setup_qtopia.sh
/home/dart/PMA/ $ qvfb
Ceci va lancer le framebuffer de Qtopia, c'est à dire « l'émulateur » Qtopia, meme si ce n'est
pas de l'émulation.
Dans cet émulateur, dans le menu file->configure, vous pouvez définir l'écran du PMA
320x240.
Dans KDevelop, lancer votre programme avec Build -> Execute Main Program. Vous
obtenez alors:
Félicitation, voici votre premier programme!!!!!
Compilation pour le PMA
Dernière étape, il faut compiler pour le PMA. Dans votre terminal habituel, lancer les
commandes:
/home/dart/PMA/mon_projet/ $ export
TMAKEPATH=/opt/Qtopia/tmake/lib/qws/linux-sharp-g++
/home/dart/PMA/mon_projet/ $ export QTDIR=/opt/Qtopia/sharp/
Ceci force l'utilisation des compilateurs ARM, ceux du PMA.
Puis lancer la commande:
/home/dart/PMA/mon_projet/ $ tmake -o Makefile mon_projet.pro
Ceci va regénérer le projet avec les valeurs ARM.
Enfin, regénérez le projet (rebuild) avec KDevelop. Normalement, il va générer l'éxecutable
pour le PMA.
Voilà, c'est fini!
Pour tester, vous recopiez l'executable mon_projet sur le PMA, dans /media par exemple.
Puis à partir du terminal du PMA, lancez /media/mon_projet.
Enjoy!!!
Pour recompiler pour le PC, n'oubliez pas de relancer les commandes:
/home/dart/PMA/mon_projet/ $ export QTDIR=/opt/Qtopia
/home/dart/PMA/mon_projet/ $ export
TMAKEPATH=$QTDIR/tmake/lib/qws/linux-x86-g++/
/home/dart/PMA/mon_projet/ $ tmake -o Makefile mon_projet.pro
Utiliser Qdesigner
Le SDK fournit une version spécifique de QDesigner. Pour l'utiliser, il suffit de doublecliquer sur mon_projetbase.ui situé dans le QMake Manager, rubriques INTERFACES.
QDesigner s'ouvre alors.
A faire
Voici les prochaines étapes de ce tutorial:
•
Déboguage sur PC
•
Déboguage sur PMA
•
Utilisation de QDesigner