Capítol 2. Com començar

En aquest capítol, hem mostrat com utilitzar el kdesrc-build per a extreure els mòduls des del repositori del KDE i construir-los. També proporcionem una explicació bàsica de l'estructura del codi font del KDE i els passos que haureu de realitzar abans d'executar l'script.

Tots els temes presents en aquest capítol estan coberts amb encara més detalls en l'article Build from Source, al wiki de la comunitat KDE. Si esteu construint el KDE per primera vegada, és una bona idea llegir-lo o consultar-lo com a font de referència. Trobareu informació detallada sobre les eines i requisits per a empaquetar, dificultats i estratègies comunes en la compilació, i informació sobre com executar la vostra nova instal·lació del KDE.

Preparar el sistema per a construir el KDE

Configurar un compte d'usuari nou

Es recomana que utilitzeu un compte d'usuari diferent per a construir, instal·lar i executar el programari KDE, ja que es requereixen menys permisos i per a evitar interferir amb els paquets de la vostra distribució. Si ja teniu instal·lats els paquets del KDE, la millor opció seria crear un usuari diferent (dedicat) per a construir i executar el nou KDE.

Suggeriment

Deixar el sistema KDE intacte també permet tenir una recuperació d'emergència en el cas que un error en el codi faci que la vostra última construcció de programari quedi inutilitzable.

Si voleu, també podreu configurar per a instal·lar-lo en un directori de tot el sistema (p. ex., /usr/src/local). Aquest document no cobreix aquest tipus d'instal·lació, ja que suposem que sabeu el que esteu fent.

Assegureu-vos que el sistema està preparat per a construir programari KDE

Abans d'utilitzar l'script kdesrc-build (o qualsevol altra estratègia de construcció) haureu d'instal·lar les eines de desenvolupament i les biblioteques necessàries per al KDE. La llista gairebé completa de les eines requerides es troba a la pàgina «Build Requirements» al wiki de la comunitat KDE.

