C++, Qt, OpenGL, CUDA

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Installation et premiers pas avec Qt 5.4 ======

Ce tutoriel est une reprise et une mise à jour des vidéos que j'avais fait pour [[http://www.d-booker.fr/110-qt-5-les-essentiels.html|mon livre]] sur la chaîne YouTube de mon éditeur, D-Booker, à l'occasion de la sortie de Qt 5.0 : [[https://www.youtube.com/watch?v=rYU4ONnyChc&list=PLJ0RWFYCJZYF1pxD5FlAFqQVYkmebeTUY|Installer le framework Qt 5]]. C'est également une réprise des vidéos que j'avais faite à l'occasion de la sortie de Qt 5.2, sur ma chaîne YouTube :  [[https://www.youtube.com/watch?v=7AlH4bPbBsE|Installation et premier pas avec Qt 5.2 sur Windows]] [[https://www.youtube.com/watch?v=qKWtfDNfbzA|Savoir utiliser la documentation de Qt]]. Je préfère passer au format tutoriel classique, pour faciliter les mises à jour.

La première partie est consacrée à l'installation de Qt sur Linux et Windows et la création de projets par défaut, pour vérifier que l'installation s'est bien passée. Il n'y a pas de version Mac, tout simplement par ce que j'en ai pas :)

Dans la seconde partie, j'explique un peu plus en détail le fonctionnement de Qt et de son installation, pour aider ceux qui rencontre des problèmes lors de l'installation.

Pour terminer, je décris comment utiliser la documentation de Qt, qui est très bien faite et très riche. En particulier, il existe des codes d'exemple pour la majorité des fonctionnalités de Qt. Quand vous souhaitez réaliser quelque chose, la première chose à faire est probablement d'étudier ces codes d'exemple.

===== Installation de Qt =====

==== Sous Windows ====

Le téléchargement de Qt se fait sur le site du projet Qt : http://qt-project.org/.

{{ :install_1.png?500 |}}

Cette page d'accueil contient une série de liens en haut, en particulier :

  * [[http://www.qt.io/download/|Downloads]], pour télécharger Qt ;
  * [[http://qt-project.org/doc/|Documentation]], pour les pages de documentation.

La page de téléchargement contient plusieurs versions de Qt. Il faut savoir que Qt existe sous licence libre GPL/LGPL (qui permet de créer des programmes libres ou commerciaux, avec quelques conditions d'utilisation) ou sous licence commerciale (qui donnent plus de libertés).

{{ :insall_2.png?500 |}}

Vous n'avez bien sûr pas besoin de télécharger la version commerciale. Cliquer sur le lien "Download" dans la colonne "Community". Cela ouvre une nouvelle page :

{{ :install_3.png?500 |}}

Cette page reconnaît par défaut le système d'exploitation et propose la version //online//. Cliquer sur le lien pour lancer le téléchargement. La version //online// est en fait un simple petit programme (environ 13 Mo), qui vous permet de sélectionner ensuite les versions de Qt à installer (vous pouvez en installer plusieurs), les outils supplémentaires (l'éditeur Qt Creator, le compilateur MingW sous Windows, etc.).

Si vous ne souhaitez pas utiliser l'installateur proposé par défaut, vous pouvez cliquer sur le lien "View All Downloads". Cela permet d'afficher la liste de tous les téléchargement possible. Dans l'ordre :

  * Les installateurs //online// pour tous les systèmes (linux 32b et 64b, Mac et Windows) ;
  * Les installateurs //offline// pour Linux, Mac et Windows ;
  * Les sources de Qt (Qt étant un projet libre, ses sources sont librement accessibles) ;
  * L'éditeur Qt Creator ;
  * Les autres outils : le plugin pour Visual Studio, QBS, Qt Installer Framework, les archives des anciennes versions de Qt (ce dernier lien permet en particulier de télécharger Qt 4 si nécessaire).

Dans ce tutoriel, nous verrons que l'utilisation de l'installateur //online// par défaut. Si vous n'utilisez pas la méthode par défaut, on va considérer que vous savez ce que vous faites...

L'installateur s'appelle ''qt-opensource-windows-x86-1.6.0-6-online.exe''. Lancez le.

{{ :install_4.png?500 |}}

Le bouton "Paramètres" permet de configurer un serveur proxy si vous en utiliser un et d'ajouter des dépôts pour Qt.

Après avoir cliqué sur "Suivant", le programme recherche en ligne la liste des logiciels que vous pouvez installer (cela peut durer quelques dizaines de secondes à quelques minutes, en fonction de votre connexion).

La page suivante permet de choisir le dossier d'installation de Qt. Par défaut, le chemin est "C:\Qt".

{{ :install_5.png?500 |}}

La page suivante permet de sélectionner la liste des outils à installer. Pour utiliser Qt, il faut installer trois outils :

  * l'éditeur Qt Creator (il est installé automatiquement et il n'est pas possible de le désactiver) ;
  * au moins une version de Qt ;
  * un compilateur compatible avec la version de Qt installée.

{{ :install_6.png?500 |}}

Par défaut, choisissez la dernière version de Qt (5.4) pour "MingW 4.9.1 (32 bit) OpenGL" et le compilateur "MingW 4.9.1". Nous verrons dans le suite de ce tutoriel comment installer d'autres versions de Qt et de compilateurs.

La page suivante permet de valider les licences utilisateurs. Cliquez sur suivant.

{{ :install_7.png?500 |}}

La page suivante permet de choisir le répertoire dans le menu Démarrer.

{{ :install_7-2.png?500 |}}

Une fois que tout cela est fait, l'installation est prête pour démarrer.

{{ :install_7-3.png?500 |}}

Le téléchargement puis l'installation se lancent. Selon votre connexion et le nombre de paquets que vous installez, cela peut prendre plusieurs minutes à plusieurs heures (si vous souhaitez installer beaucoup de paquets, il est probablement préférable de répéter l'installation plusieurs fois). L'installation sature le processeur, ne vous étonnez pas trop si Windows devient un peu lent pendant ce temps là. Allez vous balader dehors, il fait beau.

{{ :install_8.png?500 |}}

Une fois que l'installation est terminée, la page suivante propose d'ouvrir le fichier ReadMe (qui décrit les nouveautés de la dernière mise à jour de Qt) et de lancer Qt Creator. Vous pouvez décocher la case "Open Qt ReadMe" et cliquer sur Terminer pour lancer Qt Creator.

{{ :install_9.png?500 |}}

=== Installation alternative : Microsoft Visual C++ ===

Plusieurs versions, allez sur http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs.aspx et Visual Studio Express 2013 with Update 4 for Windows Desktop 



==== Sous Linux ====

==== Pour Android et iOS ====

L'installation des outils pour développer des applications avec Qt pour Android et iOS est un peu plus compliqué (il est nécessaire d'installer les outils spécifiques de chaque plateforme, en plus de Qt). Pour Android, j'ai fait une série de tutoriel sur mon blog : https://guillaumebelz.wordpress.com/category/android/. Je ferais bientôt une mise à jour pour Qt 5.4; Pour iOS, je n'ai pas de Mac ni d'iPhone/iPad, je n'ai pas pu tester l'installation. Si quelqu'un utilise ces outils et qu'il souhaite compléter ce tutoriel, contactez moi.

==== Tester l'installation de Qt ====

La première chose à faire après avoir installer Qt est de tester si l'installation s'est correctement déroulée. Pour cela, nous allons simplement créer un programme par défaut et l'exécuter. Si tout se passe bien, le programme se lancera et affichera une fenêtre.

Lorsque vous lancer l'éditeur Qt Creator, vous arrivez sur la page d'accueil suivante :

{{ :install_10.png?500 |}}

Quelques éléments de vocabulaire relatif à Qt Creator, pour bien comprendre les choses. Les icônes à gauche en haut permettent de choisir le mode : 

  * "Accueil", la page actuelle ;
  * "Éditer", lorsque vous éditerez un fichier ;
  * "Design", pour les éditeurs graphiques de Qt ;
  * "Débogage", pour corriger les programmes ;
  * "Projet", pour éditer les paramètres de compilation et d'exécution des projets ;
  * "Analyse", pour les outils d'analyse de performances ;
  * "Aide", pour les pages d'aide de Qt.

En dessous des icônes de mode (toujours dans la barre à gauche), une série d'icônes (actuellement grisés, puisque aucun projet n'est ouvert) permettent de haut en bas :

  * de choisir le kit à utiliser pour la compilation et l'exécution (voir la suite pour les explications sur les kits, comment les configurer et les utiliser) ;
  * de lancer le programme en mode normal (le triangle) ;
  * de lancer le programme en mode Debug (le triangle avec un insecte - //bug// en anglais) ;
  * le simplement compiler le programme, sans le lancer (bien sûr, les boutons précédents pour lancer le programme le compile dans un premier temps, avant de le lancer).

En bas, une série d'onglets permet d'ouvrir des fenêtres de messages. Lors de la compilation ou lorsqu'il y a un problème, les messages s'affichent dans ces fenêtres. De gauche à droite :

  * Le localisateur (Ctrl+K) pour rechercher des classes, variables ou fonctions dans le projet ;
  * la fenêtre de problèmes, qui affiche les messages d'erreurs ;
  * la fenêtre de recherche, pour afficher le résultat des recherches (Ctrl+F pour une recherche dans le fichier courant, Ctrl+Shift+F pour rechercher dans plusieurs fichiers) ;
  * la sortie d'application, qui affiche les messages de l'application (par exemple avec ''std::cout'' ou ''qDebug()'') ;
  * la sortie de compilation, qui affiche les commandes lancées lors de la compilation. Cette fenêtre vous sera particulièrement utile en cas de problème de configuration du projet (fichier non trouvé par exemple) ;
  * la console pour le QML et le JavaScript ;
  * la fenêtre de messages généraux.

Pour créer un nouveau projet par défaut, vous pouvez aller dans le mode "Accueil" puis cliquer sur "Nouveau projet" ou aller dans le menu "Fichier" puis "Nouveau fichier ou projet...". Un assistant vous permet de sélectionner le type de projet :

{{ :install_11.png?500 |}}

Il est possible de créer beaucoup de types de projet différents, il suffit de lire la description à droite pour savoir à quoi cela correspond.

Pour les plus important :

  * "Application" puis "Application Qt avec widgets" pour les applications graphiques Qt classiques ;
  * "Application" puis "Application Qt Quick" pour les applications graphiques Qt utilisant le nouveau langage de Qt : le QML ;
  * "Application" puis "Application Qt console" pour les applications non graphiques Qt ;
  * "Projet non Qt" puis "Projet C++" pour les applications C++ sans Qt ;
  * "Importer un projet" pour créer un clone d'un projet existant dans un gestionnaire de versions (CVS, SVN, Git, etc.).

Choisissez "Application Qt avec widgets" pour ce premier test.

La page suivante permet de choisir le nom du projet que l'on souhaite créer et l'emplacement sur le disque. Remarque : ne mettez pas vos projets dans "C:\Qt", créer une répertoire dédié pour cela, par exemple dans vos documents ou votre répertoire de travail.

{{ :install_12.png?500 |}}

La page suivante permet de sélection les kits à utiliser pour compiler le programme. Il est possible de sélectionner plusieurs kits (voir la suite de ce tutoriel pour les explications sur les kits), pour le moment (si vous avez suivi les instructions de ce tutoriel et que c'est la première fois que vous installer Qt), vous n'avez qu'un seul kit disponible : "Qt MingW".

Si vous n'avez aucun kit disponible dans cette page, c'est qu'il y a eu un problème lors de l'installation (Qt Creator n'a pas réussit à trouver une version de Qt et une compilateur compatibles ensemble). Voir la suite de ce tutoriel pour les explications sur les kits.

Remarque : Qt 5.4 n'est pas encore totalement finalisée, il est possible que vous ayez une erreur dans le message affiché, comme c'est le cas sur la copie d'écran. Rien de grave.

{{ :install_13.png?500 |}}

Le projet par défaut propose de créer une classe //MainWindow// (fenêtre principale). On va être gentil, on va pas le contrarier, on le laisse faire. Cliquez sur Suivant.

{{ :install_14.png?500 |}}

Pour terminer, il est possible d'ajouter le projet dans un gestionnaire de versions. Cela n'est pas nécessaire pour ce test, mais n'hésitez pas à utiliser un tel gestionnaire, c'est très pratique et utile.

Cliquez sur Terminer pour créer le projet.

{{ :install_15.png?500 |}}

Qt Creator crée plusieurs fichiers et passe en mode "Éditer" pour afficher le contenu des fichiers. Un projet Qt contient généralement les fichiers suivants (cela peut changer en fonction du type de projet) :

  * un fichier de projet ''.pro'' ou ''.qmlprojet'', qui contient les informations sur le projet (en particulier le liste des fichiers et les modules Qt à utiliser) ;
  * les fichiers C++ d'en-tête (''.h'') et d'implémentation (''.cpp''). En particulier, le projet contient le fichier ''main.cpp'', qui est le point de démarrage du programme ;
  * les fichiers de formulaire ''.ui''.

Cliquez sur les différents fichiers pour voir comment Qt Creator les affiche. Par exemple, les fichiers ''.h'' et ''.cpp'' sont afficher dans un éditeur de texte avec coloration syntaxique. Les fichiers ''.ui'' sont affichés en utilisant un éditeur graphique (mode Design).

{{ :install_16.png?500 |}}

Cliquez sur le triangle vers en bas à gauche, dans le menu "Compiler" puis "Exécuter" ou appuyez sur Ctrl+R pour lancer le programme. Si tout s'est bien passé, une fenêtre "MainWindow" devrait s'ouvrir.

{{ :install_17.png?500 |}}

===== Configurer Qt Creator =====

  * kit, compilateur, versions de Qt
  * mise à jour
  * projet par défaut Qt et Qt Quick
  * quelle versiond e Qt ?

===== Savoir lire la documentation de Qt =====
C++, Qt, OpenGL, CUDA

Outils d'utilisateurs

Outils du Site

Outils de la Page
