http://docs.kde.org/
IndietroPer cominciareAvanti

Impostare i dati della configurazione

Per usare kdesrc-build, dovresti avere un file nella tua cartella ~/.config (o in $XDG_CONFIG_HOME, se impostato) chiamato .kdesrc-buildrc, che imposta le opzioni generali e specifica i moduli che vuoi scaricare e generare.

Nota

È possibile usare diversi file di configurazione per kdesrc-build, come descritto nelCapitolo 4, Configurare kdesrc-build. Se hai bisogno di usare configurazioni multiple, vedi quella sezione. Qui, presumeremo che la configurazione sia salvata in ~/.config/kdesrc-buildrc.

Il modo più semplice di procedere è usare il file kdesrc-buildrc-kf5-sample come modello, cambiando le opzioni globali per adattarle alle tue esigenze e cambiando anche l'elenco dei moduli da generare.

Le impostazioni predefinite dovrebbero essere appropriate per generare KDE. Alcune impostazioni che potresti voler cambiare includono:

  • install-dir, che cambia la cartella di destinazione in cui il tuo software KDE sarà installato. Il valore predefinito è ~/kde/usr, che è un'installazione per un solo utente.

  • branch-group, che puoi usare per scegliere il ramo di sviluppo appropriato per tutti i moduli KDE nel loro insieme. Sono supportate molte configurazioni di generazione ma probabilmente sceglierai kf5-qt5, dunque kdesrc-build scaricherà l'ultimo codice basato su Qt™ 5 e KDE Frameworks 5.

    Suggerimento

    Se non ne scegli uno, kdesrc-build utilizzerà un gruppo di rami predefinito, ma questo cambierà nel tempo; è dunque meglio sceglierne uno in modo che il gruppo di rami non cambi in modo inaspettato.

  • source-dir, per controllare la cartella di kdesrc-build utilizza per scaricare il codice sorgente, avviando il processo di generazione e salvando i registri. Questo è impostato in modo predefinito in ~/kde/src.

  • cmake-options, che imposta le opzioni da passare al comando CMake quando si generano i moduli. Tipicamente questo è utilizzato per impostare uno tra i modelli di generazione «debug» o «release», per abilitare (o disabilitare) le funzioni opzionali o per passare informazioni al processo di generazione riguardo la posizione delle librerie richieste.

  • make-options, che imposta le opzioni utilizzate quando si esegue realmente il comando make per generare ogni modulo (una volta che CMake ha stabilito il sistema di generazione).

    L'opzione più tipica è -jN, dove N deve essere sostituito col numero massimo di operazioni di compilazione che vuoi consentire. Un numero più alto (fino al numero di CPU logici disponibili nel tuo sistema) porta a generazioni più rapide ma richiede maggiore impegno di risorse del sistema.

    Suggerimento

    kdesrc-build imposta l'opzione num-cores al numero rilevato di core di elaborazione disponibili. Puoi utilizzare questo valore nel tuo file di configurazione in modo da evitare di impostarlo manualmente.

    Esempio 2.1. Configurare Make per utilizzare tutte le CPU disponibili, con eccezioni

    global
    # Questa variabile d'ambiente viene utilizzata automaticamente da make, inclusi
    # i comandi make non eseguiti direttamente da kdesrc-build, come il configure di Qt
    set-env MAKEFLAGS -j${num-cores}
    …
end global

…

module-set big-module-set
    repository kde-projects
    use-modules calligra
    make-options -j2 # Numero ridotto di operazioni di generazione solo per questi moduli
end module-set

    Nota

    Alcuni depositi Git molto grandi potrebbero affossare il tuo sistema se provi a compilare con troppe operazioni di generazione simultanee, in particolare i depositi tipo Qt™ WebKit e Qt™ WebEngine. Per mantenere l'interattività del sistema potresti dover ridurre il numero di operazioni di generazione per i moduli specifici.

    Esempio 2.1, «Configurare Make per utilizzare tutte le CPU disponibili, con eccezioni» fornisce un esempio su come farlo.

Potresti voler selezionare diversi moduli da generare, come descritto in la sezione chiamata «Selezionare i moduli da generare».