Alternativer¶
-C <initial-cache>
pre-load et skript for å fylle cache.
når cmake først kjøres i et tomt byggetre, opprettes aCMakeCache.txt-fil og fyller den med tilpassbare innstillinger forprosjektet. Dette alternativet kan brukes til å angi en fil hvorfra du kan laste inn hurtigbufferoppføringer før den første passerer gjennom project ‘ scmake listfiles. De lastede oppføringene prioriteres over theprojects standardverdier. Den gitte filen skal være Et cmake-skriptinneholder SETTKOMMANDOER som bruker CACHE-alternativet, ikke acache-formatfil.
-D <var>:<type>=<value>
Opprett en cmake-hurtigbufferoppføring.
når cmake først kjøres i et tomt byggetre, opprettes aCMakeCache.txt-fil og fyller den med tilpassbare innstillinger forprosjektet. Dette alternativet kan brukes til å angi en innstilling som tar prioritet over prosjektets standardverdi. Alternativet kan berepeated for så mange cache oppføringer som ønsket.
-U <globbing_expr>
Fjern samsvarende oppføringer Fra CMake cache.
Dette alternativet kan brukes til å fjerne en eller flere variabler fra theCMakeCache.txt-fil, globbing uttrykk ved hjelp av * og ? støttet. Alternativet kan gjentas for så mange cacheoppføringer somønsket.
Bruk med forsiktighet, du kan lage Din CMakeCache.txt ikke-fungerende.
-G <generator-name>
Angi en bygge systemgenerator.
CMake kan støtte flere innfødte bygge systemer på certainplatforms. En generator er ansvarlig for å generere en bestemtbyggesystem. Mulige generatornavn er spesifisert igeneratorer delen.
-T <toolset-name>
Angi navn på verktøysett hvis det støttes av generator.
Noen CMake generatorer støtter et verktøysett navn som skal gis til thenative build system for å velge en kompilator. Dette støttes bare på spesifikke generatorer:
Visual Studio >= 10Xcode >= 3.0
Se opprinnelig bygge systemdokumentasjon for tillatte verktøysett navn.
-A <platform-name>
Angi plattformnavn hvis det støttes av generator.
Noen CMake-generatorer støtter et plattformnavn som skal gis til det opprinnelige byggesystemet for å velge en kompilator eller SDK. Dette støttes bare på spesifikke generatorer:
Visual Studio >= 8
Se opprinnelig bygge systemdokumentasjon for tillatte plattformnavn.
-Wno-dev
Undertrykk utvikleradvarsler.
Undertrykke advarsler som er ment for forfatteren av theCMakeLists.txt-filer.
-Wdev
Aktiver utvikleradvarsler.
Aktiver advarsler som er ment for forfatteren Av CMakeLists.txtfiles.
-E
CMake kommandomodus.
For ekte plattform uavhengighet, CMake gir en liste over kommandosom kan brukes på alle systemer. Kjør med-e hjelp for brukinformasjon. Kommandoer tilgjengelig er: chdir, compare_files, kopiere, copy_directory, copy_if_different, echo, echo_append, env, miljø, make_directory, md5sum, fjerne, remove_directory, endre navn, sove, tjære, tid, touch, touch_nocreate. I tillegg er noen plattformspesifikke kommandoer tilgjengelig. På Windows: delete_regv, write_regv. OnUNIX: create_symlink.
-L
Liste ikke-avanserte bufrede variabler.
List cache variabler vil kjøre CMake og liste alle variablene fromthe CMake cache som ikke er merket SOM INTERN eller AVANSERT. Thiswill effektivt vise gjeldende CMake innstillinger, som deretter kan bechanged med – d alternativet. Endring av noen av variablene kan resultere i flere variabler blir opprettet. Hvis A er spesifisert, vil detvis også avanserte variabler. Hvis H er angitt, vil det ogsådisplay hjelp for hver variabel.
--build <dir>
Bygg Et CMake-generert prosjekt binært tre.
dette abstracts en innfødt bygge verktøy kommandolinjegrensesnitt med thefølgende alternativer:
<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.
Kjør cmake-bygg uten muligheter for rask hjelp.
-N
Bare Visningsmodus.
last bare inn hurtigbufferen. Ikke kjør faktisk konfigurer og generatesteps.
-P <file>
prosessskriptmodus.
Behandle den gitte cmake-filen som et skript skrevet I CMakelanguage. Ingen konfigurere eller generere trinn utføres og cacheis ikke endret. Hvis variabler er definert ved hjelp Av-D, må dette væregjort før-P argumentet.
--find-package
Kjør i pkg-config-lignende modus.
Søk i en pakke ved hjelp av find_package () og skriv ut de resulterende flagsto stdout. Dette kan brukes til å bruke cmake stedet for pkg-config tofind installert biblioteker i vanlig Makefile-baserte prosjekter eller inautoconf-baserte prosjekter (via share/aclocal/cmake.m4).
--graphviz=
Generer graphviz av avhengigheter, se CMakeGraphVizOptions.cmake for mer.
Generer en graphviz-inndatafil som vil inneholde alt biblioteket andexecutable avhengigheter i prosjektet. Se dokumentasjonen forCMakeGraphVizOptions.cmake for flere detaljer.
--system-information
Dump informasjon om dette systemet.
Dump et bredt spekter av informasjon om dagens system. Hvis runfrom toppen av et binært tre for Et CMake-prosjekt, vil det dumpeekstra informasjon som cache, loggfiler etc.
--debug-trycompile
ikke slett try_compile build-treet. Bare nyttig pa en try_compile om gangen.
ikke slett filene og katalogene som er opprettet for try_compilecalls. Dette er nyttig i feilsøking mislyktes try_compiles. Det mayhowever endre resultatene av try-kompilerer som gammel søppel fra aprevious try-compile kan føre til en annen test å enten passere orfail feil. Dette alternativet brukes best til ett forsøk-kompilere om atid, og bare når feilsøking.
--debug-output
Sett cmake i en feilsøkingsmodus.
Skriv ut ekstra ting under cmake kjøre som stakk spor withmessage(send_error ) samtaler.
--trace
Sett cmake i sporingsmodus.
Skriv ut et spor av alle samtaler og hvor withmessage (send_error ) samtaler.
--warn-uninitialized
Advare om initialiserte verdier.
Skriv ut en advarsel når en initialisert variabel brukes.
--warn-unused-vars
Advare om ubrukte variabler.
Finn variabler som er deklarert eller angitt, men ikke brukt.
--no-warn-unused-cli
ikke advare om kommandolinjealternativer.
finner ikke variabler som er deklarert på kommandolinjen, men notused.
--check-system-vars
Finn problemer med variabel bruk i systemfiler.
normalt søkes ubrukte og ikke-initialiserte variabler etter onlyin CMAKE_SOURCE_DIR og CMAKE_BINARY_DIR. Dette flagget forteller CMake towarn om andre filer også.
--help,-help,-usage,-h,-H,/?
Informasjon Om Utskriftsbruk og avslutning.
Bruk beskriver det grunnleggende kommandolinjegrensesnittet og alternativene.
--version,-version,/V
Vis programnavn / versjon banner og avslutt.
hvis en fil er angitt, skrives versjonen inn i den.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.
--help-full
Skriv ut alle hjelpehåndbøker og avslutt.
alle håndbøkene skrives ut i et lesbart tekstformat.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.
--help-manual <man>
Skriv ut en hjelpehåndbok og avslutt.
den angitte håndboken skrives ut i et lesbart tekstformat.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.
--help-manual-list
Liste hjelpehåndbøker tilgjengelig og avslutt.
listen inneholder alle manualer som du kan få hjelp til ved å bruke alternativet --help-manual etterfulgt av et manuelt navn.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.
--help-command <cmd>
Skriv ut hjelp for en kommando og avslutt.
den cmake-commands(7) manuelle oppføringen for <cmd> er skrevet ut i et lesbart tekstformat.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.
--help-command-list
Liste kommandoer med hjelp tilgjengelig og avslutt.
listen inneholder alle kommandoer som hjelp kan fås ved å bruke alternativet --help-command etterfulgt av et kommandonavn.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.
--help-commands
Skriv ut cmake-kommandoer manuell og avslutt.
håndboken cmake-commands(7) skrives ut i et menneskelesbart tekstformat.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.
--help-module <mod>
Skriv ut hjelp for en modul og avslutt.
den cmake-modules(7) manuelle oppføringen for <mod> skrives ut i et lesbart tekstformat.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.
--help-module-list
List moduler med hjelp tilgjengelig og avslutt.
listen inneholder alle moduler som hjelp kan fås ved å bruke alternativet --help-module etterfulgt av et modulnavn.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.
--help-modules
Skriv ut cmake-moduler manuell og avslutt.
håndboken cmake-modules(7) skrives ut i et format som er lesbart for mennesker.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.
--help-policy <cmp>
Skriv ut hjelp for en policy og utgang.
den cmake-policies(7) manuelle oppføringen for <cmp> er skrevet ut i et lesbart tekstformat.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.
--help-policy-list
Listepolicyer med hjelp tilgjengelig og utgang.
listen inneholder alle policyer som kan få hjelp ved å bruke alternativet --help-policy etterfulgt av et policynavn.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.
--help-policies
skriv ut cmake-policyer manuell og avslutt.
håndboken cmake-policies(7) skrives ut i et menneskelesbart tekstformat.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.
--help-property <prop>
Skriv ut hjelp for en egenskap og utgang.
cmake-properties(7) manuelle oppføringer for <prop> er skrevet ut i et lesbart tekstformat.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.
--help-property-list
Liste egenskaper med hjelp tilgjengelig og avslutt.
listen inneholder alle egenskaper som hjelp kan fås ved å bruke alternativet --help-property etterfulgt av et egenskapsnavn.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.
--help-properties
Skriv ut cmake-egenskaper manuell og avslutt.
håndboken cmake-properties(7) skrives ut i et menneskelesbart tekstformat.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.
--help-variable <var>
Skriv ut hjelp for en variabel og utgang.
den cmake-variables(7) manuelle oppføringen for <var> er skrevet ut i et lesbart tekstformat.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.
--help-variable-list
Liste variabler med hjelp tilgjengelig og utgang.
listen inneholder alle variabler som hjelp kan fås ved å bruke alternativet --help-variable etterfulgt av et variabelnavn.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.
--help-variables
skriv ut cmake-variabler manuell og avslutt.
håndboken cmake-variables(7) skrives ut i et menneskelesbart tekstformat.Hjelpen skrives ut til en navngitt <f > ile hvis gitt.