Outdated version of the documentation. Find the latest one here.

Découvrir et aller plus loin avec QtCreator et QGIS

QtCreator est un IDE développé par les fondateurs de la bibliothèque Qt. Avec QtCreator, vous pouvez construire n’importe quel projet C++ mais l’IDE sera vraiment optimisé pour les personnes qui travaillent sur des applications basées sur Qt(4) (y compris les applications mobiles). Chaque point décrit ci-dessous assume que vous travaillez avec Ubuntu 11.04 ‘Natty’.

Installation de QtCreator

Cette partie est simple:

sudo apt-get install qtcreator qtcreator-doc

Une fois installé, vous devriez trouver ceci dans votre menu GNOME.

Paramétrer votre projet

Je suppose que vous avez déjà un clone local de QGIS contenant le code source et que vous avez installé et compilé toutes les dépendances nécessaires etc. Des instructions supplémentaires sont à accès git et installation de dépendances.

Sur mon système j’ai placé le code dans $HOME/dev/cpp/QGIS et le reste de cet article a été rédigé en présumant l’emplacement de ce répertoire. Vous pouvez modifier ces chemins pour les adapter à votre système local.

Lors du lancement de QtCreator, faire:

Fichier -> Ouvrir un Fichier ou Projet

Utilisez ensuite la boîte de dialogue de sélection de fichier pour naviguer et ouvrir ce fichier:

$HOME/dev/cpp/QGIS/CMakeLists.txt
../../_images/image01.jpeg

Ensuite, on vous demandera l’emplacement d’un répertoire de compilation. Je créé un répertoire dédié au travail de QtCreator:

$HOME/dev/cpp/QGIS/build-master-qtcreator

Il est généralement bon de séparer les répertoires de compilation par branches différentes, si vous pouvez vous le permettre par rapport à l’occupation disque.

../../_images/image02.jpeg

Ensuite, on vous demandera si vous avez une ou plusieurs options de compilation CMake à transmettre à CMake. Nous allons indiquer à CMake que nous voulons une compilation en mode déboguage en ajoutant l’option suivante:

-DCMAKE_BUILD_TYPE=Debug
../../_images/image03.jpeg

Voilà la base. Une fois que vous avez fermé l’assistant, QtCreator lancera une recherche dans l’arborescence du code source pour la gestion de l’autocomplétion et pour d’autres opérations, en tâche de fond. Avant de lancer la compilation, nous voulons encore paramétrer finement certains éléments.

Paramétrer votre environnement de compilation

Cliquez sur l’icône ‘Projets’ à la gauche de la fenêtre QtCreator.

../../_images/image04.jpeg

Choisissez l’onglet de paramètres de compilation (normalement, actif par défaut).

../../_images/image05.jpeg

Nous allons maintenant ajouter une étape supplémentaire. Pourquoi ? Parce que QGIS ne peut actuellement n’être lancé qu’à partir d’un répertoire d’installation et non depuis le répertoire de construction. Il est donc indispensable de s’assurer que QGIS est installé lorsqu’il est compilé. Sous ‘Étapes de compilation’, cliquez sur le bouton ‘Ajouter l’étape compiler’ et choisissez ‘Étape personnalisée’.

../../_images/image06.jpeg

Maintenant, nous paramétrons les détails suivants:

Autoriser une étape personnalisée: [oui]

Commande: faire

Répertoire de travail: $HOME/dev/cpp/QGIS/build-master-qtcreator

Arguments de la commande: install

../../_images/image07.jpeg

Vous êtes pratiquement prêts à compiler. Une dernière note: QtCreator a besoin des droits d’écriture sur le répertoire d’installation. Par défaut (ce que j’utilise ici), QGIS sera installé dans /usr/local. Pour mes besoins sur ma machine de développement, je me suis simplement donné des droits d’écriture dans le répertoire /usr/local.

Pour commencer la compilation, cliquez sur l’icône en forme de gros marteau dans le coin bas à droite de la fenêtre.

../../_images/image08.jpeg

Paramétrer votre environnement de lancement

Comme mentionné ci-dessus, nous ne pouvons pas lancer QGIS directement depuis le répertoire de construction et nous devons donc créer une cible de lancement pour indiquer à QtCreator de lancer QGIS à partir du répertoire d’installation (dans mon cas /usr/local/). Pour y parvenir, retournez dans l’écran de configuration des projets.

../../_images/image04.jpeg

Maintenant, sélectionnez l’onglet ‘Paramètres d’exécution’.

../../_images/image09.jpeg

Nous devons mettre à jour les paramètres d’exécution par défaut en remplaçant la configuration d’exécution ‘qgis’ par une commande personnalisée.

../../_images/image10.jpeg

Pour y parvenir, cliquez sur le bouton ‘Ajouter v’ à côté de la liste déroulante ‘Configuration d’exécution’ et choisissez ‘Exécutable personnalisé’ à partir du haut de la liste.

../../_images/image11.jpeg

Maintenant, indiquez les éléments suivants dans les propriétés:

Exécutable: /usr/local/bin/qgis

Arguments:

Répertoire de travail: $HOME

Lancer dans un terminal: [non]

Débogueur: C++ [oui]

Qml [no]

Cliquez ensuite sur le bouton ‘Renommer’ et donnez à votre exécutable personnalisé un nom significatif, ex: ‘QGIS installé’.

../../_images/image12.jpeg

Exécution et déboguage

Maintenant, vous êtes prêts à lancer et à déboguer QGIS. Pour insérer un point d’arrêt, ouvrez simplement un fichier source et cliquez dans la colonne de gauche.

../../_images/image14.jpeg

Maintenant, lancez QGIS dans le débogueur en cliquant sur l’icône avec un bogue dessus dans le coin en bas à gauche de la fenêtre.

../../_images/image13.jpeg