Dimensione: 8267
Commento: ripristino procedura estesa cmake
|
← Versione 77 del 30/12/2024 17.15.57 ⇥
Dimensione: 9786
Commento:
|
Le cancellazioni sono segnalate in questo modo. | Le aggiunte sono segnalate in questo modo. |
Linea 5: | Linea 5: |
<<Informazioni(forum=''http://forum.ubuntu-it.org/viewtopic.php?f=46&t=614576''; rilasci="16.04 14.04")>> | <<Informazioni(forum=''http://forum.ubuntu-it.org/viewtopic.php?f=46&t=614576''; rilasci="24.04 22.04 20.04")>> |
Linea 9: | Linea 9: |
Una peculiarità dei programmi ''open source'' è che ne viene sempre reso disponibile il [[https://it.wikipedia.org/wiki/Codice_sorgente|codice sorgente]], scaricabile sotto forma di [[AmministrazioneSistema/FormatiDiCompressione|archivio compresso]] con estensione `.tar.gz`, `.tar.bz2` o `.zip`. Tale archivio contiene file di testo scritti in un [[https://it.wikipedia.org/wiki/Linguaggio_di_programmazione|linguaggio di programmazione]], detti ''file sorgente'', e altri eventuali file necessari al programma, come immagini e suoni. | Una peculiarità dei programmi ''open source'' è il fatto che viene sempre reso disponibile il [[https://it.wikipedia.org/wiki/Codice_sorgente|codice sorgente]], scaricabile sotto forma di [[AmministrazioneSistema/FormatiDiCompressione|archivio compresso]] con estensione `.tar.gz`, `.tar.bz2`, `.tar.xz`, o `.zip`. Tale archivio contiene file di testo scritti in un [[https://it.wikipedia.org/wiki/Linguaggio_di_programmazione|linguaggio di programmazione]], detti ''file sorgente'', e altri eventuali file necessari al programma. |
Linea 13: | Linea 13: |
La seguente guida cerca di gettare delle linee guida sulla compilazione illustrando concetti e pratiche di base, tuttavia è opportuno ricordare che da programma a programma il metodo utilizzato può variare sensibilmente. Di solito chi ha creato un programma allega sotto forma di file `INSTALL`, `README`, `readme.md` le istruzioni da eseguire per arrivare a una corretta compilazione dei sorgenti.<<BR>> Pertanto la prima regola da seguire è leggere la documentazione allegata. <<Anchor(preparativi)>> |
|
Linea 15: | Linea 19: |
* [[AmministrazioneSistema/InstallareProgrammi|Installare]] il pacchetto [[apt://build-essential | build-essential]]. * Per programmi basati su '''[[https://it.wikipedia.org/wiki/KDE|KDE]]''' o '''[[https://it.wikipedia.org/wiki/Qt_(toolkit)|Qt]]''', [[AmministrazioneSistema/InstallareProgrammi|installare]] il pacchetto [[apt://cmake |cmake]]. * [[AmministrazioneSistema/FormatiDiCompressione#decomprimere|Estrarre]] il pacchetto dei sorgenti nella propria '''Home'''. |
0. [[AmministrazioneSistema/InstallareProgrammi|Installare]] il pacchetto [[apt://build-essential | build-essential]].<<BR>>Per programmi basati su '''[[https://it.wikipedia.org/wiki/KDE|KDE]]''' o '''[[https://it.wikipedia.org/wiki/Qt_(toolkit)|Qt]]''', [[AmministrazioneSistema/InstallareProgrammi|installare]] il pacchetto [[apt://cmake|cmake]]. 0. [[AmministrazioneSistema/FormatiDiCompressione#decomprimere|Estrarre]] il pacchetto dei sorgenti nella propria '''Home'''. |
Linea 19: | Linea 22: |
||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%><<Immagine(Icone/Grandi/info.png,,center)>> ||<style="padding:0.5em; border:none;">Per mantenere ordinata la propria '''Home''' è consigliabile creare una sottocartella specifica per le compilazioni. || | Per semplicità consideriamo che i sorgenti siano all'interno della cartella `sorgenti` all'interno della propria '''Home'''. {{{#!wiki tip Più in generale per mantenere ordinata la propria '''Home''' è consigliabile creare una sottocartella specifica per le compilazioni. }}} |
Linea 25: | Linea 32: |
Le istruzioni che seguono descrivono i due metodi più comuni per generare il '''makefile''', ovvero mediante lo '''script di configurazione''' o del programma '''Cmake'''. Tuttavia le istruzioni specifiche per ogni programma sono contenute in un file di testo, solitamente chiamato `INSTALL` o `README`, distribuito insieme ai sorgenti. | Di seguito sono descritti, in linea generale, i due metodi più comuni per generare il '''makefile''', ovvero mediante lo '''scritp di configurazione''' o del programma '''Cmake'''. Attenersi alle istruzioni specifiche per ogni programma, di solito contenute in file di testo allegati e/o distribuiti insieme ai sorgenti, denominati `INSTALL`, `README`, `readme.md` o altri nomi simili. |
Linea 29: | Linea 36: |
0. [[AmministrazioneSistema/ComandiBase#cd|Spostarsi tramite riga di comando]] nella cartella dove sono stati estratti i sorgerti. 0. Avviare lo [[Programmazione/LinguaggioBash|script]] di configurazione digitando nel [[AmministrazioneSistema/RigaDiComando|terminale]] il seguente comando:{{{ |
0. Aprire il [[AmministrazioneSistema/Terminale|terminale]] e [[AmministrazioneSistema/ComandiBase#cd|spostarsi]] nella cartella in cui sono stati estratti i sorgenti digitando il seguente comando:{{{ cd sorgenti }}} 0. Dare i [[AmministrazioneSistema/PermessiFile#Assegnare_i_permessi_di_esecuzione|permessi di esecuzione]] allo script di configurazione digitando il seguente comando:{{{ chmod +x configure }}}Se il file avesse un nome differente, ad esempio `configure.sh`, ripetere il comando col nome corretto. 0. Avviare lo [[Programmazione/LinguaggioBash|script]] di configurazione digitando il seguente comando:{{{ |
Linea 33: | Linea 45: |
||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%><<Immagine(Icone/Grandi/info.png,,center)>> ||<style="padding:0.5em; border:none;">Per ottenere un elenco delle opzioni messe a disposizione dallo script digitare l'opzione ''-h''. || ||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%><<Immagine(Icone/Piccole/note.png,,center)>> ||<style="padding:0.5em; border:none;">''Se la generazione del '''makefile''' dovesse interrompersi a causa di una [[AmministrazioneSistema/Pacchetti#Dipendenze|dipendenza]] non presente nel sistema, consultare il paragrafo [[#Installazione_dipendenze|Installazione dipendenze]]. Per una più semplice gestione delle dipendenze è possibile avvalersi del programma '''[[Programmazione/Checkinstall|auto-apt]]'''''|| |
|
Linea 36: | Linea 46: |
{{{#!wiki note Se la generazione del '''makefile''' dovesse interrompersi a causa di una [[AmministrazioneSistema/Pacchetti#Dipendenze|dipendenza]] non presente nel sistema, consultare il paragrafo [[#Installazione_dipendenze|Installazione dipendenze]]. }}} === Accorgimenti === * Spesso per migliorare la compressione [[AmministrazioneSistema/FormatiDiCompressione|dell'archivio compresso]] contenente il [[https://it.wikipedia.org/wiki/Codice_sorgente|codice sorgente]], lo [[Programmazione/LinguaggioBash|script]] di configurazione `configure` e il file `Makefile` vanno creati eseguendo prima lo script `autogen.sh` con il comando:{{{ ./autogen.sh }}} * Quasi sempre lo script di configurazione mette a disposizione l'opzione `--prefix=path` che permette di scegliere in quale directory allocare il programma che si va compilando. Nell'uso più frequente di questa opzione il comando diventa:{{{ ./configure --prefix=/usr }}} * Per ottenere un elenco delle ulteriori opzioni messe a disposizione dallo script digitare l'opzione `-h` oppure consultare i file `INSTALL` o `README` forniti con il sorgente. <<Anchor(cmake)>> |
|
Linea 38: | Linea 63: |
Per programmi basati su '''[[https://it.wikipedia.org/wiki/KDE|KDE]]''' o '''[[https://it.wikipedia.org/wiki/Qt_(toolkit)|Qt]]''' la generazione del '''makefile''' è generalmente affidata al programma '''Cmake''', come spiegato di seguito: 0. [[AmministrazioneSistema/ComandiBase#cd|Spostarsi tramite riga di comando]] nella cartella dove sono stati estratti i sorgerti. 0. Creare la cartella `build` digitando nel [[AmministrazioneSistema/RigaDiComando|terminale]] il seguente comando:{{{ mkdir build |
Per programmi basati su '''[[https://it.wikipedia.org/wiki/KDE|KDE]]''' o '''[[https://it.wikipedia.org/wiki/Qt_(toolkit)|Qt]]''' la generazione del '''makefile''' è generalmente affidata al programma '''CMake'''. {{{#!wiki tip Il programma '''CMake''' è utilizzabile anche tramite interfaccia grafica. Per maggiori informazioni consultare la pagina [[Programmazione/CMakeGui|CMakeGui]]. |
Linea 43: | Linea 68: |
0. Spostarsi nella cartella appena creata digitando nel [[AmministrazioneSistema/RigaDiComando|terminale]] il seguente comando:{{{ cd build |
0. Creare la cartella `build` nella cartella in cui sono stati estratti i sorgenti:{{{ mkdir sorgenti/build |
Linea 46: | Linea 72: |
0. Compilare i sorgenti digitando nel [[AmministrazioneSistema/RigaDiComando|terminale]] il seguente comando:{{{ | 0. Spostarsi al suo interno:{{{ cd sorgenti/build }}} 0. Compilare i sorgenti digitando:{{{ |
Linea 49: | Linea 78: |
||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%><<Immagine(Icone/Piccole/note.png,,center)>> ||<style="padding:0.5em; border:none;">''Se la generazione del '''makefile''' dovesse interrompersi a causa di una [[AmministrazioneSistema/Pacchetti#Dipendenze|dipendenza]] non presente nel sistema, consultare il paragrafo [[#Installazione_dipendenze|Installazione dipendenze]].''|| ##||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%><<Immagine(Icone/Grandi/info.png,,center)>> ||<style="padding:0.5em; border:none;">Il programma '''Cmake''' è utilizzabile anche tramite interfaccia grafica. Per maggiori informazioni consultare la pagina [[wilecoyote/provawccmakegui|CMake-Gui]]|| |
|
Linea 52: | Linea 79: |
== Installazione dipendenze == | {{{#!wiki note Se la generazione del '''makefile''' dovesse interrompersi a causa di una [[AmministrazioneSistema/Pacchetti#Dipendenze|dipendenza]] non presente nel sistema, consultare questo [[#Installazione_dipendenze|paragrafo]]. }}} |
Linea 54: | Linea 83: |
Se la creazione del '''makefile''' si interrompe a causa di una dipendenza mancante, verrà generato un messaggio d'errore che ne riporta il nome. Sarà dunque necessario installarla manualmente come spiegato di seguito: 0. Avviare il [[AmministrazioneSistema/InstallareProgrammi/GestorePacchetti|gestore pacchetti]] 0. [[AmministrazioneSistema/InstallareProgrammi/GestorePacchetti#Cercare_un_pacchetto|Cercare]] il nome del pacchetto, solitamente una libreria con suffisso `-dev`. |
=== Accorgimenti === * '''CMake''' mette a disposizione l'opzione `--install-prefix directory` che permette di scegliere in quale directory allocare il programma che si va compilando. Nell'uso più frequente di questa opzione il comando diventa:{{{ cmake --install-prefix /usr }}} * Per ottenere un elenco delle ulteriori opzioni messe a disposizione dal programma '''CMake''' digitare l'opzione `-h` o `--help` oppure consultare i file `INSTALL` o `README` forniti con il sorgente. = Installazione dipendenze = Se la creazione del '''makefile''' si interrompe a causa di una dipendenza mancante, verrà generato un messaggio di errore che riporta le dipendenze mancanti. Sarà dunque necessario installarle manualmente, differenziando tra il caso in cui il nome del pacchetto non è individuabile e si dispone solo del nome del file e il caso in cui il nome del pacchetto è individuabile. == Con il nome del file == 0. Installare il pacchetto [[apt://apt-file|apt-file]] digitando nel terminale [[AmministrazioneSistema/Terminale|terminale]]:{{{ sudo apt install apt-file }}} 0. Creare il database con il comando:{{{ sudo apt-file update }}}Il comando può richiedere del tempo per terminare. 0. Cercare adesso il pacchetto ignoto con il comando:{{{ sudo apt-file search <nomefile> }}}Il pacchetto richiesto è quello che fornisce il file con il nome esatto. Per installare il suddetto pacchetto seguire la procedura successiva. == Con nome del pacchetto == 0. Avviare il [[AmministrazioneSistema/InstallareProgrammi/GestorePacchetti|gestore pacchetti]]. 0. [[AmministrazioneSistema/InstallareProgrammi/GestorePacchetti#Cercare_un_pacchetto|Cercare]] il nome del pacchetto (solitamente una libreria con suffisso `-dev`). |
Linea 58: | Linea 111: |
||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%><<Immagine(Icone/Piccole/note.png,,center)>> ||<style="padding:0.5em; border:none;">''Se sono presenti più versioni dello stesso pacchetto, installare quella del [[Repository |repository]] main.'' || 0. Riavviare la generazione del '''makefile''' mediante lo [[#Script_di_configurazione|script di configurazione]] o il programma [[#Cmake|Cmake]]. |
{{{#!wiki note Se sono presenti più versioni dello stesso pacchetto, installare quella del [[Repository |repository]] main.<<BR>> Nel caso il file richiesto sia fornito da due o più pacchetti selezionare quello con «-dev» nel nome. }}} 0. Riavviare la generazione del '''makefile''' mediante lo [[#Script_di_configurazione|script di configurazione]] o il programma [[#cmake|Cmake]]. |
Linea 64: | Linea 120: |
Dgitare nel [[AmministrazioneSistema/RigaDiComando|terminale]] il seguente comando:{{{ | Digitare nel [[AmministrazioneSistema/Terminale|terminale]] il seguente comando:{{{ |
Linea 70: | Linea 126: |
0. Digitare nel [[AmministrazioneSistema/RigaDiComando|terminale]] il seguente comando:{{{ | 0. Digitare nel [[AmministrazioneSistema/Terminale|terminale]] il seguente comando:{{{ |
Linea 74: | Linea 130: |
0. Una volta installato il programma, è possibile rimuovere i file compilati dalla cartella dei sorgenti digitando nel [[AmministrazioneSistema/RigaDiComando|terminale]] il seguente comando:{{{ make clean |
0. Una volta installato il programma, è possibile rimuovere i file compilati dalla cartella dei sorgenti digitando nel [[AmministrazioneSistema/Terminale|terminale]] il seguente comando:{{{ sudo make clean |
Linea 78: | Linea 134: |
||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%><<Immagine(Icone/Piccole/note.png,,center)>> ||<style="padding:0.5em; border:none;">''Non eliminare la cartella dei sorgenti né il suo contenuto, in quanto necessari per poter disinstallare il programma come spiegato nel paragrafo [[#Disinstallazione|Disinstallazione]]. In alternativa è possibile eseguire l'installazione servendosi di [[Programmazione/Checkinstall|CheckInstall]], il quale permette una differente e più semplice disinstallazione.''|| | {{{#!wiki note Non eliminare la cartella dei sorgenti né il suo contenuto, in quanto necessari per poter disinstallare il programma come spiegato nel paragrafo [[#Disinstallazione|Disinstallazione]]. In alternativa, è possibile eseguire l'installazione servendosi di [[Programmazione/Checkinstall|CheckInstall]], il quale permette una differente e più semplice disinstallazione.}}} |
Linea 80: | Linea 137: |
= Disinstallazione = | = Rimozione = |
Linea 82: | Linea 139: |
* Digitare nel [[AmministrazioneSistema/RigaDiComando|terminale]] il seguente comando:{{{ | {{{#!wiki note Questo metodo di disinstallazione è utilizzabile solo se il '''Makefile''' mette a disposizione la relativa opzione '''uninstall'''. }}} Digitare nel [[AmministrazioneSistema/Terminale|terminale]] il seguente comando:{{{ |
Linea 86: | Linea 147: |
||<tablestyle="text-align: justify; width:100%; " style="border:none;" 5%><<Immagine(Icone/Piccole/note.png,,center)>> ||<style="padding:0.5em; border:none;">''Questo metodo di disinstallazione è utilizzabile solo se il '''Makefile''' mette a disposizione la relativa opzione '''uninstall'''.'' || |
Guida verificata con Ubuntu: 20.04 22.04 24.04
Problemi in questa pagina? Segnalali in questa discussione
Introduzione
Una peculiarità dei programmi open source è il fatto che viene sempre reso disponibile il codice sorgente, scaricabile sotto forma di archivio compresso con estensione .tar.gz, .tar.bz2, .tar.xz, o .zip. Tale archivio contiene file di testo scritti in un linguaggio di programmazione, detti file sorgente, e altri eventuali file necessari al programma.
Per poter utilizzare un programma ottenuto in questa forma è necessario tradurre i file sorgente in file binari, cioè file comprensibili ed eseguibili da un computer. Questa operazione è detta compilazione e si basa sulle istruzioni contenute nel makefile. Completata la compilazione è possibile eseguire l'effettiva installazione del programma, ovvero la copia dei file nella corretta posizione all'interno del file system.
La seguente guida cerca di gettare delle linee guida sulla compilazione illustrando concetti e pratiche di base, tuttavia è opportuno ricordare che da programma a programma il metodo utilizzato può variare sensibilmente. Di solito chi ha creato un programma allega sotto forma di file INSTALL, README, readme.md le istruzioni da eseguire per arrivare a una corretta compilazione dei sorgenti.
Pertanto la prima regola da seguire è leggere la documentazione allegata.
Preparativi
Installare il pacchetto build-essential.
Per programmi basati su KDE o Qt, installare il pacchetto cmake.Estrarre il pacchetto dei sorgenti nella propria Home.
Per semplicità consideriamo che i sorgenti siano all'interno della cartella sorgenti all'interno della propria Home.
Più in generale per mantenere ordinata la propria Home è consigliabile creare una sottocartella specifica per le compilazioni.
Generazione del makefile
Il makefile è un file il cui contenuto dipende dalla configurazione del sistema in cui si intende installare il programma. Proprio per questo motivo, tale file non può essere distribuito insieme ai sorgenti ma va generato direttamente sul sistema di destinazione.
Di seguito sono descritti, in linea generale, i due metodi più comuni per generare il makefile, ovvero mediante lo scritp di configurazione o del programma Cmake. Attenersi alle istruzioni specifiche per ogni programma, di solito contenute in file di testo allegati e/o distribuiti insieme ai sorgenti, denominati INSTALL, README, readme.md o altri nomi simili.
Script di configurazione
Aprire il terminale e spostarsi nella cartella in cui sono stati estratti i sorgenti digitando il seguente comando:
cd sorgenti
Dare i permessi di esecuzione allo script di configurazione digitando il seguente comando:
chmod +x configure
Se il file avesse un nome differente, ad esempio configure.sh, ripetere il comando col nome corretto.
Avviare lo script di configurazione digitando il seguente comando:
./configure
Se la generazione del makefile dovesse interrompersi a causa di una dipendenza non presente nel sistema, consultare il paragrafo Installazione dipendenze.
Accorgimenti
Spesso per migliorare la compressione dell'archivio compresso contenente il codice sorgente, lo script di configurazione configure e il file Makefile vanno creati eseguendo prima lo script autogen.sh con il comando:
./autogen.sh
Quasi sempre lo script di configurazione mette a disposizione l'opzione --prefix=path che permette di scegliere in quale directory allocare il programma che si va compilando. Nell'uso più frequente di questa opzione il comando diventa:
./configure --prefix=/usr
Per ottenere un elenco delle ulteriori opzioni messe a disposizione dallo script digitare l'opzione -h oppure consultare i file INSTALL o README forniti con il sorgente.
Cmake
Per programmi basati su KDE o Qt la generazione del makefile è generalmente affidata al programma CMake.
Il programma CMake è utilizzabile anche tramite interfaccia grafica. Per maggiori informazioni consultare la pagina CMakeGui.
Creare la cartella build nella cartella in cui sono stati estratti i sorgenti:
mkdir sorgenti/build
Spostarsi al suo interno:
cd sorgenti/build
Compilare i sorgenti digitando:
cmake ..
Se la generazione del makefile dovesse interrompersi a causa di una dipendenza non presente nel sistema, consultare questo paragrafo.
Accorgimenti
CMake mette a disposizione l'opzione --install-prefix directory che permette di scegliere in quale directory allocare il programma che si va compilando. Nell'uso più frequente di questa opzione il comando diventa:
cmake --install-prefix /usr
Per ottenere un elenco delle ulteriori opzioni messe a disposizione dal programma CMake digitare l'opzione -h o --help oppure consultare i file INSTALL o README forniti con il sorgente.
Installazione dipendenze
Se la creazione del makefile si interrompe a causa di una dipendenza mancante, verrà generato un messaggio di errore che riporta le dipendenze mancanti. Sarà dunque necessario installarle manualmente, differenziando tra il caso in cui il nome del pacchetto non è individuabile e si dispone solo del nome del file e il caso in cui il nome del pacchetto è individuabile.
Con il nome del file
Installare il pacchetto apt-file digitando nel terminale terminale:
sudo apt install apt-file
Creare il database con il comando:
sudo apt-file update
Il comando può richiedere del tempo per terminare.Cercare adesso il pacchetto ignoto con il comando:
sudo apt-file search <nomefile>
Il pacchetto richiesto è quello che fornisce il file con il nome esatto. Per installare il suddetto pacchetto seguire la procedura successiva.
Con nome del pacchetto
Avviare il gestore pacchetti.
Cercare il nome del pacchetto (solitamente una libreria con suffisso -dev).
Installare il pacchetto.
Se sono presenti più versioni dello stesso pacchetto, installare quella del repository main.
Nel caso il file richiesto sia fornito da due o più pacchetti selezionare quello con «-dev» nel nome.Riavviare la generazione del makefile mediante lo script di configurazione o il programma Cmake.
Sarà necessario ripetere questa procedura ogni volta che la generazione del makefile viene interrotta da una dipendenza mancante.
Compilazione
Digitare nel terminale il seguente comando:
make
Installazione
Digitare nel terminale il seguente comando:
sudo make install
Una volta installato il programma, è possibile rimuovere i file compilati dalla cartella dei sorgenti digitando nel terminale il seguente comando:
sudo make clean
Non eliminare la cartella dei sorgenti né il suo contenuto, in quanto necessari per poter disinstallare il programma come spiegato nel paragrafo Disinstallazione. In alternativa, è possibile eseguire l'installazione servendosi di CheckInstall, il quale permette una differente e più semplice disinstallazione.
Rimozione
Questo metodo di disinstallazione è utilizzabile solo se il Makefile mette a disposizione la relativa opzione uninstall.
Digitare nel terminale il seguente comando:
sudo make uninstall