Découvrir et aller plus loin avec QtCreator et QGIS¶

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

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.

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

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.

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

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

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

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.

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.

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

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.

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.

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é’.

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.

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.