Kapitel 3. Skriptets funktioner

Du kan ”låtsas” att utföra åtgärden. Om du skickar med --pretend eller -p på kommandoraden, ger skriptet en utförlig beskrivning av de kommandon som ska göras, utan att i själva verket utföra dem. Om du dock aldrig tidigare har kört kdesrc-build, bör du köra kommandot kdesrc-build --metadata-only först för att --pretend ska fungera.

kdesrc-build kan (med hjälp av KDE:s FTP-server) tillåta snabb utcheckning av moduler. Om modulen du checkar ut redan har paketerats på hemsidan, laddar kdesrc-build ner den versionen och förbereder den för användning på datorn.

Det är snabbare för dig, och hjälper till att minska lasten på de anonyma Git-servrarna.

En annan uppsnabbning tillhandahålls genom att starta byggprocessen för en modul så fort källkoden för den modulen har laddats ner (tillgänglig sedan version 1.6).

Utmärkt stöd för att bygga Qt™-biblioteket (i det fall då KDE-programvaran som du försöker bygga beror på en nyare version av Qt™, som inte är tillgänglig i distributionen).

kdesrc-build kräver inte att ett grafiskt gränssnitt är tillgängligt för att fungera. Du kan alltså bygga KDE:s programvara utan att behöva en alternativ grafisk miljö.

Stöder inställning av standardalternativ för alla moduler (som kompileringsinställningarna eller konfigureringsalternativen). Sådana alternativ kan dessutom normalt ändras för specifika moduler.

Dessutom lägger kdesrc-build till standardflaggor där det är lämpligt, för att spara dig besvär och möjliga fel från att skriva in dem själv. Observera: det gäller dock inte när en (egen) verktygskedja är inställd, t.ex. cmake-toolchain.

kdesrc-build kan checka ut en särskilt gren eller tagg av en modul. Du kan också försäkra dig om att en specifik revision av en modul checkas ut.

kdesrc-build kan automatiskt ändra källkodskatalog för att checka ut från ett annat arkiv, gren eller tagg. Det sker automatiskt när du ändrar ett alternativ som ändrar vad arkivets webbadress är, men du måste använda väljaren --src-only för att tala om för kdesrc-build att det är acceptabelt att utföra bytet.

kdesrc-build kan checka ut delar av en modul, för de situationer där du bara behöver ett program från en stor modul.

För utvecklare: kdesrc-build kommer att påminna dig om du använder git+ssh:// men ssh-agent inte kör, eftersom det leder till upprepad begäran om lösenord från SSH.

Kan ta bort byggkatalogen för en modul efter den har installerats för att spara utrymme till bekostnad av framtida kompileringstid.

Platserna för katalogerna som används av kdesrc-build kan ställas in (till och med per modul).

Kan använda Sudo, eller ett annat användarspecificerat kommando för att installera moduler så att kdesrc-build inte behöver köras som systemadministratör.

kdesrc-build kör normalt med reducerad prioritet för att låta dig fortsätta använda datorn medan kdesrc-build arbetar.

Har stöd för att använda KDE:s taggar och grenar.

Det finns stöd för att återuppta en byggprocess från en given modul. Du kan till och med ignorera vissa moduler tillfälligt för en given byggprocess.

kdesrc-build visar förloppet för byggprocessennär CMake används, och tar alltid tid på byggprocessen så att du i efterhand vet hur lång tid den tog.

Levereras med en inbyggt rimlig uppsättning förvalda alternativ lämpligt för att bygga en grundläggande enanvändarinstallation av KDE från de anonyma källkodsarkiven.

Expanderar dina inställningsalternativ med tilde. Du kan till exempel ange:

qtdir ~/kdesrc/build/qt

Ställer automatiskt in ett byggsystem med källkodskatalogen skild från byggkatalogen, för att hålla källkodskatalogen orörd.

Du kan ange allmänna alternativ att använda för alla moduler som checkas ut, och du kan dessutom ange alternativ som ska användas för enskilda moduler.

Tvinga fullständig omkompilering genom att köra kdesrc-build med väljaren --refresh-build.

Du kan ange diverse miljövariabler som ska användas under byggprocessen, inklusive KDEDIR, QTDIR, DO_NOT_COMPILE och CXXFLAGS.

Kommandologgning. Loggar dateras och numreras så att du alltid har en logg av en körning av skriptet. Dessutom skapas en symbolisk länk som heter latest, som alltid pekar på den senaste loggen i loggkatalogen.