Viktigt

Översättning är en gemenskapsinsats du kan gå med i. Den här sidan är för närvarande översatt till 100.00%.

4. Kom igång med QtCreator och QGIS

QtCreator är en IDE från skaparna av Qt-biblioteket <https://www.qt.io>`_. Med QtCreator kan du bygga vilket C++-projekt som helst, men det är verkligen optimerat för personer som arbetar med Qt-baserade applikationer (inklusive mobilappar).

4.1. Installera QtCreator

Qt Creator finns tillgänglig på alla större plattformar och kan laddas ner från https://www.qt.io/download-dev (Go the open source route). Installationsförfarandet beror på din plattform.

Om du kör en Unix-liknande plattform kan du använda kommandoraden, t.ex. på Debian:

sudo apt install qtcreator qtcreator-doc

Efter installationen bör du hitta den i din meny.

4.2. Starta upp ditt projekt

Vi antar att du redan har en lokal QGIS-klon som innehåller källkoden och att du har installerat alla nödvändiga byggberoenden etc. Det finns detaljerade instruktioner för git access och dependency requirements.

På vårt system har vi checkat ut koden till $HOME/dev/cpp/QGIS och resten av artikeln är skriven med detta som utgångspunkt. Du bör uppdatera dessa sökvägar efter vad som är lämpligt för ditt lokala system.

När du har startat QtCreator gör du File ► Open File or Project

Använd sedan den resulterande dialogrutan för filval för att bläddra till och öppna den här filen:

$HOME/dev/cpp/QGIS/CMakeLists.txt
../../_images/selectCMakeLists.png

QtCreator kommer att analysera projektet och du kommer att uppmanas att ange en byggplats och alternativ i dialogrutan Configure Project.

Eftersom vi vill att QGIS ska ha felsökningsfunktioner kommer vi bara att aktivera felsökningsposten och fylla i den med vår byggplats:

  1. Markera kryssrutan Välj alla kit som aktiverar :guilabel:`Desktop`posten

  2. Avmarkera alla utom underobjektet checkbox Debug

  3. Fyll i sökvägen med byggkatalogen. För vårt ändamål skapar vi en specifik byggkatalog för QtCreator:

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

    Det är förmodligen en bra idé att skapa separata byggkataloger för olika grenar om du har råd med diskutrymmet.

    ../../_images/configureProject.png

Det är grunderna i det hela. Tryck på Configure Project-knappen så kommer QtCreator att börja skanna källträdet för stöd för autokomplettering och göra några andra hushållsarbeten i bakgrunden.

../../_images/configurationDone.png

Vi vill justera några saker innan vi börjar bygga.

4.3. Konfigurera din byggmiljö

Klicka på ikonen Projects till vänster i QtCreator-fönstret.

../../_images/leftPanel.png

Välj fliken Build settings (normalt aktiv som standard).

../../_images/buildSettings.png

Dialogrutan visar byggkonfigurationen Debug och låter dig redigera inställningar under avsnittet CMake. Standardkonfigurationen bör vara tillräcklig för ett första pass, men beroende på dina behov kanske du vill aktivera fler funktioner som t.ex:

  • WITH_3D = ON för 3D-rendering

  • WITH_CUSTOM_WIDGETS = ON för att lägga till QGIS anpassade widgetar för gränssnittsdesign

Tryck på Apply Configuration Changes.

Du är nu redo att bygga. Tryck på knappen build Build längst ner till vänster i dialogrutan (eller Ctrl+B) för att starta projektbygget! Qt Creator kommer att börja kompilera och det kan ta lite tid första gången, beroende på din enhet.

I slutet av kompileringsprocessen kan du köra QGIS genom att trycka på knappen runInstall Run.

Kompileringen av QGIS genererar även binärfiler i build-katalogen. Därför kan du köra QGIS från kommandoraden med hjälp av:

cd $HOME/dev/cpp/QGIS/build-master-qtcreator
./output/bin/qgis

Ibland kanske du vill installera QGIS som en körbar fil, utanför byggkatalogen.

  1. Ställ in CMAKE_INSTALL_PREFIX till en plats som du har skrivåtkomst till (vi använder $HOME/apps). Detta skulle undvika att skriva över en befintlig QGIS-installation (till exempel av din pakethanterare).

    ../../_images/customInstallPrefix.png

  2. Tryck på Apply Configuration Changes för att uppdatera inställningarna

  3. Tryck på knappen build

  4. När installationen är klar hittar du den körbara filen qgis i mappen $HOME/apps/bin.

4.4. Körning och felsökning

Nu är du redo att köra och felsöka QGIS. För att sätta en brytpunkt öppnar du bara en källfil och klickar i den vänstra kolumnen.

../../_images/breakPoint.jpeg

Starta nu QGIS under felsökaren genom att klicka på runDebug Start Debugging längst ner till vänster i fönstret.