Die KDE-Software ist in verschiedene Komponenten aufgeteilt, die meisten können mit kdesrc-build erstellt werden. das Verständnis dieser Organisation hilft dabei, die gewünschten Module zum Erstellen richtig auszuwählen.

Die Auswahl der der zu erstellenden Module wird durch die Einrichtungsdatei gesteuert. Darin folgt nach dem Abschnitt global eine Liste der zu erstellenden Module, eingefasst durch die Zeilen „module“ ... „end module“. Ein Beispiel für einen Moduleintrag finden Sie in Beispiel 2.4, „Beispieleintrag für ein Modul in der Einrichtungsdatei“.

module kdesrc-build-git
    # Optionen für dieses Modul werden hier eingetragen, zum Beispiel:
    repository kde:kdesrc-build
    make-options -j4 # Startet vier Compilerläufe gleichzeitig
end module

Wenn Sie nur module-Einträge verwenden, baut kdesrc-build diese in der von Ihnen angegebenen Reihenfolge und versucht nicht, andere Repositories herunterzuladen, außer denen, die Sie direkt angeben.

Der KDE-Quellcode ist in eine große Anzahl von relativ kleinen Git-Repositories aufgeteilt. Um die Verwaltung der großen Anzahl von Repositories zu erleichtern, die an einer sinnvollen KDE-basierten Installation dazugehören, unterstützt kdesrc-build die Gruppierung mehrerer Module und behandelt sie als „Modulgruppen“.

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

module qt
    # Optionen entfernt, um das Beispiel kurz zu halten
end module

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

# Andere Module soweit erforderlich ..
module kdesupport
end module

# Nur juk aus kde/kdemultimedia/juk)
module-set juk-set
    repository kde-projects
    use-modules juk
end module-set

# Alle Module in kde/multimedia/*, einschließlich juk,
# aber keine anderen Abhängigkeiten
module-set multimedia-set
    repository kde-projects
    use-modules kde/multimedia
end module-set

# Alle Module in kde/multimedia/* und alle kde-projects-
# Abhängigkeiten für kde/kdemultimedia
module-set multimedia-deps-set
    repository kde-projects
    use-modules kde/multimedia
    include-dependencies true
end module-set

# Alle Module, die aus diesen drei Modulgruppen generiert wurden, erhalten automatisch
# die richtige Reihenfolge der Abhängigkeiten, unabhängig von den Einstellungen für include-dependencies

Die Git-Repositories von KDE ermöglichen die Gruppierung verwandter Git-Module z. B. kdegraphics. Git erkennt diese Gruppierungen nicht, aber kdesrc-build kann diese Gruppen durch Modulgruppen mit einer Option repository vom Wert „kde-projects“ korrekt verarbeiten.

kdesrc-build erkennt, dass das kde-projects-Repositories besonders bearbeitet werden müssen und passt den Erstellungsprozess dafür an. Unter anderem werden folgende Schritte ausgeführt:

Das folgende Beispiel zeigt, wie die KDE-Moduldatenbank verwendet werden kann, um die Phonon-Multimediabibliothek zu installieren.

module-set media-support
    # Als Option muss kde-projects angegeben werden, damit die Moduldatenbank verwendet wird.
    repository kde-projects

    # Diese Option bestimmt, nach welchem Modul in der Datenbank gesucht wird.
    use-modules phonon/phonon phonon-gstreamer phonon-vlc
end module-set

Das folgende Beispiel ist wahrscheinlich realistischer und zeigt eine Funktion, die nur für die KDE-Moduldatenbank verfügbar ist: Erstellen aller KDE-Grafikprogramme mit einer Deklaration.

module-set kdegraphics
    # Als option muss kde-projects für die Moduldatenbank verwendet werden.
    repository kde-projects

    # Diese Option legt fest, welche Module in der Datenbank gesucht werden sollen.
    use-modules kdegraphics/libs kdegraphics/*
end module-set

Hier werden zwei wichtige Fähigkeiten gezeigt:

Vielleicht möchten Sie alle Programme in einer KDE-Modulgruppe mit Ausnahme eines bestimmten Programms erstellen.

In der Gruppe kdeutils gibt es zum Beispiel ein Programm mit dem Namen kremotecontrol. Hat Ihr Rechner nicht die passende Hardware, um Signale von Fernsteuerungen zu empfangen, werden Sie möglicherweise darauf verzichten wollen, jedesmal kremotecontrol herunterzuladen, zu erstellen und zu installieren, wenn Sie kdeutils aktualisieren.

Dies erreichen Sie durch die Option ignore-modules. Auf der Befehlszeile bewirkt die Option --ignore-modules dasselbe, ist aber praktischer, um ein Modul nur einmal herauszufiltern.

module-set utils
    repository kde-projects

    # Diese Option bestimmt, nach welchem Modul in der Datenbank gesucht wird.
    use-modules kdeutils

    # Diese Option legt fest, welche der mit use-modules oben gewählten Module ausgelassen wird.
    ignore-modules kremotecontrol
 end module-set

module-set graphics
repository kde-projects

# Diese Option bestimmt, nach welchem Modul in der Datenbank gesucht wird.
use-modules extragear/graphics

# Diese Option legt fest, welche der mit use-modules oben gewählten Module ausgelassen wird.
# In diesem Fall werden *sowohl* extragear/graphics/kipi-plugins und
# extragear/graphics/kipi-plugins/kipi-plugins-docs ignoriert
ignore-modules extragear/graphics/kipi-plugins
end module-set