development

Développement

Environnement de développement dans QGIS3 pour Windows

1. Installer QGIS3 LTR avec OSGeo4W en suivant cette documentation.

2. Cloner le dépôt GitHub du plugin en exécutant cette commande dans un terminal powershell.

   git clone https://github.com/isogeo/isogeo-plugin-qgis.git <futur/emplacement/du/depot> --branch <branche_a_cloner>

3. Ouvrir le dossier futur/emplacement/du/depot dans Visual Studio Code

4. Modifier le fichier futur/emplacement/du/depot/.vscode/settings.json

   Il contient les paramétrages permettant d'établir l'environnement de développement à l'ouverture du projet dans VS Code. Pour adapter ces paramétrages à votre ordinateur, il convient de modifier/vérifier certaines valeurs.

   • Le paramètre "terminal.integrated.env.windows" permet de reproduire l'environnement de QGIS LTR, C'est une liste de couples "variable d'environnement":"valeur" dont il faut remplacer les valeurs par celles que l'on peut obtenir ainsi :

     1. Exécuter le fichier python-qgis-ltr.bat depuis l'invite de commande cmd (il se trouve sûrement dans OSGeo4W64/bin/) :

        >cd OSGeo4W64\bin
        
        >python-qgis-ltr.bat
        

        Cela permet d'exécuter la version de Python 3 installée avec OSGeo4W après avoir établi l'environnement de QGIS3 LTR.

     2. Arrêter l'exécution de Python 3 et afficher l'environnement de QGIS3 LTR à l'aide de ces commandes :

        >>> ^Z
        
        >set

        Les valeurs à inscrire dans le paramètre "terminal.integrated.env.windows" se trouvent dans la liste de variables d'environnement ainsi obtenue. Il est possible qu'elles ne diffèrent pas des valeurs initiales.

   • Les trois paramètres suivant servent au fonctionnement de l'extension PYQT Integration qui facilite la compilation des fichier .ui d'interface graphique :

     • Paramètre "pyqt-integration.qtdesigner.path" : chemin absolu du fichier qgis-ltr-designer.bat se trouvant dans le dossier d'installation d'OSGeo4W (surement dans OSGeo4W64/bin/).

     • Paramètre "pyqt-integration.pyuic.cmd" : chemin absolu du fichier pyuic5.bat se trouvant dans le dossier d'installation d'OSGeo4W (surement dans OSGeo4W64/apps/Python37/Scripts/).

     • Paramètre "pyqt-integration.pyrcc.cmd" : chemin absolu du fichier pyrcc5.bat se trouvant dans le dossier d'installation d'OSGeo4W (surement dans OSGeo4W64/apps/Python37/Scripts/).

5. Créer et activer l'environnement virtuel en exécutant les commandes suivantes dans le terminal powershell de VSCode :

   > python -m venv .venv_tests --system-site-packages
   
   > .\.venv_tests\Scripts\activate

Prérequis

Avoir installé Visual Studio Code ainsi que ses extensions Python et PYQT Integration.