• Moyen

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

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').

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.

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.

Fermez la fenêtre en appuyant sur Close.

Image utilisateur

Configuration des variables globales

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

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

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

Création et configuration du projet

Création du projet

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

Allez dans le menu Project -> Properties.

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

Image utilisateur

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 :

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

Image utilisateur

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

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

Image utilisateur

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

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

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 !

FAQ

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 !

déroulement d'un cours

  • 1

    Dès aujourd'hui, vous avez accès au contenu pédagogique et aux exercices du cours.

  • 2

    Vous progressez dans le cours semaine par semaine. Une partie du cours correspond à une semaine de travail de votre part.

  • !

    Les exercices doivent être réalisés en une semaine. La date limite vous sera annoncée au démarrage de chaque nouvelle partie. Les exercices sont indispensables pour obtenir votre certification.

  • 3

    À l'issue du cours, vous recevrez vos résultats par e-mail. Votre certificat de réussite vous sera également transmis si vous êtes membre Premium et que vous avez au moins 70% de bonnes réponses.

Exemple de certificat de réussite
Exemple de certificat de réussite