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 irá ajudá-lo a selecionar adequadamente os módulos de aplicações que deseja compilar.

A seleção de qual dos módulos possíveis a compilar é controlada pelo arquivo de configuração. Depois da seçã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 arquivo de configuração”.

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

O kdesrc-build só compila os módulos que tiver apresentado no seu arquivo de configuração. Além disso, os módulos são compilados na ordem indicada no arquivo de configuração. Por essa razão, você deverá certificar-se de que a ordem dos módulos no seu arquivo de configuração é consistente com a organização indicada em “Organização do Software do KDE”.

Existe um arquivo de exemplo, que vem com o kdesrc-build, chamado kdesrc-buildrc-sample. Recomenda-se que copie este arquivo para um outro chamado ~/.kdesrc-buildrc (Repare no ponto inicial à frente do 'kdesrc-buildrc'!). Depois disso, edite o arquivo novo para ajustar as opções pré-definidas a seu gosto. (Cada opção está descrita com mais detalhes no Capítulo 4, Configurando o kdesrc-build). Os módulos padrão deverão ser suficientes para garantir a instalação de um KDE relativamente completo; contudo, poderá remover muitos dos módulos que aparecem após o 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 determinado módulo de forma bastante simples, usando a sua configuração do svn-server e o nome do módulo para criar uma única URL do Subversion, que descreve exatamente de onde transferir o código-fonte.

Com a passagem para o Git, muitos módulos maiores do Subversion foram subdivididos 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 conforme necessário...
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á atuar 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.

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 na mesma URL de repositório. 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 diretamente o grupo inteiro de módulos a partir da linha de comando.

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 feito principalmente por cada módulo do Git conter o histórico completo do projeto (isto desperdiça de fato menos espaço em disco do que acontece na maioria dos repositórios do KDE, uma vez que o Git é extremamente eficiente gravando repositórios).

O KDE permite agrupar os repositórios do Git em coleções de módulos relacionados (p.ex., 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 procurar na base de dados.
    use-modules phonon/phonon phonon-gstreamer phonon-vlc
end module-set

O exemplo a seguir será talvez mais realista e demonstra uma funcionalidade que só está disponível na base de dados de módulos do KDE: a compilação de todos os aplicativos gráficos do KDE com apenas uma única declaração.

module-set kdegraphics
    # 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 importantes habilidades demonstradas aqui:

Você pode decidir que gostaria de compilar todos os programas dentro de um agrupamento de módulos do KDE, exceto um determinado 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 por controles remotos, você pode optar por não baixar, compilar e instalar o kremotecontrol todas as vezes que atualizar o kdeutils.

Desde o kdesrc-build 1.16, você pode conseguir isto usando a opção de configuração ignore-modules.

module-set utils
    repository kde-projects

    # Esta opção escolhe quais os módulos procurar no banco de dados.
    use-modules kdeutils
    # Esta opção "subtrai" os módulos escolhidos pela opção 'use-modules' acima.
    ignore-modules  kremotecontrol
end module-set

module-set graphics
    repository kde-projects

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

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