Den nye QGIS 4.0-version er lige om hjørnet og forventes at blive udgivet i februar 2026. Selvom der ikke kommer store forandringer i brugerfladen eller nye funktioner, markerer opdateringen et vigtigt teknisk skift: QGIS går fra Qt5 til Qt6. Det betyder, at fundamentet under programmet bliver moderniseret. Du kan læse mere om baggrunden for skiftet til Qt6 her.
Hvis du har ansvaret for plugins, der skal fungere i QGIS 4.0, er det derfor nu, du bør teste dem, så de er klar, når den nye version udkommer. I dette blogindlæg gennemgår jeg de vigtigste trin i processen.
Opdatering af plugins til QGIS 4
For at sikre, at dit plugin fungerer korrekt i QGIS 4.0, er der udarbejdet en officiel opdateringsvejledning, som ligger på GitHub.
Dit plugin kan uden problemer opdateres, så det understøtter Qt6, samtidig med at det forbliver kompatibelt med Qt5.
Trin 1: Installér QGIS 3.99 med Qt6
Start med at hent udviklingsversionen QGIS 3.99 med Qt6. Det er denne version, der udvikles på, og som bliver den kommende QGIS 4.0.
Har du installeret QGIS på en Windows-maskine med ‘OSGeo4W Network Installer’, kan du nemt downloade QGIS 3.99 uden at slette dine andre QGIS-versioner. Ved denne installationsmetode skal du, når du kommer til ‘Select Packages’-vinduet, vælge “qgis-qt6-dev: QGIS Nightly Build of development branch with qt6”. Når denne er valgt, kan du færdiggøre installationen.
Efter installationen skal du sikre dig, at du åbner QGIS 3.99. Er du i tvivl, om du har åbnet den rigtige version, og om det er Qt6, der anvendes, kan du kontrollere dette under: ‘Hjælp’ → ‘Om’. I dialogen kan du se QGIS- og Qt-versionen.
Trin 2: Opdatér pluginets metadata
Alle QGIS-plugins indeholder en fil ved navn metadata.txt, hvor kompatible QGIS-versioner er angivet. I mange plugins er qgisMaximumVersion sat til 3.99 (eller lavere), hvilket betyder, at pluginet ikke vil kunne installeres i QGIS 4.0. Derfor skal metadata.txt opdateres, så denne parameter sættes til 4.99. Du skal også sikre dig, at der står “supportsQt6=True”.
Når dette er gjort, skal du teste, om pluginet virker i QGIS 3.99 med Qt6.
Trin 3: Automatisk opdatering af pluginkode fra Qt5 til Qt6
Der er lavet et script, der automatisk kan opdatere en del af den kode, hvor Qt5 bruges til syntaks, der virker i Qt6.
Dette script kan du hente her, hvor du også kan læse mere om processen. Som beskrevet, skal du først installere de oplyste biblioteker, og derefter downloade og køre pyqt5_topyqt6_scriptet.
Når dette er gjort, skal du teste, om pluginet virker i QGIS 3.99 med Qt6.
Opdatering af GeosearchDK, Qlr-browser og Danish Address Tool
I vores egne plugins (GeosearchDK, Qlr-browser og Danish Address Tool) erstattede scriptet automatisk en stor del af Qt5-koden med Qt6-kode. Vi måtte dog lave enkelte manuelle tilpasninger i koden – særligt i indstillingsdialogen og de værdier, der indsættes her.
På QGIS’ plugin repository kan du nu hente den nye version af GeosearchDK (version 3.0) og Qlr-Browser (version 4.0), der virker i både QGIS 3 og den kommende QGIS 4.0.
I begyndelsen af det nye år ser vi på adressepluginet.
Tests af plugins
I forbindelse med mit praktikophold hos Septima har jeg testet, om følgende af Septimas plugins virker i QGIS 3.99:
- QLR Browser
- Danish Address Tool
- GeosearchDK
For at sikre en systematisk og ensartet testprocess har jeg udarbejdet et testskema, der giver et klart overblik over, hvilke dele, der bør testes ved plugin-opdateringer.
Testskemaet dækker blandt andet kontrol af pluginets funktionalitet, om indstillinger gemmes når QGIS lukkes, og om pluginet kan afinstalleres. Det er desuden en god idé at teste, om pluginet også virker, hvis du opretter en ny brugerprofil.
For hvert plugin har jeg opdateret dets GitHub med testskema. De findes her:
Klar til QGIS 4?
Overgangen til QGIS 4.0 behøver ikke være kompliceret. Med den rette forberedelse kan du sikre, at dine plugins fungerer problemfrit i den nye version.
Har du spørgsmål til processen eller brug for sparring, er du altid velkommen til at kontakte os.