Komma igångInnehållsförteckning
I det här kapitlet visar vi hur kdesrc-build används för att checka ut moduler från KDE-arkivet och bygga dem. Vi tillhandahåller också en grundläggande förklaring av KDE:s källkodsstruktur och stegen du måste utföra innan skriptet körs.
Alla ämnen som presenteras i det här kapitlet täcks med ännu mer detaljer i artikeln Build from Source på webbplatsen KDE Community Wiki. Om du kompilerar KDE för första gången, är det en god idé att läsa den, eller rådfråga den som en referenskälla. Du hittar detaljerad information om paketverktyg och krav, vanliga fallgropar vid kompilering och strategier och information om att köra den nya KDE-installationen.
Det rekommenderas att du använder ett annat användarkonto för att bygga, installera och köra din KDE-programvara från, eftersom färre rättigheter krävs, och för att undvika konflikt med distributionens paket. Om du redan har installerade KDE-paket, är det bästa valet att skapa en annan (dedicerad) användare för att bygga och köra det nya KDE.
Tips
Att lämna systemets KDE orört, låter dig också ha en reservutväg i nödfall om ett kodningsmisstag gör att den senaste programvarubyggningen är oanvändbar.
Du kan också ställa in att installera i en systemkatalog (t.ex. /usr/src/local) om du vill. Det här dokumentet omfattar inte den installationstypen, eftersom vi antar att du vet vad du gör.
Innan du använder skriptet kdesrc-build (eller någon annan byggstrategi) måste du installera utvecklingsverktyg och bibliotek som behövs för KDE. Den nästan fullständiga listan med verktyg som behövs finns på sidan med byggkrav på KDE Community Wiki .
Här är en lista med några av de saker du kommer att behöva:
Du behöver CMake, eftersom denna programvara är vad KDE använder för att hantera byggkonfiguration av källkoden och generering av de specifika byggkommandona för systemet. Versionen som krävs varierar beroende på vilken version av KDE-programvaran som byggs (se teknikbasen för närmare detaljer), men med moderna distributioner bör den CMake som är inkluderad i distributionen vara fullt tillräcklig.
Du måste också installera klientprogram för källkodshantering som används för att checka ut KDE:s källkod. Det betyder att du åtminstone behöver följande:
Källkodshanteringssystemet Git som används för all källkod i KDE.
Även om det inte krävs, används källkodshanteringssystemet Bazaar för en enda modul (libdbusmenu-qt) som krävs av KDE-biblioteken. De flesta användare kan installera biblioteket via distributionens paket, men kdesrc-build stöder att också bygga det om du så önskar. Men för att bygga libdbusmenu-qt, måste du ha installerat Bazaar.
Skriptspråket Perl krävs för kdesrc-build, vissa KDE-arkiv och Qt™ (om det byggs från källkod).
Perl som levereras med distributionen bör vara lämplig (det måste vara minst Perl 5.14), men vissa ytterligare moduler behövs också (kdesrc-build varnar dig om de inte är tillgängliga):
IO::Socket::SSL
JSON::PP eller JSON::XS
YAML::PP, YAML::XS eller YAML::Syck
En fullständig C++ utvecklingsmiljö behövs (kompilator, standardbibliotek, körtidsbibliotek och alla utvecklingspaket som krävs). De äldsta nödvändiga versionerna varierar baserat på KDE-modulen: samlingen KDE-ramverk 5 stöder de äldsta kompilatorerna, medan KDE Plasma 5 och KDE-program brukar kräva nyare kompilatorer.
Kompilatorerna GCC 4.8 eller Clang 4 är de äldsta som rekommenderas. Många distributioner stöder att enkelt installera verktygen genom att använda paketet ”build-essentials”, ett alternativ att installera "byggberoenden" Qt™ eller liknande funktioner. KDE-gemenskapens Wiki har en sida som följer rekommenderade paket för större distributioner.
Ett byggverktyg som faktiskt utför kompileringsstegen behövs (de som genereras av CMake). GNU Make rekommenderas och bör vara tillgängligt via pakethanteraren. CMake stöder andra alternativ, såsom byggverktyget Ninja, som kan utnyttjas av kdesrc-build genom att använda inställningsfilens alternativ custom-build-command.
Slutligen behövs lämpliga Qt™-bibliotek (inklusive utvecklingspaket) för versionen av KDE-programvara som du bygger. kdesrc-build stöder inte officiellt att bygga Qt™ 5 (nuvarande huvudversion), alltså rekommenderas du att använda distributionens utvecklingspaket, eller att titta på KDE-gemenskapens Wiki sida om att bygga Qt 5 själv.
Notera
De flesta distributioner av operativsystem inkluderar en metod att enkelt installera nödvändiga utvecklingsverktyg. Konsultera avsnittet Required devel packages på Community Wiki, för att se om instruktioner redan är tillgängliga.
Viktigt
Vissa av paketen är uppdelade i bibliotek (eller program, eller verktyg) och utvecklingspaket Du behöver åtminstone programmet eller biblioteket och dess utvecklingspaket.
KDE-utvecklarna gör täta förändringar av kdesrc-build för att hålla det synkroniserat med framsteg i KDE-utvecklingen, inklusive förbättringar av den rekommenderade inställningen av kdesrc-build, tillägg av moduler, förbättring av flaggor i CMake, etc.
På grund av detta, rekommenderar vi att hämta kdesrc-build direkt från dess källkodsarkiv och därefter uppdatera det periodiskt.
Du kan hämta kdesrc-build från dess källkodsarkiv, genom att köra:
$gitclonehttps://invent.kde.org/sdk/kdesrc-build.git~/kdesrc-build
Ersätt ~/kdesrc-build
Du kan senare uppdatera kdesrc-build genom att köra:
$cd~/kdesrc-build$gitpull
Tips
Vi rekommenderar att lägga till installationskatalogen för kdesrc-build i miljövariabeln PATH, så att kdesrc-build kan köras utan att behöva ange hela sökvägen varje gång.
kdesrc-build använder en inställningsfil för att bestämma vilka moduler som byggs, var de installeras, etc. Filen heter ~/.config/kdesrc-buildrc ($XDG_CONFIG_HOME/kdesrc-buildrc, om $XDG_CONFIG_HOME är angivet).
Du kan använda ett program som ingår tillsammans med kdesrc-build, vid namn kdesrc-build-setup för att skapa en enkel inställning för kdesrc-build. Därefter kan du redigera inställningsfilen ~/.config/kdesrc-buildrc för att göra eventuella ändringar du har behov av.
Själva kdesrc-build-setup körs från en terminal (istället för att använda ett grafiskt gränssnitt), precis som kdesrc-build, så du kan använda det även om du inte har något grafiskt gränssnitt tillgängligt ännu.
Det går också att uppdatera inställningsfilen för hand, genom att kopiera det inkluderade exemplet på en inställningsfil kdesrc-buildrc-kf5-sample till ~/.config/kdesrc-buildrc och sedan redigera filen. En användbar referens för detta är Kapitel 4, Anpassa kdesrc-build, i synnerhet dess tabell över inställningsalternativ.
kdesrc-build innehåller många rekommenderade inställningsfiler för att stödja KDE Ramverk 5, Plasma™ 5 och andra KDE-program. kdesrc-build-setup hänvisar till dessa filer i inställningsfilen som skapas, men du kan också använda dem själv. Se ”Inkludera andra inställningsfiler” för information om hur andra inställningsfiler används från din egen kdesrc-buildrc.
Du hittar mer information om syntaxen i en inställningsfil i ”Ange inställningsinformation” och Kapitel 4, Anpassa kdesrc-build.