Aquí hi ha una llista d'algunes de les coses que necessitareu:

  • Us cal el CMake, aquest programari és el que fa servir el KDE per a gestionar la configuració del codi font en temps de construcció i la generació de les ordres de construcció específiques per al vostre sistema. La versió requerida variarà segons les versions del programari KDE que estigueu creant (consulteu la TechBase per a obtenir informació específica), però amb les distribucions modernes, el CMake inclòs amb la distribució hauria de ser suficient.

  • També haureu d'instal·lar els clients per al control del codi font necessaris per a extreure el codi font del KDE. Això vol dir que almenys necessitareu el següent:

    • El gestor Git per al control del codi font, el qual s'utilitza per a tot el codi font del KDE.

    • Encara que no és obligatori, el gestor Bazaar per al control del codi font s'utilitza per a un únic mòdul (libdbusmenu-qt), el qual es requereix per a les biblioteques del KDE. La majoria dels usuaris poden instal·lar aquesta biblioteca a través dels seus paquets de distribució, però si voleu, el kdesrc-build també admet la seva construcció. Però per a construir la libdbusmenu-qt, haureu de tenir instal·lat el Bazaar.

  • El llenguatge Perl per a crear scripts és necessari per al kdesrc-build, alguns repositoris del KDE i les Qt™ (si construïu des del codi font).

    El Perl que ve amb la seva distribució hauria de ser adequat (almenys haurà de ser el Perl 5.14), però també necessitareu alguns mòduls addicionals (el kdesrc-build us avisarà si no hi són presents):

    • IO::Socket::SSL

    • JSON::PP o JSON::XS

    • YAML::PP, YAML::XS o YAML::Syck

  • Us cal un entorn de desenvolupament C++ complet (compilador, biblioteca estàndard, temps d'execució i qualsevol altre paquet de desenvolupament requerit). Les versions mínimes requerides variaran segons el mòdul KDE: la col·lecció Frameworks 5 del KDE admet compiladors més antics, mentre que el Plasma 5 del KDE i les aplicacions KDE tendeixen a requerir compiladors més recents.

    Els compiladors GCC 4.8 o Clang 4 són el mínim recomanat. Moltes distribucions admeten la instal·lació senzilla d'aquestes eines utilitzant un paquet «build-essentials», una opció per a instal·lar les «dependències de construcció» amb les Qt™, o característiques similars. El wiki de la comunitat KDE té una pàgina que fa el seguiment dels paquets recomanats per a les principals distribucions.

  • Us cal una eina de construcció que en realitat realitzi els passos de compilació (generats pel CMake). Es recomana el Make de GNU i haurà d'estar disponible a través del gestor de paquets. El CMake admet altres opcions, com l'eina de construcció Ninja, la qual pot ser utilitzada pel kdesrc-build utilitzant l'opció custom-build-command del fitxer de configuració.

  • Finalment, necessitareu les biblioteques de les Qt™ apropiades (inclosos els paquets de desenvolupament) per a la versió del programari KDE que esteu construint. El kdesrc-build no admet oficialment la construcció de les Qt™ 5 (la versió principal actual), per la qual cosa es recomana utilitzar els paquets de desenvolupament de la vostra distribució o veure la pàgina wiki de la comunitat KDE a self-building Qt 5.

Nota

La majoria de les distribucions de sistema operatiu inclouen un mètode per a instal·lar amb facilitat les eines de desenvolupament requerides. Consulteu la pàgina wiki Required devel packages de la comunitat KDE per a veure si aquestes instruccions ja estan disponibles.

Important

Alguns d'aquests paquets es divideixen en biblioteques (o programes, o utilitats) i paquets de desenvolupament. Almenys necessitareu el programa o biblioteca i el seu paquet de desenvolupament.

Configurar el kdesrc-build

Instal·lar el kdesrc-build

Els desenvolupadors del KDE realitzen canvis freqüents en el kdesrc-build per a mantenir-lo sincronitzat amb els avenços en el desenvolupament del KDE, incloses millores en la configuració recomanada del kdesrc-build, mòduls afegits, millores en els indicadors de CMake, etc.

A causa d'això, recomanem obtenir el kdesrc-build directament des del seu repositori de codi font i després actualitzar-lo periòdicament.

Podeu obtenir el kdesrc-build des del seu repositori de codi font executant:

$ git clone https://invent.kde.org/sdk/kdesrc-build.git ~/kdesrc-build

Substituïu ~/kdesrc-build amb el directori on voleu instal·lar-lo.

Podeu actualitzar més tard el kdesrc-build executant:

$ cd ~/kdesrc-build
$ git pull

Suggeriment

Recomanem afegir el directori d'instal·lació de kdesrc-build a la vostra variable d'entorn PATH, de manera que pugueu executar el kdesrc-build sense haver d'especificar completament el seu camí cada vegada.

Preparar el fitxer de configuració

El kdesrc-build utilitza un fitxer de configuració per a controlar quins mòduls es construeixen, on s'instal·laran, etc. Aquest fitxer es troba a ~/.config/kdesrc-buildrc ($XDG_CONFIG_HOME/kdesrc-buildrc, si està establerta $XDG_CONFIG_HOME).

Podeu utilitzar kdesrc-build --generate-config per a preparar una configuració senzilla del kdesrc-build. Després podreu editar el fitxer de configuració ~/.config/kdesrc-buildrc per a fer els canvis que considereu adients.

Configurar manualment el fitxer de configuració

També podreu configurar el fitxer de configuració manualment, copiant el fitxer de configuració de mostra kdesrc-buildrc-kf5-sample inclòs a ~/.config/kdesrc-buildrc i després editant-lo. El Capítol 4, Configurar el kdesrc-build serà una referència útil per a això, especialment la seva taula per a les opcions de configuració.

El kdesrc-build conté molts fitxers de configuració recomanats per a admetre els Frameworks 5 del KDE, el Plasma™ 5 i altres aplicacions KDE. Vegeu «Incloure altres fitxers de configuració» per a obtenir informació sobre com utilitzar altres fitxers de configuració des del vostre propi kdesrc-buildrc.

Trobareu més informació sobre la sintaxi en el fitxer de configuració a «Establir les dades de configuració» i al Capítol 4, Configurar el kdesrc-build.