Emprar l'script kdesrc-build

Amb les dades de configuració establertes, ara estareu a punt per a executar l'script. Fins i tot si encara teniu alguns ajustos o altres lectures que voleu fer, és una bona idea almenys carregar les metadades del projecte KDE.

Carregar les metadades del projecte

Des d'una finestra de terminal, accediu amb l'usuari que utilitzeu per a compilar el programari KDE i executeu l'script:

% kdesrc-build --metadata-only

Aquesta ordre configurarà el directori de codi font i connectarà amb els repositoris Git del KDE per a descarregar la seva base de dades i la base de dades amb les metadades de dependències, sense realitzar cap canvi més. És útil executar això per separat, ja que aquestes metadades són útils per a altres ordres de kdesrc-build.

Vista prèvia del que succeirà quan s'executi el kdesrc-build

Amb les metadades del projecte instal·lades, és possible obtenir una vista prèvia del que farà el kdesrc-build quan es llanci. Això es pot fer amb l'opció --pretend de la línia d'ordres.

% ./kdesrc-build --pretend

Hauríeu de veure un missatge indicant que alguns paquets s'han construït correctament (encara que en realitat no s'hagi de construir res). Si no es mostren problemes significatius, podreu continuar executant l'script.

% kdesrc-build 

Aquesta ordre descarregarà el codi font apropiat, i construirà i instal·larà cada mòdul en ordre. Després, hauríeu de veure una sortida similar a la de l'Exemple 2.2, «Sortida d'exemple d'una execució de kdesrc-build»:

Exemple 2.2. Sortida d'exemple d'una execució de kdesrc-build

% kdesrc-build
Updating kde-build-metadata (to branch master)
Updating sysadmin-repo-metadata (to branch master)

Building libdbusmenu-qt (1/200)
        No changes to libdbusmenu-qt source, proceeding to build.
        Compiling... succeeded (after 0 seconds)
        Installing.. succeeded (after 0 seconds)

Building taglib (2/200)
        Updating taglib (to branch master)
        Source update complete for taglib: 68 files affected.
        Compiling... succeeded (after 0 seconds)
        Installing.. succeeded (after 0 seconds)

Building extra-cmake-modules from <module-set at line 32> (3/200)
        Updating extra-cmake-modules (to branch master)
        Source update complete for extra-cmake-modules: 2 files affected.
        Compiling... succeeded (after 0 seconds)
        Installing.. succeeded (after 0 seconds)

        ...

Building kdevelop from kdev (200/200)
        Updating kdevelop (to branch master)
        Source update complete for kdevelop: 29 files affected.
        Compiling... succeeded (after 1 minute, and 34 seconds)
        Installing.. succeeded (after 2 seconds)

<<<  PACKAGES SUCCESSFULLY BUILT  >>>
Built 200 modules

Your logs are saved in /home/kde-src/kdesrc/log/2018-01-20-07

Resolució de les fallades de construcció

Depenent de quants mòduls estigueu descarregant, és possible que el kdesrc-build no tingui èxit la primera vegada que compileu el programari KDE. No desespereu!

El kdesrc-build registra la sortida de cada ordre que s'executa. De manera predeterminada, els fitxers de registre es mantenen a ~/kdesrc/log. Per a veure què va provocar un error per a un mòdul en la darrera ordre de kdesrc-build, en general n'hi ha prou amb mirar a ~/kdesrc/log/latest/nom_mòdul/error.log.

Suggeriment

Potser la manera més fàcil d'esbrinar quin error va causar que un mòdul no es pogués construir és cercar cap enrere amb una cerca que no distingeixi entre majúscules i minúscules, començant des del final del fitxer a la cerca de la paraula error. Una vegada la trobeu, desplaceu-vos-hi per a assegurar-vos que no hi hagi altres missatges d'error a prop. El primer missatge d'error en un grup sol ser el problema subjacent.

En aquest fitxer, veureu l'error que va fer que la compilació fallés per a aquest mòdul. Si el fitxer diu (a la part inferior) que li falten alguns paquets, intenteu instal·lar el paquet (inclosos els paquets «-dev» apropiats) abans de construir de nou aquest mòdul. Quan executeu de nou el kdesrc-build, assegureu-vos de passar l'opció --reconfigure perquè el kdesrc-build forci el mòdul a comprovar de nou els paquets que falten.

O, si l'error sembla un error de construcció (com un error de sintaxi, «prototip incorrecte», «tipus desconegut» o similar), llavors és probable que sigui un error amb el codi font del KDE, el qual amb sort es resoldrà en uns pocs dies. Si no es resol dins d'aquest temps, sou lliure d'enviar a la llista de correu (és possible que primer es requereixi una subscripció) per a informar de la fallada de construcció.

Trobareu exemples més comuns de coses que poden sortir malament i les seves solucions, així com consells i estratègies generals per a construir el programari KDE al Build from Source.

D'altra banda, suposant que tot ha anat bé, hauríeu de tenir una instal·lació nova del KDE a l'ordinador, i ara és simplement qüestió d'executar-la, el qual es descriu a continuació a «Establir l'entorn per a executar el vostre Escriptori Plasma™ del KDE».

Nota

Per a obtenir més informació sobre les característiques de registre de kdesrc-build, vegeu el «Registre de construcció de kdesrc-build».