Dimensione: 7603
Commento: corretta Category
|
← Versione 29 del 04/01/2025 19.53.30 ⇥
Dimensione: 8489
Commento: Paragrafi "accorgimenti"
|
Le cancellazioni sono segnalate in questo modo. | Le aggiunte sono segnalate in questo modo. |
Linea 2: | Linea 2: |
#format wiki #LANGUAGE it |
|
Linea 4: | Linea 6: |
<<Informazioni(forum=''http://forum.ubuntu-it.org/viewtopic.php?f=46&t=614798; rilasci="18.04 16.04 14.04")>> | <<Informazioni(forum=''http://forum.ubuntu-it.org/viewtopic.php?f=46&t=614798; rilasci="24.04 22.04 20.04 18.04")>> |
Linea 8: | Linea 10: |
Il programma '''[[https://it.wikipedia.org/wiki/CMake|CMake]]''' può essere usato tramite due diverse [[https://it.wikipedia.org/wiki/Interfaccia_grafica |interfacce]], ''cmake-qt-gui'' e ''cmake-curses-gui'', basate rispettivamente sulle librerie '''[[https://it.wikipedia.org/wiki/Qt_(toolkit)|Qt]]''' e '''[[https://en.wikipedia.org/wiki/Curses_(programming_library)|curses]]'''. | In questa guida viene descritta l'applicazione '''[[https://it.wikipedia.org/wiki/CMake|CMake]]'''. È usata per il processo di precompilazione del sorgente di un programma basato sulle librerie '''[[https://it.wikipedia.org/wiki/Qt_(toolkit)|Qt]]''', tramite dei semplici file di configurazione indipendenti dal compilatore e dal sistema. L'applicazione può essere usata tramite due diverse [[https://it.wikipedia.org/wiki/Interfaccia_grafica |interfacce]], ''cmake-qt-gui'' e ''cmake-curses-gui'', basate rispettivamente sulle librerie '''[[https://it.wikipedia.org/wiki/Qt_(toolkit)|Qt]]''' e '''[[https://en.wikipedia.org/wiki/Curses_(programming_library)|curses]]'''. |
Linea 13: | Linea 17: |
* [[apt://cmake-qt-gui|cmake-qt-gui]]: versione basata sulla libreria '''Qt''' per ambienti desktop come '''[[https://it.wikipedia.org/wiki/KDE|KDE]]''' o '''[[https://en.wikipedia.org/wiki/LXQt|LXQt]]'''; * [[apt://cmake-curses-gui|cmake-curses-gui]]: versione basata sulla libreria '''Curses''' per uso nel [[AmministrazioneSistema/Terminale|terminale]]. |
* [[apt://cmake-qt-gui|cmake-qt-gui]]: versione basata sulla libreria '''Qt''' per gli ambienti desktop '''[[AmbienteGrafico/Kde|KDE]]''' e '''[[AmbienteGrafico/Lxqt|LXQt]]'''; * [[apt://cmake-curses-gui|cmake-curses-gui]]: versione basata sulla libreria '''Curses''' per uso tramite [[AmministrazioneSistema/Terminale|terminale]] negli altri '''[[AmbienteGrafico|ambienti grafici]]'''. |
Linea 16: | Linea 20: |
||<tablestyle="text-align:justify; width:100%;" style="border:none;" 5%>{{attachment:Icone/Grandi/info.png}} ||<style="border:none;">Per mantenere ordinata la propria `Home` si raccomanda di creare una cartella specifica per le compilazioni.<<BR>> Quanto segue richiede che sia già presente un file `CMakeLists.txt` nella cartella del programma, genericamente denominata `NomeProgramma`. || | Nel caso si precompili applicazioni specifiche dell'ambiente grafico '''KDE''', si consiglia di installare il pacchetto [[apt://extra-cmake-modules|extra-cmake-modules]]. {{{#!wiki tip Per mantenere ordinata la propria `Home` si raccomanda di creare una cartella specifica per le compilazioni.<<BR>> Quanto segue richiede che sia presente un file `CMakeLists.txt` nella cartella col sorgente del programma, genericamente denominata `NomeProgramma`.}}} |
Linea 23: | Linea 31: |
0. Cliccare sulla cartella `NomeProgramma`. 0. Cliccare sul file `CMakeLists.txt`. ||<tablestyle="text-align:justify; width:100%;" style="border:none;" 5%>{{attachment:Icone/Grandi/info.png}} ||<style="border:none;">La prima volta che si clicca su un file `CMakeLists.txt` non si avvierà automaticamente il programma '''cmake-gui-qt''': per risolvere è necessario cliccare il pulsante destro del mouse sul file e selezionare '''''Apri con → Altro...''''', digitare nella barra di ricerca della finestra '''cmake-gui''', mettere la spunta su '''Ricorda l'associazione dell'applicazione per tutti i file di tipo <Codice sorgente CMake> (text/x-cmake)''' e cliccare '''OK'''.|| 0. Nella finestra del programma fare clic su '''Browse Source...''' 0. Selezionare il percorso alla cartella `NomeProgramma`. 0. Cliccare su '''OK''' per confermare. |
0. Aprire la cartella `NomeProgramma` e fare clic sul file `CMakeLists.txt`. Talvolta il file `CMakeLists.txt` si trova in una sottocartella il più delle volte di nome `src`. {{{#!wiki tip La prima volta che si clicca su un file `CMakeLists.txt` il programma '''cmake-gui-qt''' non si avvierà automaticamente. Per risolvere è necessario fare clic col pulsante destro del mouse sul file e selezionare '''''Apri con → Altro...''''', digitare nella barra di ricerca della finestra '''cmake-gui''', mettere la spunta su '''Ricorda l'associazione dell'applicazione per tutti i file di tipo <Codice sorgente CMake> (text/x-cmake)''' e fare clic su '''OK'''.}}} 0. Nella finestra dell'applicazione fare clic su '''Browse Source...''' 0. Selezionare il percorso alla cartella `NomeProgramma`. Talvolta il file `CMakeLists.txt` si trova in una sottocartella il più delle volte di nome `src`. 0. Fare clic su '''OK''' per confermare. |
Linea 30: | Linea 40: |
0. Selezionare il percorso alla cartella `NomeProgramma`. 0. Cliccare su '''New Folder''' e digitare come nome '''build'''. 0. Cliccare su '''OK''' per confermare. 0. Cliccare su '''OK''' per confermare. 0. Cliccare su '''Configure'''. 0. Nella finestra apparsa confermare come generatore '''Use default native compilers''' e cliccare su '''Fine'''. 0. Se nella finestra in basso appare '''Configuring done''' l'esecuzione è completata. 0. Se nella finestra in basso appare '''Configuring error''' il programma necessita di una [[AmministrazioneSistema/Pacchetti#Dipendenze|dipendenza]] non presente nel sistema, in tale frangente consultare il paragrafo [[#Richiesta_dipendenza|Richiesta dipendenza]]. |
0. Selezionare il percorso alla cartella `NomeProgramma` come sopra. 0. Fare clic su '''New Folder''' e digitare come nome '''build'''. 0. Fare clic su '''OK''' per confermare. 0. Fare clic su '''OK''' per confermare. |
Linea 39: | Linea 45: |
||<tablestyle="text-align:justify; width:100%;" style="border:none;" 5%>{{attachment:Icone/Grandi/info.png}} ||<style="border:none;">Se si desidera creare la pagina aiuto per l'ambiente '''KDE''', cercare nella finestra in alto con sfondo rosso la stringa '''KDE*_ENABLE_HTMLHANDBOOK''' e mettere la spunta, il '''*''' può essere uguale a 4 o 5 in funzione di quale versione di '''KDE''' si usa.|| | <<Anchor(compila)>> == Precompilazione == |
Linea 41: | Linea 48: |
||<tablestyle="text-align:justify; width:100%;" style="border:none;" 5%>{{attachment:Icone/Grandi/info.png}} ||<style="border:none;">Per modificare l'allocazione predefinita da `/usr/local` a `/usr` (non tutti i programmi funzionano se installati in `/usr/local`), cliccare sulla stringa '''CMAKE_INSTALL_PREFIX''', modificare il percorso e ricliccare.|| | 0. Fare clic su '''Configure'''. 0. Nella finestra apparsa confermare come generatore '''Use default native compilers''' e fare clic su '''Fine'''. 0. Se nella finestra in basso appare '''Configuring done''' la precompilazione è completata. 0. Se nella finestra in basso appare '''Configuring error''' la precompilazione necessita di una o più [[AmministrazioneSistema/Pacchetti#Dipendenze|dipendenze]] non presenti nel sistema. In tal caso consultare il paragrafo [[#Richiesta_dipendenza|Richiesta dipendenza]]. |
Linea 43: | Linea 53: |
||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%>{{attachment:Icone/Piccole/note.png}} ||<style="border:none;">''Le opzioni di configurazione per le ulteriori stringhe sono contenute in un file di testo, solitamente chiamato `INSTALL` o `README`, distribuito insieme ai sorgenti.'' || | === Accorgimenti === * Per creare la pagina documentazione d'aiuto per l'ambiente grafico '''KDE''', cercare nella finestra in alto con sfondo rosso la stringa '''KDE*_ENABLE_HTMLHANDBOOK''' e mettere la spunta. L'asterisco ''*'' rappresenta il numero di versione '''5''' o '''6''' di '''KDE'''. * Per modificare la directory predefinita`/usr/local` in cui allocare il programma che si va compilando: 0. cercare nella finestra in alto con sfondo rosso la stringa '''CMAKE_INSTALL_PREFIX'''. 0. Fare clic sul percorso predefinito e modificare in`/usr`. * Per le opzioni di configurazione relative alle altre stringhe consultare i file `INSTALL` o `README` forniti con il sorgente. |
Linea 47: | Linea 63: |
Se sono stati modificati dei parametri nelle stringhe prima premere su '''Configure''', altrimenti premere direttamente su '''Generate'''. Terminata la generazione chiudere il programma. | Se sono stati modificati dei parametri nelle stringhe con sfondo rosso, prima fare clic su '''Configure''', altrimenti fare clic direttamente su '''Generate'''. Terminata la generazione chiudere l'applicazione. |
Linea 57: | Linea 73: |
0. Premere '''c''' per configurare, se l'esecuzione è completata viene mostrata la lista delle stringhe di configurazione; se viene mostrata la mancanza di una dipendenza da soddisfare cliccare prima su '''e''' e dopo su '''q''' per chiudere il programma. 0. Se il programma necessita di una [[AmministrazioneSistema/Pacchetti#Dipendenze|dipendenza]] non presente nel sistema, in tale frangente consultare il paragrafo [[#Richiesta_dipendenza|Richiesta dipendenza]]. |
|
Linea 60: | Linea 74: |
||<tablestyle="text-align:justify; width:100%;" style="border:none;" 5%>{{attachment:Icone/Grandi/info.png}} ||<style="border:none;">Per modificare l'allocazione predefinita in `/usr/local`, posizionare il cursore con i tasti ''freccia'' sulla stringa '''CMAKE_INSTALL_PREFIX */usr/local''', premere '''Invio''' e digitare `/usr`.|| | == Precompilazione == |
Linea 62: | Linea 76: |
||<tablestyle="text-align:justify; width:100%;" style="border:none;" 5%>{{attachment:Icone/Grandi/info.png}} ||<style="border:none;">Per creare la pagina aiuto, posizionare il cursore con i tasti ''freccia'' sulla stringa '''KDE+_ENABLE_HTMLHANDBOOK *OFF''', premere '''Invio''' per commutare a '''ON''', il '''+''' può essere uguale a 4 o 5 in funzione di quale versione di '''KDE''' si usa.|| | 0. Premere '''c''' per configurare. Se la precompilazione è completata viene mostrata la lista delle stringhe di configurazione; se viene mostrata la mancanza di una dipendenza da soddisfare fare clic su '''e''' e dopo su '''q''' per chiudere l'applicazione. 0. Se il programma necessita di una [[AmministrazioneSistema/Pacchetti#Dipendenze|dipendenza]] non presente nel sistema, consultare il paragrafo [[#Richiesta_dipendenza|Richiesta dipendenza]]. |
Linea 64: | Linea 79: |
||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%>{{attachment:Icone/Piccole/note.png}} ||<style="border:none;">''Le opzioni di configurazione per le ulteriori stringhe sono contenute in un file di testo, solitamente chiamato `INSTALL` o `README`, distribuito insieme ai sorgenti.'' || | === Accorgimenti === * Per creare la pagina documentazione d'aiuto per l'ambiente grafivo '''KDE''': 0. posizionare il cursore con i tasti ''freccia'' sulla stringa '''KDE*_ENABLE_HTMLHANDBOOK * OFF''', dove l'asterisco '''*''' è la versione '''5''' o '''6''' di '''KDE'''. 0. Premere '''Invio''' per commutare a '''ON'''. * Per modificare la directory predefinita`/usr/local` in cui allocare il programma che si va compilando: 0. posizionare il cursore con i tasti ''freccia'' sulla stringa '''CMAKE_INSTALL_PREFIX */usr/local'''. 0. Premere '''Invio''' e digitare `/usr`. * Per le opzioni di configurazione relative alle altre stringhe consultare i file `INSTALL` o `README` forniti con il sorgente. |
Linea 68: | Linea 91: |
Se sono stati modificati dei parametri nelle stringhe prima cliccare su '''c''', altrimenti cliccare direttamente su '''g'''. Terminata la generazione il programma si chiuderà. | Se sono stati modificati dei parametri nelle stringhe prima fare clic su '''c''', altrimenti fare clic direttamente su '''g'''. Terminata la generazione l'applicazione si chiuderà. |
Linea 72: | Linea 95: |
In caso di blocco durante la configurazione appare un messaggio d'errore in cui si potrà leggere il nome della dipendenza mancante. | In caso di blocco durante la configurazione appare un messaggio d'errore in cui si potrà leggere o il nome del file mancante o il nome della dipendenza mancante. |
Linea 74: | Linea 97: |
Per [[AmministrazioneSistema/InstallareProgrammi|installare]] il pacchetto richiesto (dipendenza) si consiglia l'utilizzo di '''[[AmministrazioneSistema/InstallareProgrammi/GestorePacchetti|Synaptic]]'''. Nel caso si tratti di una libreria, il nome del pacchetto richiesto è solitamente seguito dal suffisso ''-dev''. | == File mancante == |
Linea 76: | Linea 99: |
Se sono presenti più versioni selezionare quella del [[Repository |repository]] '''main'''. | Per trovare il nome del pacchetto contenente il file mancante usare il programma '''apt-file'''. Consultare in proposito [[AmministrazioneSistema/InstallareProgrammi/Apt#Altre_operazioni|questa pagina]]. |
Linea 78: | Linea 101: |
Una volta installato il pacchetto richiesto, riavviare il programma '''cmake-gui'''. Sarà necessario ripetere tale operazione ogni volta che lo script o il programma non trova una dipendenza. | Trovato il nome del pacchetto richiesto seguire il prossimo paragrafo per installarlo. |
Linea 80: | Linea 103: |
Per completare la compilazione e l'installazione usare il programma '''[[AmministrazioneSistema/InstallareProgrammi/DaSorgenti#Compilazione|make]]'''. | == Pacchetto mancante == Per [[AmministrazioneSistema/InstallareProgrammi|installare]] il pacchetto richiesto (dipendenza) si consiglia l'utilizzo di un gestore pacchetti (si consiglia in '''Ubuntu''' e nella maggior parte delle derivate '''[[AmministrazioneSistema/InstallareProgrammi/GestorePacchetti|Synaptic]]''', ad esclusione di '''Kubuntu''' e '''Lubuntu''' in cui è preinstallato '''[[AmministrazioneSistema/InstallareProgrammi/GestorePacchettiMuon|Muon]]'''). Il nome del pacchetto richiesto è solitamente seguito dal suffisso ''-dev''. Se sono presenti più versioni selezionare quella del [[Repository/Componenti |repository]] '''main'''. Una volta installato il pacchetto richiesto, svuotare la cache facendo clic sul menù '''''File → Delete cache''''' e ripetere la procedura di [[#compilacompila|precompilazione]]. = Compilazione e pacchettizzazione = 0. Aprire un [[AmministrazioneSistema/Terminale|terminale]]. 0. [[AmministrazioneSistema/ComandiBase#cd|spostarsi]] nella cartella `NomeProgramma/buils`. 0. Per effettuare la [[AmministrazioneSistema/InstallareProgrammi/DaSorgenti#Compilazione|compilazione]] digitare il comando:{{{ make }}} Sarà dunque possibile installare il sorgente compilato. Si consiglia di pacchettizzare quest'ultimo tramite l'applicazione '''[[Programmazione/Checkinstall|Checkinstall]]'''. |
Linea 84: | Linea 124: |
[[https://cmake.org/cmake-tutorial/|Sito ufficiale del Tutorial]] | * [[https://cmake.org/cmake-tutorial/|Sito ufficiale del Tutorial]] |
Guida verificata con Ubuntu: 22.04 24.04
Problemi in questa pagina? Segnalali in questa discussione
Introduzione
In questa guida viene descritta l'applicazione CMake. È usata per il processo di precompilazione del sorgente di un programma basato sulle librerie Qt, tramite dei semplici file di configurazione indipendenti dal compilatore e dal sistema.
L'applicazione può essere usata tramite due diverse interfacce, cmake-qt-gui e cmake-curses-gui, basate rispettivamente sulle librerie Qt e curses.
Installazione
Installare uno dei pacchetti di seguito elencati:
cmake-qt-gui: versione basata sulla libreria Qt per gli ambienti desktop KDE e LXQt;
cmake-curses-gui: versione basata sulla libreria Curses per uso tramite terminale negli altri ambienti grafici.
Nel caso si precompili applicazioni specifiche dell'ambiente grafico KDE, si consiglia di installare il pacchetto extra-cmake-modules.
Per mantenere ordinata la propria Home si raccomanda di creare una cartella specifica per le compilazioni.
Quanto segue richiede che sia presente un file CMakeLists.txt nella cartella col sorgente del programma, genericamente denominata NomeProgramma.
Utilizzo di Cmake-qt-gui
Configurazione
Avviare il file manager.
Aprire la cartella NomeProgramma e fare clic sul file CMakeLists.txt. Talvolta il file CMakeLists.txt si trova in una sottocartella il più delle volte di nome src.
La prima volta che si clicca su un file CMakeLists.txt il programma cmake-gui-qt non si avvierà automaticamente. Per risolvere è necessario fare clic col pulsante destro del mouse sul file e selezionare Apri con → Altro..., digitare nella barra di ricerca della finestra cmake-gui, mettere la spunta su Ricorda l'associazione dell'applicazione per tutti i file di tipo <Codice sorgente CMake> (text/x-cmake) e fare clic su OK.
Nella finestra dell'applicazione fare clic su Browse Source...
Selezionare il percorso alla cartella NomeProgramma. Talvolta il file CMakeLists.txt si trova in una sottocartella il più delle volte di nome src.
Fare clic su OK per confermare.
Fare clic su Browse Build...
Selezionare il percorso alla cartella NomeProgramma come sopra.
Fare clic su New Folder e digitare come nome build.
Fare clic su OK per confermare.
Fare clic su OK per confermare.
Precompilazione
Fare clic su Configure.
Nella finestra apparsa confermare come generatore Use default native compilers e fare clic su Fine.
Se nella finestra in basso appare Configuring done la precompilazione è completata.
Se nella finestra in basso appare Configuring error la precompilazione necessita di una o più dipendenze non presenti nel sistema. In tal caso consultare il paragrafo Richiesta dipendenza.
Accorgimenti
Per creare la pagina documentazione d'aiuto per l'ambiente grafico KDE, cercare nella finestra in alto con sfondo rosso la stringa KDE*_ENABLE_HTMLHANDBOOK e mettere la spunta. L'asterisco * rappresenta il numero di versione 5 o 6 di KDE.
Per modificare la directory predefinita/usr/local in cui allocare il programma che si va compilando:
cercare nella finestra in alto con sfondo rosso la stringa CMAKE_INSTALL_PREFIX.
Fare clic sul percorso predefinito e modificare in/usr.
Per le opzioni di configurazione relative alle altre stringhe consultare i file INSTALL o README forniti con il sorgente.
Generazione
Se sono stati modificati dei parametri nelle stringhe con sfondo rosso, prima fare clic su Configure, altrimenti fare clic direttamente su Generate. Terminata la generazione chiudere l'applicazione.
Utilizzo di Cmake-curses-gui
Configurazione
Precompilazione
Premere c per configurare. Se la precompilazione è completata viene mostrata la lista delle stringhe di configurazione; se viene mostrata la mancanza di una dipendenza da soddisfare fare clic su e e dopo su q per chiudere l'applicazione.
Se il programma necessita di una dipendenza non presente nel sistema, consultare il paragrafo Richiesta dipendenza.
Accorgimenti
Per creare la pagina documentazione d'aiuto per l'ambiente grafivo KDE:
posizionare il cursore con i tasti freccia sulla stringa KDE*_ENABLE_HTMLHANDBOOK * OFF, dove l'asterisco * è la versione 5 o 6 di KDE.
Premere Invio per commutare a ON.
Per modificare la directory predefinita/usr/local in cui allocare il programma che si va compilando:
posizionare il cursore con i tasti freccia sulla stringa CMAKE_INSTALL_PREFIX */usr/local.
Premere Invio e digitare /usr.
Per le opzioni di configurazione relative alle altre stringhe consultare i file INSTALL o README forniti con il sorgente.
Generazione
Se sono stati modificati dei parametri nelle stringhe prima fare clic su c, altrimenti fare clic direttamente su g. Terminata la generazione l'applicazione si chiuderà.
Richiesta dipendenza
In caso di blocco durante la configurazione appare un messaggio d'errore in cui si potrà leggere o il nome del file mancante o il nome della dipendenza mancante.
File mancante
Per trovare il nome del pacchetto contenente il file mancante usare il programma apt-file. Consultare in proposito questa pagina.
Trovato il nome del pacchetto richiesto seguire il prossimo paragrafo per installarlo.
Pacchetto mancante
Per installare il pacchetto richiesto (dipendenza) si consiglia l'utilizzo di un gestore pacchetti (si consiglia in Ubuntu e nella maggior parte delle derivate Synaptic, ad esclusione di Kubuntu e Lubuntu in cui è preinstallato Muon). Il nome del pacchetto richiesto è solitamente seguito dal suffisso -dev.
Se sono presenti più versioni selezionare quella del repository main.
Una volta installato il pacchetto richiesto, svuotare la cache facendo clic sul menù File → Delete cache e ripetere la procedura di precompilazione.
Compilazione e pacchettizzazione
Aprire un terminale.
spostarsi nella cartella NomeProgramma/buils.
Per effettuare la compilazione digitare il comando:
make
Sarà dunque possibile installare il sorgente compilato. Si consiglia di pacchettizzare quest'ultimo tramite l'applicazione Checkinstall.