KDE software is opgesplitst in verschillende onderdelen, veel daarvan kan door kdesrc-build worden gebouwd. Begrip van de indeling hiervan helpt u bij het correct selecteren van de software modules die u wilt bouwen.

De selectie van de mogelijke modules voor het bouwen, regelt u in het configuratiebestand. Na de sectie global is een lijst van te bouwen modules, Omsloten door module ... end module regels. Een voorbeeld van een module is te zien in Voorbeeld 2.4, “Voorbeeld van een module-item in het configuratiebestand”.

module kdesrc-build-git
    # Opties voor deze module komen hier, voorbeeld:
    repository kde:kdesrc-build
    make-options -j4 # Voer 4 compilaties tegelijk uit
end module

Als u alleen module entries gebruikt, dan zal kdesrc-build ze in de opgegeven volgorde bouwen, en zal niet proberen om andere dan de door u opgegeven repositories te downloaden.

De broncode van KDE is onderverdeelt in een groot aantal relatief kleine op Git gebaseerde repositories. Om het grote aantal repositories dat nodig is bij een op KDE-gebaseerde installatie makkelijk te beheren, ondersteunt kdesrc-build het groeperen van meerdere modules en behandelt een dergelijke groep als een “module set”.

global
    git-repository-base kde-git kde:
end global

module qt
    # Opties verwijderd voor beknoptheid
end module

module-set kde-support-libs
    repository kde-git
    use-modules automoc attica akonadi
end module-set

# Andere modules indien nodig...
module kdesupport
end module

# Voegt alleen een module voor juk toe (de kde/kdemultimedia/juk repo)
module-set juk-set
    repository kde-projects
    use-modules juk
end module-set

# Voegt alle modules toe die in kde/multimedia/* aanwezig zijn, inclusief juk,
# maar geen andere dependencies
module-set multimedia-set
    repository kde-projects
    use-modules kde/multimedia
end module-set

# Voegt alle modules toe die in kde/multimedia/* aanwezig zijn, en all kde-projects
# dependencies die buiten kde/kdemultimedia zijn
module-set multimedia-deps-set
    repository kde-projects
    use-modules kde/multimedia
    include-dependencies true
end module-set

# Alle modules die in deze drie module sets zijn gecreëerd worden automatisch in
# juiste dependency volgorde gezet, onafhankelijk van de instellingen voor de include-dependencies

Bij de Git repositories van KDE is mogelijk om bij elkaar horende Git modules te groeperen in verzamelingen van bij elkaar horen modules (b.v. kdegraphics). Git herkent deze groeperingen niet, maar kdesrc-build kan deze groepen wel begrijpen, door module sets met de optie repository ingesteld op “kde-projects”.

kdesrc-build zal herkennen dat de kde-projects repository een speciale behandeling vereist, en zal het bouwproces aanpassen. Naast andere dingen, zal kdesrc-build:

Het volgende voorbeeld toont hoe u de KDE module database moet gebruiken om de Phonon multimedia library te installeren.

module-set media-support
    # Deze optie moet kde-projects zijn om de module database te gebruiken.
    repository kde-projects

    # Deze optie geeft aan naar welke modules gezocht moet worden in de database.
    use-modules phonon/phonon phonon-gstreamer phonon-vlc
end module-set

Het volgende voorbeeld is misschien realistischer, en toont een functionaliteit die alleen bij de KDE module database beschikbaar is: het met alleen maar een enkele declaratie bouwen van alle KDE grafische programma's.

module-set kdegraphics
    # Deze optie moet kde-projects zijn om de module database te gebruiken.
    repository kde-projects

    # Deze optie geeft aan naar welke modules gezocht moet worden in de database.
    use-modules kdegraphics/libs kdegraphics/*
end module-set

Er worden hier twee belangrijke mogelijkheden gedemonstreerd:

U zou kunnen besluiten dat u alle programma's in een KDE module groep wilt bouwen behalve een bepaald programma.

Bijvoorbeeld, in de groep kdeutils is ook een programma genaamdkremotecontrol. Als uw computer niet de juiste hardware heeft om de door een afstandsbediening verzonden signalen te ontvangen, dan zou u kunnen besluiten dat u kremotecontrol niet iedere keer wilt downloaden, compileren en installeren als u kdeutils update.

U kunt dit bereiken door de configuratieoptie modules negeren te gebruiken. Op de opdrachtregel doet de optie --ignore-modules hetzelfde, maar het is gemakkelijker om een module eenmalig uit te filteren.

module-set utils
    repository kde-projects

    # Hier stelt u in welke modules in de database worden opgezocht.
    use-modules kdeutils

    # Hier stelt u in welke modules worden "uitgefilterd" van de modules gekozen via use-modules, hierboven.
    ignore-modules kremotecontrol
end module-set

module-set graphics
    repository kde-projects

    # Hier stelt u in welke modules in de database worden opgezocht.
    use-modules extragear/graphics

    # Hier stelt u in welke modules worden "uitgefilterd" van de modules gekozen via use-modules, hierboven.
    # In dit geval, zijn *zowel* extragear/graphics/kipi-plugins en
    # extragear/graphics/kipi-plugins/kipi-plugins-docs genegeerd
    ignore-modules extragear/graphics/kipi-plugins
end module-set