Aller au menu - Aller au contenu

Icône QtWorkbench : compilez vos projets Qt sous Code::Blocks !

Avatar
Par Avatar erqsor
Mise à jour : 11/03/2010
Difficulté : Intermédiaire Intermédiaire
119 visites depuis 7 jours , classé 524/777
Attention, ce tutoriel n'est pas à jour car le plugin ne l'est pas non plus. Si vous souhaitez utiliser Qt avec MinGW, je vous recommande de vous diriger sur l'IDE QtCreator car vous devez utiliser la version 4.4.x de Qt pour ce tutoriel, ainsi qu'une certaine version de Codeblocks pour que tout fonctionne correctement !


Si vous souhaitez utiliser uniquement Code::Blocks pour développer et compiler un programme utilisant la bibliothèque Qt (signaux et slots personnalisés compris), ce tutoriel est fait pour vous ! Celui-ci vous apprendra à installer et configurer le plugin QtWorkbench, et vous expliquera comment configurer un nouveau projet utilisant ce plugin.

Ce tutoriel a été réalisé pour les utilisateur de Windows, cependant Code::Blocks étant une application cross-platform, il n'y a pas de raisons que cela ne soit pas compatible avec les autres plateformes, mais je ne garantis pas que cela fonctionnera, à vous de tester ! ;)
Vous pouvez bien sûr utiliser les commentaires de ce tuto pour indiquer aux zéros si cela a fonctionné ou non.

Avant de débuter ce tutoriel, je tiens à remercier y.pagles pour le développement de ce plugin (Dont la page du projet est disponible ici).
Retour en haut
Sommaire du tutoriel :
Icône du chapitre
Retour en haut

Installation et configuration de l'environnement

Téléchargements



