As aplicações do KDE estão divididas em diversos componentes, muitos dos quais poderão ser compilados pelo kdesrc-build. A compreensão desta organização ajudá-lo-á a seleccionar adequadamente os módulos de aplicações que deseja compilar.

A selecção de qual dos módulos possíveis a compilar é controlada pelo ficheiro de configuração. Depois da secção global, existe uma lista com os módulos a compilar, delimitada pelas linhas 'module ... end module'. Aparece um item de exemplo para um módulo em Exemplo 2.1, “Item de exemplo de módulo no ficheiro de configuração”.

module nome-módulo
    # As opções deste módulo vão aqui, por exemplo:
    make-options -j4 # Correr 4 compilações de cada vez
end module

O kdesrc-build só compila os módulos que tiver apresentado no seu ficheiro de configuração. Para além disso, os módulos são compilados pela ordem indicada no ficheiro de configuração. Por essa razão, deverá garantir que a ordem dos módulos no seu ficheiro de configuração é consistente com a organização indicada em “Organização do 'Software' do KDE”.

Existe um ficheiro de exemplo, que vem com o kdesrc-build, chamado kdesrc-buildrc-sample. Recomenda-se que copie este ficheiro para um outro chamado ~/.kdesrc-buildrc (Repare no ponto inicial à frente do 'kdesrc-buildrc'!). Depois disso, edite o ficheiro novo para ajustar as opções predefinidas a seu gosto. (Cada opção está descrita com mais detalhe no Capítulo 4, Configurar o kdesrc-build). Os módulos predefinidos deverão ser suficientes para garantir a instalação de um KDE relativamente completo; contudo, poderá remover muitos dos módulos que aparecem a seguir ao kdebase, caso queira poupar espaço em disco ou tempo de compilação.

O kdesrc-build é normalmente capaz de adivinhar onde transferir o código-fonte para um dado módulo de forma bastante simples, usando a sua configuração do svn-server e o nome do módulo para criar um único URL do Subversion, que descreve exactamente de onde transferir o código-fonte.

Com a passagem para o Git, muitos módulos maiores do Subversion foram sub-divididos por seu turno no processo, não existindo garantia de como encontrar um módulo com base no seu módulo. Devido a isto, foi desenvolvido um conceito chamado “conjuntos de módulos” para o kdesrc-build 1.12.1.

Se usar um conjunto de módulos, poderá declarar rapidamente muitos módulos do Git para serem transferidos e compilados, como se tivesse definido uma declaração de módulo em separado para cada um. A opção repository é tratada de forma especial para definir de onde foi transferido cada módulo, sendo todas as outras opções existentes no conjunto de módulos copiadas para cada módulo gerado desta forma.

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

module qt
    # Opções removidas para resumir
end module

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

# Outros módulos porventura necessários...
module kdesupport
end module

Em Exemplo 2.2, “Usar os conjuntos de módulos”, aparece um breve conjunto de módulos. Quando o kdesrc-build encontrar este conjunto de módulos, irá actuar como se, para cada módulo indicado em use-modules, fosse declarado um módulo individual com o seu repository igual à opção repository do conjunto, seguida do nome do módulo indicado.

Para além disso, poderá passar outras opções num conjunto de módulos, as quais são copiadas para os novos módulos que forem criados desta forma. Ao usar os conjuntos de módulos, é possível declarar rapidamente vários módulos do Git que se baseiam todos no mesmo URL de repositório. Para além disso, desde o kdesrc-build 1.13, é possível atribuir um nome aos conjuntos de módulos (como demonstrado no exemplo), o que lhe permite referenciar directamente o grupo inteiro de módulos a partir da linha de comandos.

Os conjuntos de módulos usam as opções

Com a migração do código-fonte do KDE para se migrar para o git.kde.org, houve um crescimento explosivo no número de módulos (por exemplo, um único módulo do Subversion chamado kdegraphics transforma-se em 16 módulos diferentes no Git).

Isto foi derivado principalmente por cada módulo do Git conter o histórico completo do projecto (isto desperdiça de facto menos espaço em disco do que acontece a maioria dos repositórios do KDE, dado que o Git é extremamente eficiente a gravar repositórios).

O KDE permite agrupar os repositórios do Git em colecções de módulos relacionados (p.eex., o 'kdegraphics'). Estes módulos poderão por sua vez ser agrupados (p.ex., Compilação de Software do KDE). O Git não reconhece estes agrupamentos, mas o kdesrc-build pode ser configurado para lidar com estes grupos.

A forma como isto é feito é através da utilização de conjuntos de módulos. Em vez de usar um repositório específico git:// ou o nome de um repositório criado pelo git-repository-base, é usado o nome de repositório especial “kde-projects”.

O kdesrc-build irá reconhecer que o repositório kde-projects precisa de tratamento especial e ajustar o processo de compilação em conformidade. Entre outras coisas, o kdesrc-build irá:

O seguinte exemplo demonstra como usar a base de dados de módulos do KDE para instalar a biblioteca multimédia Phonon.

module-set media-support
    # Esta opção deverá ser 'kde-projects' para usar a base de dados de módulos.
    repository kde-projects

    # Esta opção escolhe quais os módulos a procurar na base de dados.
    use-modules phonon/phonon phonon-gstreamer phonon-vlc
end module-set

O exemplo seguinte será porventura mais realista e demonstra uma funcionalidade que só está disponível na base de dados de módulos do KDE: a compilação de todas as aplicações gráficas do KDE com apenas uma única declaração.

module-set nunca-tente-isto
    # Esta opção deverá ser igual a 'kde-projects' para usar a base de dados de módulos
    repository kde-projects

    # Esta opção escolhe os módulos a pesquisar na base de dados.
    use-modules kdegraphics/libs kdegraphics/*
end module-set

Existem duas capacidades importantes aqui demonstradas:

Poderá decidir que gostaria de compilar todos os módulos de um dado agrupamento de módulos do KDE, excepto um dado programa.

Por exemplo, o grupo kdeutils inclui um programa chamado kremotecontrol. Se o seu computador não tiver o 'hardware' adequado para receber os sinais enviados pelos comandos à distância, poderá optar por não transferir, compilar e instalar o kremotecontrol de cada vez que actualiza o kdeutils.

Desde o kdesrc-build 1.16, poderá conseguir isto com a opção de configuração ignore-modules.

module-set utils
    repository kde-projects

    # Esta opção escolhe os módulos a pesquisar na base de dados.
    use-modules kdeutils

    # Esta opção "retira" os módulos dos módulos escolhidos pelo "use-modules" acima.
    ignore-modules kremotecontrol
end module-set

module-set graphics
    repository kde-projects

    # Esta opção escolhe os módulos a pesquisar na base de dados.
    use-modules extragear/graphics

    # Esta opção "retira" os módulos dos escolhidos acima pelo "use-modules".
    # Neste caso, *tanto* o 'extragear/graphics/kipi-plugins' como o
    # 'extragear/graphics/kipi-plugins/kipi-plugins-docs' são ignorados
    ignore-modules extragear/graphics/kipi-plugins
end module-set