diff --git a/.vscode/extensions.json b/.vscode/extensions.json index 15acf68430..4b59b3850d 100644 --- a/.vscode/extensions.json +++ b/.vscode/extensions.json @@ -1,13 +1,14 @@ { "recommendations": [ - "bierner.markdown-mermaid", - "davidanson.vscode-markdownlint", - "eamodio.gitlens", - "github.vscode-pull-request-github", - "mdickin.markdown-shortcuts", - "ms-python.python", - "ms-ceintl.vscode-language-pack-fr", - "redhat.vscode-yaml", - "streetsidesoftware.code-spell-checker-french" + "bierner.markdown-emoji", + "bierner.markdown-mermaid", + "davidanson.vscode-markdownlint", + "eamodio.gitlens", + "github.vscode-pull-request-github", + "mdickin.markdown-shortcuts", + "ms-python.python", + "ms-ceintl.vscode-language-pack-fr", + "redhat.vscode-yaml", + "streetsidesoftware.code-spell-checker-french" ] - } +} diff --git a/config/extra_tags.yml b/config/extra_tags.yml index 7ead06eb65..76215b2b68 100644 --- a/config/extra_tags.yml +++ b/config/extra_tags.yml @@ -87,12 +87,14 @@ tags: PyCSW: python PyGEOS: python PyQGIS: python - PyQt: python + PyQt: qt + PyQt5: qt PySQL: python Python: python PyWPS: python QField: telephone QGIS: qgis + Qt: qt R: rstats raster: raster relief: terrain diff --git a/config/theme_icon.yml b/config/theme_icon.yml index a923976223..555d8052b7 100644 --- a/config/theme_icon.yml +++ b/config/theme_icon.yml @@ -44,6 +44,7 @@ icon: pingouin: simple/linux python: fontawesome/brands/python qgis: simple/qgis + qt: simple/qt raster: material/data-matrix rezosocio: material/account-network roue: material/cog-play diff --git a/content/articles/2020/2020-07-03_deploy_qgis_windows.md b/content/articles/2020/2020-07-03_deploy_qgis_windows.md index 8291d7ec07..cd2287401d 100644 --- a/content/articles/2020/2020-07-03_deploy_qgis_windows.md +++ b/content/articles/2020/2020-07-03_deploy_qgis_windows.md @@ -1,5 +1,6 @@ --- title: Installer QGIS sur Windows avec OSGeo4W et Powershell +subtitle: Sauvez des clics, industrialisez authors: - Julien MOURA categories: @@ -8,6 +9,7 @@ categories: comments: true date: 2020-07-03 description: Comment déployer automatiquement (téléchargement et installation) QGIS sur Windows avec un script Powershell (ou via chocolatey), en tirant parti des capacités de l'installeur OSGeo4W. +icon: material/powershell image: https://cdn.geotribu.fr/img/tuto/qgis_deploy_windows/qgis_deploy_win_prog_postinstall.png tags: - déploiement diff --git a/content/articles/2024/2024-10-29_tester-qgis-4-futur-sig-open-source.md b/content/articles/2024/2024-10-29_tester-qgis-4-futur-sig-open-source.md new file mode 100644 index 0000000000..72d351b915 --- /dev/null +++ b/content/articles/2024/2024-10-29_tester-qgis-4-futur-sig-open-source.md @@ -0,0 +1,292 @@ +--- +title: Testez QGIS 4 avant tout le monde +subtitle: Comme si votre Qt en dépendait +authors: + - Julien MOURA +categories: + - article +comments: true +date: 2024-11-09 +description: Essayez QGIS 4 en avant-première ! Comme tout logiciel, open source ou propriétaire, QGIS repose sur d'autres logiciels ou bibliothèques. Des dépendances dont la principale est Qt. +icon: material/crystal-ball +image: +license: default +robots: index, follow +tags: + - OSGeo4W + - PyQGIS + - QGIS + - Qt + - vcpkg +--- + +# QGIS 4 : un QGIS basé sur Qt6 + +:calendar: Date de publication initiale : {{ page.meta.date | date_localized }} + +## L'architecture de QGIS pour les nuls + +![icône briques différentes](https://cdn.geotribu.fr/img/logos-icones/divers/briques_lego.webp){: .img-thumbnail-left } + +Comme tout logiciel, open source ou propriétaire, QGIS repose sur d'autres logiciels ou "bibliothèques" logicielles. Des dépendances dont la principale est Qt. + +On n'est pas là pour trop entrer dans les détails alors je vous ai fait un schéma simplifié de ce qui compose le logiciel QGIS. Oui, oui il est simplifié. + +```mermaid +flowchart TD + Q{QGIS} ====> |Dépend de| B(((Qt))) + Q -->|Dépend de| C(API géospatiales) + Q <--->|Optionnellement| P[Python] + M(plugins) -->|Dépendent de| P:::pointilles + B:::blocimportant --> S{"Interface graphique et système exploitation
(et donc toutes les API système)"} + C -->|dépend de| E[GEOS] + C -->|dépend de| T[/Autres trucs moins connus\] + Q --> T + C -->|dépend de| D[/GDAL\] + D -->|dépend de| E + D -->|dépend de| G + D -->|dépend de| F + D -->|dépend de| Z@{ shape: docs, label: "Environ 73% des
bibliothèques de drivers
de formats de données
géo-quelque-chose"} + C -->|dépend de| F[PROJ] + C -->|dépend de| G@{ shape: cyl, label: "Clients BDD
liboci, libpq,
libspatialite..." } + + classDef blocimportant fill:#ff0000,font-weight:bold + classDef pointilles fill:stroke:#f66,stroke-width:2px,color:#fff,stroke-dasharray: 5 5 +``` + +Vous avez remarqué le rond rouge au milieu ? Eh bien c'est le [cadriciel (_framework_) Qt](https://www.qt.io/) (prononcez "kuté" ou comme "_cute_" qui signifie mignon en anglais) retenu par le projet QGIS pour s'interfacer avec les API graphiques et techniques des différents systèmes d'exploitation. + +Actuellement, c'est la version 5 de Qt qui est utilisée dans QGIS 3. Il se trouve qu'elle est arrivée en fin de vie en... mai 2025 selon [la documentation officielle](https://doc.qt.io/qt-6/supported-platforms.html#supported-qt-versions). + +![Planning des versions de Qt](https://cdn.geotribu.fr/img/articles-blog-rdp/articles/2024/qgis_4_qt6/qt_versions_planning.webp){: .img-center loading=lazy } + +La dernière fois que QGIS a changé de version majeure de Qt et celle de Python, QGIS est aussi passé à la version majeure supérieure. Ce qui nous donne l'équation savante suivante : + +$$\begin{array}{l|rcl} +N° majeur version QGIS : & QGIS 2 &= (Qt 4 + Python 2) \\ + & QGIS 3 &= (Qt 5 + Python 3) \\ + & QGIS 4 & \approx (Qt 6 + Python 3) +\end{array}$$ + +Mais pour l'instant, rien n'est encore décidé sur l'incrémentation du [numéro majeur de version de QGIS](https://semver.org/lang/fr/). Le suspense est à son comble. + +Dans cet article, je vous propose donc deux façons de télécharger une version de QGIS 3 basée sur Qt6 afin de vous laisser tester par vous-même, avec un petit détour du côté de la mise à jour de vos plugins. + +[Commenter cet article :fontawesome-solid-comments:](#__comments "Aller aux commentaires"){: .md-button } +{: align=middle } + + + +---- + +## Installer QGIS basé sur Qt6 + +### Sur Windows + +Si vous travaillez sur le principal système d'exploitation des utilisateur/ices de QGIS, vous avez l'embarras du choix pour tester : + +- [une installation avec l'OSGeo4W](#aventure-osgeo4w) : relativement classique mais plus risquée pour votre environnement de travail +- la [récupération d'une version autoporteuse génére avec vckpg](#aventure-vcpkg) : plus périlleuse mais plus isolée du reste de votre système. Personnellement, c'est celle que je préfère :cowboy:. + +#### Niveau aventurier dominical : le package dév de l'OSGeo4W {: #aventure-osgeo4w } + +![logo OSGeo4W](https://cdn.geotribu.fr/img/logos-icones/logiciels_librairies/osgeo4w.webp){: .img-thumbnail-left } + +On ne présente plus l'installateur "réseau" (_OSGeo4W Network Installer_ comme on dit sur les sites non traduits de projets internationaux) que nous avons mis en avant à plusieurs reprises [ici](../2020/2020-07-03_deploy_qgis_windows.md "Installer QGIS en ligne de commande avec OSGeo4W") et [là](../2021/2021-07-06_qgis_personnaliser_package_osgeo4w.md "Utiliser OSGeo4W pour déployer QGIS en entreprise"). + +Ce petit coquin d'inspiration linuxienne infiltré derrière les lignes windowsiennes pour permettre une installation de tout ~~et n'importe quoi~~ ce qui a trait ~~aux projets OSGeo~~ à QGIS sur Windows avec une finesse de sélection des dépendances justement. + +Allez c'est parti ! + +[Télécharger l'installateur OSGeo4W](https://download.osgeo.org/osgeo4w/v2/osgeo4w-setup.exe){: .md-button } +{: align=middle } + +Lancer en mode administrateur puis suivre les étapes habituelles jusqu'à la fenêtre _Select packages_ : + +1. Dans le champ `Search`, taper `qt6-dev-full` +1. Dérouler `Desktop` +1. Cliquer sur `Skip` en regard de `qgis-qt6-dev-full` jusqu'à obtenir un numéro de version (probablement impair et supérieur d'un chiffre à la version courante mais peu importe) + + ![OSGeo4W - Select package Qt6](https://cdn.geotribu.fr/img/articles-blog-rdp/articles/2024/qgis_4_qt6/OSGeo4W_packages_Qt6.webp){: .img-center loading=lazy } + +1. suivant, suivant +1. cocher les licences (ERDAS, MrSID, Oracle, SZIP...). Notez qu'il est aussi possible de les imprimer de façon à les étudier en détail :face_with_hand_over_mouth:. +1. :coffee: :hourglass_flowing_sand: + +Une fois l'installation terminée, cherchez et ouvrez QGIS depuis le menu démarrer de votre système à fenêtres : + +![QGIS dans le menu démarrer de Windows](https://cdn.geotribu.fr/img/articles-blog-rdp/articles/2024/qgis_4_qt6/QGIS_Qt6_OSGeo4W_menu_demarrer_Windows.webp){: .img-center loading=lazy } + +Une fois QGIS démarré, aller dans le menu `À propos` pour juger sur pièces de la fraîcheur des dépendances : + +![QGIS - OSGeo4W Qt6 - Capture d'écran du menu À propos](https://cdn.geotribu.fr/img/articles-blog-rdp/articles/2024/qgis_4_qt6/QGIS_Qt6_OSGeo4W_about.webp){: .img-center loading=lazy } + +#### Niveau aventurier/ère de l'Arche Perdue : l'autoporteur de vcpkg {: #aventure-vcpkg } + +![logo vcpkg](https://cdn.geotribu.fr/img/logos-icones/logiciels_librairies/vcpkg.webp){: .img-thumbnail-left } + +[OPENGIS.ch](https://www.opengis.ch/fr/), en tête de pont sur le packaging multi-plateforme avec [vcpkg](https://vcpkg.io), diffusait un [lien de téléchargement](https://download.opengis.ch/qgis-qt6.zip) pour Windows sur [leurs réseaux sociaux](https://fosstodon.org/@opengisch/112155006378447452) dès mars dernier. Depuis, l'entreprise Suisse à qui l'on doit QField a continué son travail autour d'une chaîne de compilation et packaging plus moderne et multi-plateforme dans le cadre de la [proposition communautaire d'évolution (QEP) n°292](https://github.com/qgis/QGIS-Enhancement-Proposals/issues/292) pour aboutir le mois dernier. Le [compte-rendu dans la liste de mail au PSC](https://lists.osgeo.org/pipermail/qgis-psc/2024-October/010340.html) donne une idée du travail accompli. + +Depuis les choses ont bien avancé et QGIS est compilé/packagé avec Qt6 à chaque modification du code source (_commit_) sur GitHub. + +1. Se connecter à son compte [GitHub](https://github.com/) (ou en créer un gratuitement pour l'occasion) et cliquer sur le bouton ci-dessous : + + [:simple-githubactions: Aller télécharger un exécutable depuis GitHub](https://github.com/qgis/QGIS/actions/workflows/windows-qt6.yml?query=is%3Asuccess){: .md-button } + {: align=middle } + +1. Cliquer sur la première ligne (cadre vert dans la capture ci-dessous) pour ouvrir les résultats de la dernière exécution. Notez qu'il est possible de filtrer sur une branche en particulier (menu déroulant détouré en bleu dans la capture ci-dessous). Par exemple, pour n'afficher que [les jobs Windows Qt6 pour QGIS 3.40 ayant réussi](https://github.com/qgis/QGIS/actions/workflows/windows-qt6.yml?query=is%3Asuccess+branch%3Arelease-3_40). + + ![GitHub Actions - Jobs du workflow QGIS Windows Qt6](https://cdn.geotribu.fr/img/articles-blog-rdp/articles/2024/qgis_4_qt6/OPENGIS-CH_Qt6_GitHub_Action_jobs_annotated.png){: .img-center loading=lazy } + +1. Dans la page qui s'ouvre, cliquer sur `qgis-windows-qt6` dans la section `Artifacts` en bas (encadré vert dans la capture ci-dessous) : + + ![GitHub Actions - Résumé d'un job du workflow QGIS Windows Qt6](https://cdn.geotribu.fr/img/articles-blog-rdp/articles/2024/qgis_4_qt6/OPENGIS-CH_Qt6_GitHub_Action_artefact_annotated.png) + +1. Une fois le téléchargement terminé, Dézipper jusqu'à obtenir un dossier `qgis-X.y.z-win64` où `X.y.z` correspond à la version que vous avez sélectionnée +1. Aller dans le dossier `bin` et lancer le fichier `qgis.exe` (pensez à activer l'affichage des extensions de fichiers sur Windows, la vie est plus belle). + + ![Lancer QGIS Qt6 OPENGIS.CH](https://cdn.geotribu.fr/img/articles-blog-rdp/articles/2024/qgis_4_qt6/OPENGIS-CH_binaire_QGIS.webp){: .img-center loading=lazy } + +Si tout se passe bien, on admire le [splash screen](../2021/2021-06-11_qgis_personnaliser_splash_screen.md "Personnaliser l'image au lancement de QGIS") personnalisé pour l'occasion : + +![QGIS - Splashscreen Qt6 by OPENGIS.ch](https://cdn.geotribu.fr/img/articles-blog-rdp/articles/2024/qgis_4_qt6/qgis_Qt6_OPENGIS-CH_splashscreen.webp){: .img-center loading=lazy } + +!!! note "Dans l'ombre de la DSI" + Notez que cette version téléchargeable et autoporteuse est idéale pour les environnements où les droits d'installation sont limités. + Si on vous demande d'où ça sort, dites que vous avez lu ça sur [arcOrama](https://www.arcorama.fr/) :zipper_mouth:. + +---- + +### Sur Linux + +![logo console terminal](https://cdn.geotribu.fr/img/logos-icones/divers/ligne_commande.png "logo console terminal"){: .img-thumbnail-left } + +Comment vous dire... c'est moins fluide, c'est plus... Linux quoi ! +Donc attachez vos ceintures de lignes de commande, préparez vos merguez électroniques, ça va basher et faire chauffer vos CPU et barrettes de ~~sh~~RAM ! Téléguidé par [la bonne fée Cabieces](https://github.com/troopa81), je vous livre une recette pour Debian/Ubuntu. Je passe les détails car on n'est pas ici sur [le guide pour développeurs barbus](https://github.com/qgis/QGIS/blob/master/INSTALL.md). + +#### Prérequis + +- suite de logiciels de build essentiels +- Git +- une bonne connexion réseau pour télécharger le code source et [les dépendances de compilation](https://github.com/qgis/QGIS/blob/master/INSTALL.md#33-install-build-dependencies) +- 8 Go de RAM mais 12 c'est bien, 16 très bien et 32 c'est mieux +- 6,5 Go d'espace disque. Avec un SSD, tu gagnes un bonus de vitesse. + +Globalement, ça doit se régler avec un : + +```sh title="Installation des dépendances de QGIS avec apt" +sudo apt install cmake build-essential git libc++-dev libqscintilla2-qt6-dev libqca-qt6-dev libqt6serialport6-dev libqt6svg6-dev python3-pyqtbuild python3-pyqt6 python3-pyqt6.qsci pyqt6-dev-tools python3-pyqt6.qtsvg python3-pyqt6.qtmultimedia python3-pyqt6.sip python3-pyqt6.qtserialport python3-pyqt6.qtpositioning qmake6 qtkeychain-qt6-dev qt6-base-dev qt6-positioning-dev qt6-5compat-dev qt6-3d-dev qt6-multimedia-dev qt6-tools-dev qt6-base-private-dev sip-tools +``` + +Plus délicat, il faut gérer la dépendance à [Qwt](https://qwt.sourceforge.io/index.html), une bibliothèque de widgets Qt pour les applications techniques qui n'est pas installable facilement via apt. On doit donc partir des sources : + +```sh title="Télécharger, compiler et installer Qwt" +cd /tmp \ + && wget -N -c https://sourceforge.net/projects/qwt/files/qwt/6.3.0/qwt-6.3.0.zip/download -O qwt.zip \ + && unzip -o -q qwt.zip \ + && cd qwt-6.3.0/ \ + && qmake6 qwt.pro \ + && make \ + && mkdir -p ~/QGIS/dependencies/install/lib \ + && mkdir -p ~/QGIS/dependencies/install/include/qwt \ + && cp -Rf lib/* ~/QGIS/dependencies/install/lib \ + && cp -Rf src/* ~/QGIS/dependencies/install/include/qwt +``` + +#### Lancer le jeu de construction + +Sur un malentendu, la suite de commandes pourrait bien marcher du premier coup : + +```sh title="Builder QGIS avec Qt6 à partir d'une branche" +mkdir -p ~/Git/ +cd ~/Git +git clone https://github.com/qgis/QGIS.git -b release-3_40 --single-branch --depth 1 +cd QGIS +cmake ./ -GNinja -DSUPPRESS_QT_WARNINGS=ON -DBUILD_WITH_QT6=ON -DCMAKE_PREFIX_PATH="$DEPENDS_DIR/qwt/install" -DCMAKE_INSTALL_PREFIX=/usr/local/bin/qgis-build/ -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -DWERROR=ON -DWITH_PDAL=OFF -DWITH_GRASS7=OFF -DWITH_GRASS8=OFF -DWITH_QTWEBKIT=FALSE +``` + +---- + +### Sur MacOS + +!!! warning "" + Compte-tenu des coûts associés pour l'obtention d'un [MacBook Pro M4 Pro](https://www.apple.com/fr/shop/buy-mac/macbook-pro/14-pouces-m4-pro), forcément indispensable pour ce tutoriel, cette section est réservée aux [abonnés premium de Geotribu](../../about/sponsoring.md). :face_with_hand_over_mouth: + +---- + +## Quoi de neuf dans QGIS Qt 6 ? + +![logo QGIS](https://cdn.geotribu.fr/img/logos-icones/logiciels_librairies/qgis.png){: .img-thumbnail-left } + +Allez, on lance, on prend le temps d'essayer de reconnaître des têtes connues sur le splash screen de dév + +et hop ! + +Alors, qu'est-ce que ça change ? + +- le thème de l'interface s'aligne automatiquement sur les paramètres du système (sombre ou clair) +- on peut choisir des couleurs en CMJN et qu'elles soient conservées dans les PDF générés par QGIS, ainsi que le profil d'impression +- peu de plugins sont compatibles et on ne peut pas filtrer dessus donc c'est assez compliqué de savoir lequel on peut installer +- on peut voter sur un plugin directement depuis l'interface +- on a une sensation de vitesse à l'utilisation mais c'est peut-être lié au fait qu'il n'y a aucun plugin d'installé +- il y a parfois des messages d'erreur et des crashs mais c'est bon pour le karma d'aventurier +- sur Linux, le système d'affichage Wayland est désormais pleinement supporté + +![QGIS - ColorPicker CMJN](https://cdn.geotribu.fr/img/articles-blog-rdp/articles/2024/qgis_4_qt6/QGIS_Qt6_CMJN.webp){: width=20% loading=lazy } ![QGIS - Plugin incompatible avec Qt 6](https://cdn.geotribu.fr/img/articles-blog-rdp/articles/2024/qgis_4_qt6/QGIS_Qt6_installation_plugins_LMFP.webp){: width=20% loading=lazy } + +### Je maintiens un plugin, comment faire pour qu'il soit compatible ? + +![logo PyQGIS](https://cdn.geotribu.fr/img/logos-icones/programmation/pyqgis.png){: .img-thumbnail-left } + +Si votre plugin n'utilise pas ou peu Qt ou vous avez suivi de bonnes pratiques de développement pour votre plugin, notamment l'import de tout ce qui est PyQt via PyQGIS et non directement, il n'y aura pas grand chose à faire. Sinon, il faut prévoir un travail de migration et de tests. Plus tôt vous commencez, mieux ce sera. + +Une procédure de migration a été ajoutée il y a quelques semaines dans le ~~cookbook PyQGIS~~ [wiki du projet GitHub de QGIS](https://github.com/qgis/QGIS/wiki/Plugin-migration-to-be-compatible-with-Qt5-and-Qt6/) pour documenter l'usage d'un script de migration et rendre un plugin compatible à la fois avec QGIS Qt5 and Qt6 : + +1. Dans votre environnement Python de développement : + + ```sh + pip install astpretty tokenize-rt + ``` + +1. Si vous êtes sur Linux, il faut installer des dépendances supplémentaires : + + ```sh + sudo apt install python3-pyqt6 python3-pyqt6.qtsvg python3-pyqt6.qsci + ``` + +1. Télécharger le [script sur le projet QGIS sur GitHub](https://github.com/qgis/QGIS/blob/master/scripts/pyqt5_to_pyqt6/pyqt5_to_pyqt6.py) +1. L'exécuter en pointant sur le dossier de votre plugin : + + ```sh + python pyqt5_to_pyqt6.py /path/to/plugin + ``` + +1. Tester votre plugin sur une installation de QGIS avec Qt5 **et** sur une installation de QGIS avec Qt6 en faisant les adaptations nécessaires. +1. Éditer le fichier `metadata.txt` et ajouter la ligne : + + ```ini title="metadata.txt d'un plugin explicitement compatible avec Qt6" + [...] + supportsQt6=True + [...] + ``` + +Il y a forcément quelques limites au script, notamment : + +- la gestion des imports : il recommande souvent d'importer Qt depuis PyQGIS (`from qgis.PyQt.QtCore import Qt`) mais c'est rarement pertinent. Ceci dit, si vous utilisez des outils classiques de contrôle statique du code (flake8, ruff, isort, etc.), ils se chargeront de nettoyer le superflu. Si vous n'en utilisez pas, pensez à consulter :grimacing:. +- il ne gère pas bien les imports de PyQt qui sont hors du scope de PyQGIS. Par exemple, si vous utilisez `QtMultimedia` il va forcer l'import via `qgis.PyQt` alors que ce module PyQt là n'y est pas référencé. Cela mènera alors à une erreur d'import. + +La documentation sur cette migration est inexistante ou très difficile à trouver. Quand on m'a répondu "la seule documentation, à ce jour, hormis le wiki d'[Étienne](https://mapstodon.space/@etrimaille), c'était [la description de la PR de Nyall](https://github.com/qgis/QGIS/pull/55912)", je me suis dit qu'on est proche du délit d'initiés :grin: ! Mais cela n'a finalement rien d'étonnant pour l'instant car cela ne concerne encore que les développeurs actuellement autour duquel gravite l'écosystème QGIS. + +---- + +## Conclusion + +Derrière le titre _putaclic_, l'article est l'occasion de glisser quelques éléments de compréhension d'un projet logiciel : dépendances, dynamique communautaire, forge logicielle... + +On aura aussi vu qu'il y a plusieurs manières d'empaqueter et distribuer le même code source. Ici, OSGeo4W et vcpkg. + +---- + + + +{% include "licenses/default.md" %}