Téléchargeons sans plus attendre les versions des logiciels qu'il nous faut :
1. Qt 4.5.3 (ou le SDK) ou une version antérieure (les versions 4.6.x n'ont pas l'air de fonctionner)
2. MinGW (sauf si vous souhaitez utiliser la version fournie avec le SDK de Qt).
3. la Nighty Build 5382 de Codeblocks.
4. Le plugin QtWorkBench (Téléchargez le fichier se terminant par l'extension 'cbplugin').

J'ai mis certains des fichiers sur mon FTP au cas où des liens seraient morts.


Installations



Commencez par installer Qt, c'est le plus long ;) .

Ensuite installez MinGW (n'oubliez pas de cocher le compilateur g++ et aussi l'option MinGW-Make).

Installez la Nighty build de Code::Blocks.

Si vous ne savez pas installer une Nighty bluid, ne vous inquiétez pas, voici un tutoriel de Nesquik69 & Xaviou qui vous aidera : Installez et maîtrisez à fond Code::Blocks !.


Lancez Code::Blocks, allez dans le menu Plugins -> Manage plugins.
Cliquez sur le bouton Install new et allez chercher le plugin téléchargé précédemment.

Cette manipulation ne nécessite normalement pas le redémarrage de Code::Blocks.


Fermez la fenêtre en appuyant sur Close.

Image utilisateur


Configuration des variables globales



Nous configurons ici le répertoire d'installation de Qt dans Code::Blocks afin que ce dernier sache où Qt a été installé et que l'on n'ait pas à le redéfinir ultérieurement.
Il s'agit tout simplement d'indiquer à Code::Blocks où est installé Qt et où chercher les fichier de configuration de compilation mkspecs.


Allez dans le menu Settings -> Global variables.
Si la variable globale qt4 n'existe pas, créez la.

Le champ base permet d'indiquer le répertoire d'installation de Qt (C:\Qt\4.5.3 si vous avez installé Qt par défaut).

Si vous avez installé la version SDK de Qt, alors le chemin est le suivant : C:\Qt\2009.05\qt


La seconde manipulation consistera à spécifier les champs User-defined fields.

Dans la première colonne indiquez mkspecs.
Dans la seconde colonne, indiquez $(#qt4)/mkspecs.

Fermez la fenêtre en appuyant sur Close.

Image utilisateur


Configuration du plugin



QtWorkbench nécessite aussi que l'on spécifie le répertoire d'installation de Qt, ainsi que le répertoire de configuration du compilateur.
Nous allons utiliser la variable globale créée précédemment dans Code::Blocks.


Rendez vous dans le menu Settings -> Environment.
Sélectionnez Qt Workbench dans la liste déroulante.

Dans la boîte de dialogue Qt Installation Directory, indiquez $(#qt4).
Dans la boîte de dialogue Make Specifications Directory, indiquez $(#qt4.mkspecs).
La dernière option vous permet de sélectionner le compilateur de votre choix. Il est recommandé de laisser default.
Validez en appuyant sur OK.

Image utilisateur
Retour en haut

Création et configuration du projet

Maintenant que votre IDE est correctement configuré, deux solutions s'offrent à vous :

- Vous pouvez télécharger ce projet de base vide (QtProject) et y ajouter les codes source que vous voulez compiler. Dans ce cas, vous pouvez passer les prochaines instructions de configuration du projet et aller à la sous-partie Compilation du projet qui se situe à la fin de ce chapitre.

- Sinon vous pouvez continuer ce tutoriel afin de créer et/ou configurer vous même votre projet.
Sachez que les modules de Qt utilisés pour ce projet sont QtGui et QtCore, si vous souhaitez utiliser d'autres modules, suivez les instructions de ce chapitre et adaptez la configuration en fonction de votre projet (Vous pouvez reprendre mon projet de base si vous le souhaitez).

Le contenu des manipulations suivantes de ce chapitre devront être ré-itérées à chaque nouveau projet.


Création du projet


Afin de pouvoir utiliser le plugin QtWorkbench, nous allons commencer par créer un projet vide.

Allez dans le menu File -> New -> Project.
Sélectionnez Empty Project et cliquez sur Go.

Cliquez sur Next.
Choisissez le nom de votre projet et son répertoire, puis cliquez sur Next.
Vérifiez que le Compiler sélectionné est bien GNU GCC Compiler.
Choisissez les cibles Debug et Release (si vous ne savez pas paramétrer ces options, laissez par défaut, cela convient dans la plupart des cas).
Cliquez enfin sur Finish.


Configuration du projet


Options générales du projet


Ce projet vide doit maintenant être configuré.

Allez dans le menu Project -> Properties.

Indiquons à Code::Blocks que le Makefile sera généré indépendamment de MinGW.

Dans l'onglet Project Settings, cochez la case This is a custom Makefile.

Image utilisateur


Afin de développer plus aisément, nous allons indiquer à Code::Blocks où chercher les fichiers contenant les descriptions des objets de Qt afin qu'il accepte l'auto-compétion (Ceci n'est pas obligatoire mais très recommandé).

Dans l'onglet C/C++ parser options, ajoutez les cibles des différents modules Qt que vous souhaitez utiliser dans votre projet, sans oublier d'utiliser la variable globale de Qt !

Pour une application utilisant QtCore et QtGui, renseignez :
Code : Autre
1
2
3

$(#qt4.include)
$(#qt4.include)/QtCore
$(#qt4.include)/QtGui

La modification de cet onglet nécessite un redémarrage de Code::Blocks.


Image utilisateur


Indiquons à notre projet d'utiliser le groupe de variables d'environnement qui contient celle de Qt (dans le cas où vous en avez plusieurs).

Dans l'onglet EnvVars options, cochez Select environment variables set to be applied et sélectionnez la variable d'environnement dans laquelle est enregistrée la variable globale de Qt. Par défaut, cela devrait être default.

Image utilisateur


Cliquez enfin sur OK pour valider les modifications effectuées.


Options des cibles de construction


Et hop, on retourne dans le Menu Project -> Properties.
Non, non je ne vous fait pas tourner en rond, mais courage, on approche de la fin ! :p

Je vais vous détailler les manipulations pour la cible de construction Release, vous devrez donc refaire les manipulations suivantes pour chaque cible de construction supplémentaire de votre projet !
Il vous faudra bien sûr adapter les options de la cible de construction en fonction de celle-ci.

Si vous souhaitez utiliser Qt pour créer une interface graphique, faites la manipulation suivante :

Dans l'onglet Build targets, sélectionnez la cible de construction Release et changez le Type d'application pour GUI Application.

Image utilisateur


Nous allons maintenant indiquer à Code::Blocks comment créer (build) l'exécutable du projet et comment nettoyer (clean) les répertoires contenant les fichiers temporaires de compilation.

Dans ce même onglet Build targets, vérifiez que la cible de construction Release est toujours sélectionnée et cliquez sur le bouton Build options.
Dans la nouvelle fenêtre qui s'affiche, allez dans l'onglet "Make" Commands.
Changez les valeurs des champs par les suivantes :
- Build project/target : $make -f $makefile.$target
- Compile single file : $make -f $makefile $file
- Clean project/target : $make -f $makefile.$target clean
- Dist-clean project/target : $make -f $makefile.$target distclean

Cliquez sur OK pour valider les paramètres.

Image utilisateur


Nous allons enfin configurer QtWorkbench pour chaque cible de construction. Adaptez les options en fonction des besoins de votre projet. Pour une application classique utilisant une interface graphique, je vais utiliser les modules Core et Gui de Qt.


Dans l'onglet Qt Workbench, Commencez par cocher l'option This project uses QtWorkbench.

Si vous ne voyez pas toutes les options de cet onglet, aggrandissez la fenêtre vers le bas, et toutes les options devraient alors apparaître !

Cochez les options Release, Qt, Core et Gui.
Vous devrez bien sûr adapter ces options en fonction de votre projet (je pense notamment à cocher Debug lorsque vous configurerez les options de cette cible).
Il reste 3 champs à configurer :
- Pour le champ moc files, indiquez mocs.
- Pour le champ uic files, indiquez uics.
- Pour le champ rcc files, indiquez rccs.

Image utilisateur


Bien sûr, pour la cible de construction Debug, il vous faudra cocher Debug et Console (Si vous voulez la console) au lieu de Release.

Compilation du projet



Voila vous avez terminé de configurer votre projet, une dernière indication cependant : il vous faudra mettre les dll nécessaires dans le même dossier que celui de l'exécutable compilé (par défaut le sous-dossier bin) car on ne compile plus avec la console Qt (Vous devriez trouver les dll requises dans le dossier bin du répertoire d'installation de Qt (voire de MinGW)).

Vous pouvez maintenant utiliser les boutons de compilation de Qt.
Si vous avez déjà des fichiers source, il sous suffira de les ajouter au projet et de lancer la compilation.
Voici un code source de test pour vérifier que tout s'est déroulé correctement.

Si ça ne compile pas, regardez si votre problème n'est pas déjà présent dans la FAQ, vérifiez que vous avez copié scrupuleusement tous les paramètres indiqués dans ce tutoriel, et sinon postez un message en commentaire !
Retour en haut

FAQ

Cette FAQ répertorie les problèmes fréquemment posés dans les commentaires du tutoriel, référez vous à ce chapitre avant de poser votre question, merci.


Lors de l'installation du plugin dans Code::Blocks, ce dernier me demande le fichier qtworkbench.dll.

Pour utiliser le plugin QtWorkBench, vous devez installer la Nighty Build 5382 de Codeblocks, car les dernières version ne sont pas compatibles avec ce dernier.


Le chemin d'installation de Qt n'est pas le même que celui indiqué dans le tuto.

Si vous avez installé la version SDK de Qt, alors le chemin est le suivant : C:\Qt\2009.05\qt (en remplaçant la date par celle de la version de Qt que vous avez installé).


L'onglet QtWorkBench est grisé.

Agrandissez la fenêtre vers le bas, et toutes les options devraient alors apparaître !


mingw32-make.exe: Makefile: No such file or directory
mingw32-make.exe: *** No rule to make target `Makefile'. Stop.

Vérifiez que les différentes options de configuration du premier chapitre de ce tutoriel ont bien été appliquées.


Execution of 'make.exe -f Makefile.Debug' in 'C:\[...]\project' failed.

Execution of 'make.exe -f Makefile.Release' in 'C:\[...]\project' failed.

A l'installation de MinGW, vérifiez que MinGW Make est bien coché.

Dans Settings -> Compiler and Debugger... -> Toolchain executables :
  • Vérifiez que le répertoire de MinGW (Compiler's installation directory) est correct.
  • Si vous avez réinstallé MinGW, vous pouvez cliquer sur Auto-Detect pour que CodeBlocks détecte les changements.
  • Vérifiez enfin qu'il est spécifié mingw32-make.exe dans le champs Make program.

Retour en haut
Bravo, vous êtes arrivé à la fin de ce tutoriel !
Je ne pense pas que celui-ci soit très difficile, surtout si on connait un minimum les options de Code::blocks. En tous cas, j'espère sincèrement que celui-ci vous fera gagner du temps dans vos projets.
Et n'oubliez pas de visiter le site du projet QtWorkbench.

Pour toute question ou remarque, vous pouvez utiliser les commentaires.

Bonne continuation à tous !
Retour en haut

Partager

Lire aussi

Icône
Utiliser le presse-papiers avec Qt
Icône
Introduction à Qt
Icône
Programmez avec le langage C++
Icône
Hacher avec Qt
Retour en haut
97 commentaires pour "QtWorkbench : compilez vos projets Qt sous Code::Blocks !"
Note moyenne : 2.88 / 4 (8 votes)
Pseudo Commentaire
Hors ligne Matinal3 # Posté le 27/08/2011 à 23:41:29

Bien le bonjour,
J'ai lu en vain l'ensemble des commentaires.
Mon unique problème est que je ne trouve nulle part le plugin QtWorkbench qu'il faut installer dans "Manage plugins".
Merci d'avance ! :D
Hors ligne erqsor # Posté le 28/08/2011 à 00:04:50
codeMaster? ouPas!
Avatar
close

Ville : Lille
Pays : France métropolitaine

 Bon deja j'aimerai te prévenir que ce tuto n'est pas tres recommandé, je te conseil plutot de te mettre à Qt Creator, car la version de CB requise est assez vieille.
Cependant si tu es absolument obligé d'utiliser CB, ce tuto est en effet une bonne alternative ^^

Sinon, tu as mal lu le tuto, car j'ai mis un lien vers mon FTP qui contient tous les fichiers nécessaires.
Mais je suis gentil, je te re-link ca : mon FTP
Et bon courage ;)
erqsor
 
Hors ligne Matinal3 # Posté le 28/08/2011 à 15:33:17

Merci je vais en avoir besoin :D !

En fait j'ai déjà suivi le tuto de mateo sur qtCreator et j'ai bien compris que ton tuto n'est plus tout à fait à jour mais je n'aime pas l'IDE de qt : seule la bibli m'interesse car elle utilise bien la poo du c++ qui est assez pratique... De plus, CodeBlocks est vraiment instinctif et utilisé dans une bonne partie des tutos de ce site. Voilà pourquoi il est "nécessaire" pour moi d'utiliser CB.

Je ne sais pas ce qu'est un FTP mais si j'ai bien compris il suffit que je télécharge quelque chose sur ton lien mais quoi exactement ? :euh:

Sinon j'ai pensé me rabattre sur gtkmm mais je préfère épuiser avant toutes les solutions à mon problème avec qt.
Hors ligne erqsor # Posté le 28/08/2011 à 16:07:11
codeMaster? ouPas!
Avatar
close

Ville : Lille
Pays : France métropolitaine

 voila le lien direct : QtWorkbench-0.6.0_alpha.cbplugin
Les plugins CB ont une extension qui termine par "cbplugin".
Bon courage
erqsor
 
Hors ligne Matinal3 # Posté le 28/08/2011 à 16:19:43

not installed successfully :colere2:
N'est-il pas possible de l'installer manuellement en placant la version dll (s'il est possible de l'obtenir) dans share\codeblocks\plugins ? Ou est-ce que le problème peut venir de ma version de CB ?

Voir tous les commentaires