Ange inställningsinformation

För att använda kdesrc-build ska du ha en fil i katalogen ~/.config (eller i $XDG_CONFIG_HOME, om angivet) vid namn kdesrc-buildrc, som ställer in allmänna alternativ och anger modulerna som du vill ladda ner och bygga.

Notera

Det är möjligt att använda andra inställningsfiler för kdesrc-build, som beskrivs i Kapitel 4, Anpassa kdesrc-build. Om du behöver använda flera inställningar, se det avsnittet.Här antar vi att inställningarna är lagrade i ~/.config/kdesrc-buildrc.

Det enklaste sättet att fortsätta är att använda filen kdesrc-buildrc-kf5-sample som mall, och ändra allmänna inställningar för att stämma med vad du vill ha, och dessutom ändra listan med moduler du vill bygga.

Standardinställningarna bör vara lämpliga för att utföra byggprocessen för KDE. Vissa inställningar som du kan vilja ändra omfattar:

  • kdedir, som ändrar målkatalogen som KDE-programvaran installeras i. Standardvärdet är ~/kde, som är en enanvändarinstallation.

  • branch-group som kan användas för att välja lämplig utvecklingsgren för KDE-moduler som helhet. Det finns många byggkonfigurationer som stöds, men det är troligtvis kf5-qt5 som du ska välja så att kdesrc-build laddar ner den senaste koden baserad på Qt™ 5 och KDE Ramverk 5.

    Tips

    kdesrc-build använder en standardgrupp om du inte väljer någon, men standardvärdet ändras med tiden, så det är bättre att välja en så att inte grengruppen oväntat ändras.

  • source-dir, för att bestämma katalogen som kdesrc-build använder för att ladda ner källkoden, köra byggprocessen och spara loggar. Standardvärdet är ~/kdesrc.

  • cmake-options som ställer in alternativ att skicka till kommandot CMake när varje modul byggs. Oftast används det för att välja mellan byggvarianterna debug och release, för att aktivera (eller inaktivera) valfria funktioner, eller för att skicka information till byggprocessen om platsen för nödvändiga bibliotek.

  • make-options som ställer in väljare använda när kommandot make faktiskt utförs för att bygga varje modul (när väl CMake har etablerat byggsystemet).

    Den mest typiska väljaren är -jN, där N ska ersättas med det maximala antal kompileringsjobb som du vill tillåta. Ett större tal (upp till antalet logiska processorer som systemet har tillgängligt) leder till en snabbare byggprocess, men kräver mer systemresurser.

    Tips

    kdesrc-build ställer in alternativet num-cores till detekterat antal processorkärnor. Du kan använda värdet i din egen inställningsfil för att undvika att behöva ange det manuellt.

    Exempel 2.1. Anpassa Make för att använda alla tillgängliga processorer, med undantag

    global
        # Miljövariabeln används automatiskt av make, inklusive
        # make-kommandon som inte direkt körs av kdesrc-build, såsom Qt:s configure
        set-env MAKEFLAGS -j${num-cores}
        …
    end global
    
    …
    
    module-set big-module-set
        repository kde-projects
        use-modules calligra
        make-options -j2 # Reducerat antal byggjobb för bara dessa moduler
    end module-set
    

    Notera

    Några mycket stora Git-arkiv kan översvämma systemet om du försöker kompilera med för många byggjobb på en gång, särskilt arkiv som Qt™ Webkit och Qt™ WebEngine. För att behålla systemets interaktivitet måste du kanske reducera antal byggjobb för specifika moduler.

    Exempel 2.1, ”Anpassa Make för att använda alla tillgängliga processorer, med undantag” ger ett exempel på hur man kan göra det.

Du kanske vill välja andra moduler att bygga, vilket beskrivs i ”Välja moduler att bygga”.