Програмне забезпечення KDE поділено на декілька компонентів, значну кількість яких можна зібрати за допомогою kdesrc-build. Знання зі структури компонентів допоможуть вам визначитися з модулями програмного забезпечення, які слід зібрати.

Вибором переліку модулів, які ви бажаєте зібрати, можна керувати за допомогою файла налаштування. Після розділу global у цьому файлі можна вказати список модулів, які слід зібрати, між рядком module та рядком end module. Приклад запису модуля наведено у розділі Приклад 2.4, «Приклад запису модуля у файлі налаштувань:».

module kdesrc-build-git
    # Тут слід вказати параметри цього модуля. Приклад:
    repository kde:kdesrc-build
    make-options -j4 # Запускати компіляцію у 4 потоки
end module

Якщо використано лише записи module, kdesrc-build збиратиме модулі у вказаному у списку порядку і не намагатиметься отримати дані будь-яких інших сховищ, які не було вказано явним чином.

Початковий код KDE розділено між багатьма відносно малими сховищами на основі Git. Щоб цією великою кількістю сховищ, які є частиною будь-якого хоч трохи корисного комплекту програмного забезпечення KDE, було простіше керувати, у kdesrc-build передбачено підтримку групування декількох модулів і обробки групи як «набору модулів».

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

module qt
    #  Параметри вилучено для спрощення
end module

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

# Інші модулі, якщо потрібно...
module kdesupport
end module

# Додає лише модуль для juk (сховище kde/kdemultimedia/juk)
module-set juk-set
    repository kde-projects
    use-modules juk
end module-set

# Додає усі модулі у kde/multimedia/*, зокрема juk,
# але без інших залежностей
module-set multimedia-set
    repository kde-projects
    use-modules kde/multimedia
end module-set

# Додає усі модулі у kde/multimedia/* та усі залежності kde-projects
# поза kde/kdemultimedia
module-set multimedia-deps-set
    repository kde-projects
    use-modules kde/multimedia
    include-dependencies true
end module-set

# Усі модулі, створені поза цими трьома наборами модулів буде
# автоматично упорядковано, незалежно від встановлення include-dependencies

Сховища git KDE забезпечують групування пов'язаних модулів git у збірки пов'язаних модулів (наприклад kdegraphics). Git не розпізнає цього групування, але kdesrc-build може визначати такі групи, використовуючи набори модулів, у яких значенням repository є «kde-projects».

kdesrc-build визначить, що сховище kde-projects потребує особливої обробки і скоригує процес збирання відповідним чином. Окрім виконання інших дій, kdesrc-build буде:

Наведений нижче приклад демонструє використання бази даних модулів KDE для встановлення мультимедійної бібліотеки Phonon.

module-set media-support
    # Значенням цього параметра має бути kde-projects, щоб використати базу даних модулів.
    repository kde-projects

    # За допомогою цього параметра можна визначити модулі, які слід шукати у базі даних.
    use-modules phonon/phonon phonon-gstreamer phonon-vlc
end module-set

Наступний приклад є, можливо, реалістичнішим. Він демонструє можливість, доступну лише у разі використання бази даних модулів KDE: збирання всіх програм KDE з графічним інтерфейсом за допомогою єдиної команд.

module-set kdegraphics
    # Значенням цього параметра має бути kde-projects, щоб можна було скористатися базою даних модулів.
    repository kde-projects

    # За допомогою цього параметра можна вказати модулі, які слід шукати у базі даних.
    use-modules extragear
end module-set

Тут продемонстровано дві важливі можливості:

Можливо, у вас виникне потреба у збиранні всіх програм у певному модулі KDE, окрім якоїсь програми.

Наприклад, у групі kdeutils міститься програма з назвою kremotecontrol. Якщо на вашому комп’ютері не встановлено обладнання для роботи з пристроями дистанційного керування, ви можете вирішити, що отримувати, збирати і встановлювати kremotecontrol під час кожного оновлення kdeutils не варто.

Досягти цього можна за допомогою параметра налаштувань ignore-modules. У командному рядку те саме завдання виконує параметр --ignore-modules, який, втім, є зручнішим для одноразового фільтрування певного модуля.

module-set utils
    repository kde-projects

    # За допомогою цього параметра можна визначити модулі, які слід шукати у базі даних.
    use-modules kdeutils

    # За допомогою цього параметра можна «вилучити» модулі зі списку використаних модулів, визначеного вище.
    ignore-modules kremotecontrol

module-set graphics
    repository kde-projects

    # За допомогою цього параметра визначаються модулі, які слід шукати у базі даних.
    use-modules extragear/graphics

    # За допомогою цього параметра «вилучаються» модулі, вибрані вище за допомогою use-modules.
    # У нашому прикладі ігноруються одразу extragear/graphics/kipi-plugins і
    # extragear/graphics/kipi-plugins/kipi-plugins-docs
    ignore-modules extragear/graphics/kipi-plugins
end module-set