Opzioni¶
-C <initial-cache>
Pre-caricare uno script per popolare la cache.
Quando cmake viene eseguito per la prima volta in un albero di build vuoto, crea aCMakeCache.file txt e lo popola con impostazioni personalizzabili per il progetto. Questa opzione può essere utilizzata per specificare un file da cui caricare le voci della cache prima del primo passaggio attraverso i file di elenco del progetto. Le voci caricate hanno la priorità sui valori predefiniti del progetto. Il file specificato dovrebbe essere un CMAKE scriptcontaining SET comandi che utilizzano l’opzione CACHE, non il file in formato acache.
-D <var>:<type>=<value>
Crea una voce della cache cmake.
Quando cmake viene eseguito per la prima volta in un albero di build vuoto, crea aCMakeCache.file txt e lo popola con impostazioni personalizzabili per il progetto. Questa opzione può essere utilizzata per specificare un’impostazione cheprende priorità sul valore predefinito del progetto. L’opzione può essere riprodotta per tutte le voci della cache desiderate.
-U <globbing_expr>
Rimuovi le voci corrispondenti dalla cache CMake.
Questa opzione può essere utilizzata per rimuovere una o più variabili dal Makecache.file txt, espressioni globbing utilizzando * e ? sono supportati. L’opzione può essere ripetuta per tutte le voci della cache asdesired.
Utilizzare con cura, è possibile rendere il vostro CMakeCache.txt non funzionante.
-G <generator-name>
Specificare un generatore di sistema di compilazione.
CMake può supportare più sistemi di compilazione nativi su certainplatforms. Un generatore è responsabile della generazione di un particolaresistema di costruzione. I possibili nomi dei generatori sono specificati nella sezione Generators.
-T <toolset-name>
Specificare il nome del set di strumenti se supportato da generator.
Alcuni generatori CMake supportano un nome di set di strumenti da assegnare al sistema di compilazione di thenative per scegliere un compilatore. Questo è supportato solo su generatori specifici:
Visual Studio >= 10Xcode >= 3.0
Vedere la documentazione del sistema di compilazione nativo per i nomi di set di strumenti consentiti.
-A <platform-name>
Specificare il nome della piattaforma se supportato da generator.
Alcuni generatori CMake supportano un nome di piattaforma da assegnare al sistema di compilazione di thenative per scegliere un compilatore o SDK. Questo è supportato solo su generatori specifici:
Visual Studio >= 8
Vedere la documentazione del sistema di compilazione nativo per i nomi delle piattaforme consentiti.
-Wno-dev
Elimina gli avvisi degli sviluppatori.
Elimina gli avvisi destinati all’autore di theCMakeLists.file txt.
-Wdev
Abilita avvisi per sviluppatori.
Abilita gli avvisi destinati all’autore di CMakeLists.file txt.
-E
CMake modalità comando.
Per una vera indipendenza dalla piattaforma, CMake fornisce un elenco di comandi che possono essere utilizzati su tutti i sistemi. Esegui con-E help per l’usageinformation. I comandi disponibili sono: chdir, compare_files, copia, copy_directory, copy_if_different, eco, echo_append, env, ambiente, make_directory, md5sum, rimuovere, remove_directory, rinominare, sonno, tar,tempo, toccare, touch_nocreate. Inoltre, alcuni comandi specifici della piattaforma sono disponibili. Su Windows: delete_regv, write_regv. SuUNIX: crea il link_simile.
-L
Elenca le variabili memorizzate nella cache non avanzate.
List cache variables eseguirà CMake ed elencherà tutte le variabili dalla cache CMake che non sono contrassegnate come INTERNE o AVANZATE. Questo visualizzerà efficacemente le impostazioni CMake correnti,che possono quindi essere modificate con l’opzione-D. La modifica di alcune variabili può comportare la creazione di più variabili. Se viene specificato A, lo faràmostra anche variabili avanzate. Se H è specificato, sarà anchedisplay aiuto per ogni variabile.
--build <dir>
Crea un albero binario del progetto generato da CMake.
Questo astrae l’interfaccia a riga di comando di uno strumento di compilazione nativo con le seguenti opzioni:
<dir> = Project binary directory to be built.--target <tgt> = Build <tgt> instead of default targets.--config <cfg> = For multi-configuration tools, choose <cfg>.--clean-first = Build target 'clean' first, then build. (To clean only, use --target 'clean'.)--use-stderr = Ignored. Behavior is default in CMake >= 3.0.-- = Pass remaining options to the native tool.
Esegui cmake-build senza opzioni per un aiuto rapido.
-N
Solo modalità di visualizzazione.
Carica solo la cache. In realtà non eseguire configure e generatesteps.
-P <file>
Modalità script di processo.
Elabora il file cmake dato come script scritto in CMakelanguage. Non viene eseguita alcuna fase di configurazione o generazione e la cache non viene modificata. Se le variabili sono definite usando-D, questo deve essereuno prima dell’argomento-P.
--find-package
Esegui in modalità simile a pkg-config.
Cerca un pacchetto usando find_package () e stampa i flagsto stdout risultanti. Questo può essere usato per usare cmake invece di pkg-config per trovare le librerie installate in semplici progetti basati su Makefile o progetti basati su inautoconf (tramite share/aclocal/cmake.m4).
--graphviz=
Genera graphviz delle dipendenze, vedi CMakeGraphVizOptions.cmake per più.
Genera un file di input graphviz che conterrà tutta la libreria e le dipendenze eseguibili nel progetto. Vedere la documentazione per Makegraphvizoptions.cmake per maggiori dettagli.
--system-information
Scarica le informazioni su questo sistema.
Scarica una vasta gamma di informazioni sul sistema corrente. Se eseguito dalla parte superiore di un albero binario per un progetto CMake, scaricherà ulteriori informazioni come la cache, i file di registro ecc.
--debug-trycompile
Non eliminare l’albero di compilazione try_compile. Utile solo su un try_compile alla volta.
Non eliminare i file e le directory create per try_compilecalls. Questo è utile nel debug di try_compiles non riuscito. Può tuttavia modificare i risultati delle try-compiles come vecchio junk da un precedente try-compile può causare un test diverso per passare orfail in modo errato. Questa opzione è utilizzata al meglio per una prova-compilazione alla volta e solo durante il debug.
--debug-output
Metti cmake in una modalità di debug.
Stampa materiale extra durante l’esecuzione di cmake come tracce di stack con chiamate message(send_error).
--trace
Metti cmake in modalità traccia.
Stampa una traccia di tutte le chiamate effettuate e da dove le chiamate withmessage(send_error).
--warn-uninitialized
Avvisa sui valori non inizializzati.
Stampa un avviso quando viene utilizzata una variabile non inizializzata.
--warn-unused-vars
Avvisa sulle variabili non utilizzate.
Trova le variabili dichiarate o impostate, ma non utilizzate.
--no-warn-unused-cli
Non avvisare delle opzioni della riga di comando.
Non trovare le variabili dichiarate sulla riga di comando, ma notused.
--check-system-vars
Trova problemi con l’utilizzo delle variabili nei file di sistema.
Normalmente, le variabili non utilizzate e non inizializzate vengono ricercate solo in CMAKE_SOURCE_DIR e CMAKE_BINARY_DIR. Questo flag dice a CMake di imparare anche su altri file.
--help,-help,-usage,-h,-H,/?
Stampa le informazioni sull’utilizzo ed esci.
Utilizzo descrive l’interfaccia della riga di comando di base e le sue opzioni.
--version,-version,/V
Mostra il banner nome/versione del programma ed esci.
Se viene specificato un file, la versione viene scritta in esso.L’aiuto viene stampato su un nome <f>le se fornito.
--help-full
Stampa tutti i manuali di aiuto ed esci.
Tutti i manuali sono stampati in un formato di testo leggibile dall’uomo.L’aiuto viene stampato su un nome <f>le se fornito.
--help-manual <man>
Stampa un manuale di aiuto ed esci.
Il manuale specificato viene stampato in un formato di testo leggibile dall’uomo.L’aiuto viene stampato su un nome <f>le se fornito.
--help-manual-list
Elenca i manuali di aiuto disponibili ed esci.
L’elenco contiene tutti i manuali per i quali è possibile ottenere l’aiuto utilizzando l’opzione --help-manual seguita da un nome manuale.L’aiuto viene stampato su un nome <f>le se fornito.
--help-command <cmd>
Stampa la guida per un comando ed esci.
La voce manuale cmake-commands(7) per <cmd> è stampata in un formato di testo leggibile dall’uomo.L’aiuto viene stampato su un nome <f>le se fornito.
--help-command-list
Elenca i comandi con la guida disponibile ed esci.
L’elenco contiene tutti i comandi per i quali è possibile ottenere aiuto utilizzando l’opzione --help-command seguita da un nome di comando.L’aiuto viene stampato su un nome <f>le se fornito.
--help-commands
Stampa cmake-comandi manuale ed esci.
Il manuale cmake-commands(7) è stampato in un formato di testo leggibile dall’uomo.L’aiuto viene stampato su un nome <f>le se fornito.
--help-module <mod>
Stampa la guida per un modulo ed esci.
La voce manuale cmake-modules(7) per <mod> viene stampata in un formato di testo leggibile dall’uomo.L’aiuto viene stampato su un nome <f>le se fornito.
--help-module-list
Elenca i moduli con l’aiuto disponibile ed esci.
L’elenco contiene tutti i moduli per i quali è possibile ottenere l’aiuto utilizzando l’opzione --help-module seguita da un nome modulo.L’aiuto viene stampato su un nome <f>le se fornito.
--help-modules
Stampa manuale cmake-modules ed esci.
Il manuale cmake-modules(7) viene stampato in un formato human-readabletext.L’aiuto viene stampato su un nome <f>le se fornito.
--help-policy <cmp>
Stampa la guida per un criterio ed esci.
La voce manuale cmake-policies(7) per <cmp> è stampata in un formato di testo leggibile dall’uomo.L’aiuto viene stampato su un nome <f>le se fornito.
--help-policy-list
Elenca le politiche con l’aiuto disponibile ed esci.
L’elenco contiene tutti i criteri per i quali è possibile ottenere l’aiuto utilizzando l’opzione --help-policy seguita da un nome di criterio.L’aiuto viene stampato su un nome <f>le se fornito.
--help-policies
Stampa manuale cmake-policies ed esci.
Il manuale cmake-policies(7) è stampato in un formato di testo leggibile dall’uomo.L’aiuto viene stampato su un nome <f>le se fornito.
--help-property <prop>
Stampa la guida per una proprietà ed esci.
Le voci manuali cmake-properties(7) per <prop> sono stampate in un formato di testo leggibile dall’uomo.L’aiuto viene stampato su un nome <f>le se fornito.
--help-property-list
Elenca le proprietà con la guida disponibile ed esci.
L’elenco contiene tutte le proprietà per le quali è possibile ottenere la guida utilizzando l’opzione --help-property seguita da un nome di proprietà.L’aiuto viene stampato su un nome <f>le se fornito.
--help-properties
Stampa cmake-properties manual ed esci.
Il manuale cmake-properties(7) è stampato in un formato di testo leggibile dall’uomo.L’aiuto viene stampato su un nome <f>le se fornito.
--help-variable <var>
Stampa la guida per una variabile ed esci.
La voce manuale cmake-variables(7) per <var> è stampata in un formato di testo leggibile dall’uomo.L’aiuto viene stampato su un nome <f>le se fornito.
--help-variable-list
Elenca le variabili con l’aiuto disponibile ed esci.
L’elenco contiene tutte le variabili per le quali è possibile ottenere l’aiuto utilizzando l’opzione --help-variable seguita da un nome di variabile.L’aiuto viene stampato su un nome <f>le se fornito.
--help-variables
Stampa cmake-variabili manuale ed exit.
Il manuale cmake-variables(7) è stampato in un formato di testo leggibile dall’uomo.L’aiuto viene stampato su un nome <f>le se fornito.