valg¶

-S <path-to-source>

Sti til rotkatalogen Av CMake-prosjektet å bygge.

-B <path-to-build>

Sti til katalog Som CMake vil bruke som roten til byggekatalogen.

Hvis katalogen ikke allerede finnes CMake vil gjøre det.

-C <initial-cache>

last inn et skript For å fylle ut hurtigbufferen.

Når CMake først kjøres i et tomt byggetre, oppretter det en CMakeCache.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 scriptcontainingset() kommandoer som bruker alternativetCACHE, ikke acache-formatfil.

Referanser til CMAKE_SOURCE_DIR og CMAKE_BINARY_DIRi skriptet evalueres til kilde-og byggetreet på øverste nivå.

-D <var>:<type>=<value>, -D <var>=<value>

Opprett Eller oppdater En CMake CACHE oppføring.

Når CMake først kjøres i et tomt byggetre, oppretter det en CMakeCache.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å mangeCACHE oppføringer som ønsket.

hvis :<type> – delen er gitt, må den være en av typerspecified av set() kommandodokumentasjon forCACHE signaturen.Hvis:<type> – delen utelates, vil oppføringen bli opprettet uten type hvis den ikke finnes med en type allerede. Hvis acommand i prosjektet setter typen til PATH eller FILEPATHvil <value> konverteres til en absolutt bane.

dette alternativet kan også gis som et enkelt argument:-D<var>:<type>=<value> eller -D<var>=<value>.

-U <globbing_expr>

Fjern matchende oppføringer fra CMakeCACHE.

dette alternativet kan brukes til å fjerne en eller flere variabler fraCMakeCache.txt fil, globbing uttrykk ved hjelp av * og ? aresupported. Alternativet kan gjentas for så mangeCACHE oppføringer som ønsket.

Bruk med forsiktighet, du kan gjøre 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 icmake-generators(7) manualen.

Hvis Ikke spesifisert, CMake sjekkerCMAKE_GENERATOR environmentvariable og ellers faller tilbake til en innebygd standardvalg.

-T <toolset-spec>

verktøysett spesifikasjon for generatoren, hvis det støttes.

Noen CMake-generatorer støtter en toolset-spesifikasjon for å fortelle det opprinnelige byggesystemet hvordan man velger en kompilator. SeCMAKE_GENERATOR_TOOLSET variabelen for detaljer.

-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. SeCMAKE_GENERATOR_PLATFORM variabelen for detaljer.

-Wno-dev

Undertrykk utvikleradvarsler.

Undertrykke advarsler som er ment for forfatteren avCMakeLists.txt filer. Som standard vil dette også slå avdeprecation advarsler.

-Wdev

Aktiver utvikleradvarsler.

Aktiver advarsler som er ment for forfatteren avCMakeLists.txtfiler. Som standard vil dette også slå på avskrivningsvarsler.

-Werror=dev

Gjør utvikleradvarsler feil.

Gjør advarsler som er ment for forfatteren avCMakeLists.txt fileserrors. Som standard vil dette også slå på utdaterte advarsler som feil.

-Wno-error=dev

Gjør utvikleradvarsler ikke feil.

Gjør advarsler som er ment for forfatteren av CMakeLists.txt filer noterrors. Som standard vil dette også slå av utdaterte advarsler som feil.

-Wdeprecated

Aktiver advarsler om utdatert funksjonalitet.

Aktiver advarsler for bruk av utdatert funksjonalitet, som er ment for forfatteren avCMakeLists.txt filer.

-Wno-deprecated

Undertrykk advarsler om utdatert funksjonalitet.

Undertrykk advarsler for bruk av utdatert funksjonalitet, som er ment for forfatteren avCMakeLists.txt filer.

-Werror=deprecated

Gjør utdaterte makro-og funksjonsadvarsler feil.

Gjør advarsler for bruk av utdaterte makroer og funksjoner, som er ment for forfatteren avCMakeLists.txt filer, feil.

-Wno-error=deprecated

Gjør utdaterte makro-og funksjonsadvarsler ikke feil.

Gjør advarsler for bruk av utdaterte makroer og funksjoner, som er ment for forfatteren avCMakeLists.txt filer, ikke feil.

-L

Liste ikke-avanserte bufrede variabler.

ListCACHE variabler vil kjøre CMake og liste alle variablene fromthe CMakeCACHE som ikke er merket somINTERNAL ellerADVANCED.Dette vil effektivt vise gjeldende CMake-innstillinger, som deretter kan endres med-D alternativ. Endring av noen av variablene kan resultere i flere variabler blir opprettet. HvisA er spesifisert, vil det vise også avanserte variabler. Hvis H er angitt, vil det også vise hjelp for hver variabel.

-NBare Visningsmodus.

last bare hurtigbufferen. Ikke kjør faktisk konfigurer og generatesteps.

--graphviz=

Generer graphviz av avhengigheter, se CMakeGraphVizOptions for mer.

Generer en graphviz input-fil som vil inneholde alle biblioteket andexecutable avhengigheter i prosjektet. Se dokumentasjonen for CMakeGraphVizOptions for mer informasjon.

--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.

--log-level=<ERROR|WARNING|NOTICE|STATUS|VERBOSE|DEBUG|TRACE>

Angi loggnivået.

kommandoenmessage() vil bare sende meldinger av specifiedlog nivå eller høyere. Standard loggnivå er STATUS.

for å få et loggnivå til å fortsette mellom CMake-kjøringer, sett CMAKE_MESSAGE_LOG_LEVEL som en hurtigbuffervariabel i stedet.Hvis både kommandolinjealternativet og variabelen er gitt, har kommandolinjevalget forrang.

av bakoverkompatibilitet er --loglevel også akseptert som asynonym for dette alternativet.

--log-context

Aktivermessage() kommandoen sender ut kontekst knyttet til eachmessage.

dette alternativet slår på viser kontekst for Gjeldende cmake-kjøring only.To gjør viser konteksten vedvarende for alle påfølgende CMake kjører, settCMAKE_MESSAGE_CONTEXT_SHOW som en cache variabel i stedet.Når dette kommandolinjealternativet er gitt, ignoreres CMAKE_MESSAGE_CONTEXT_SHOW.

--debug-trycompile

ikke slett try_compile() bygge treet.Bare nyttig på en try_compile() om gangen.

ikke slett filene og katalogene som er opprettet for try_compile()samtaler. 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 informasjon under cmake kjøre som stakk spor medmessage(SEND_ERROR) samtaler.

--debug-find

Sett cmake finn kommandoer i en feilsøkingsmodus.

Skriv ut ekstra finn samtale informasjon under cmake kjøre til standarderror. Output er designet for konsum og ikke for parsing.Se ogsåCMAKE_FIND_DEBUG_MODE variabel for debugginga mer lokal del av prosjektet.

--trace

Sett cmake i sporingsmodus.

Skriv ut et spor av alle samtaler og hvor.

--trace-expand

Sett cmake i sporingsmodus.

Som --trace, men med variabler utvidet.

--trace-format=<format>

Sett cmake i trace-modus og setter trace-utdataformatet.

<format> kan være en av følgende verdier.

human

Skriver ut hver sporingslinje i et lesbart format. Dette er standardformat.

json-v1

Skriver ut hver linje som et eget json-dokument. Hvert dokument er adskilt av en ny linje ( \n ). Det er garantert at nonewline tegn vil være til stede inne I ET json-dokument.

json trace format:

{ "file": "/full/path/to/the/CMake/file.txt", "line": 0, "cmd": "add_executable", "args": , "time": 1579512535.9687231, "frame": 2}

medlemmene er: file

hele banen til CMake kildefilen der funksjonen ble kalt.

line

linjen i file av funksjonskallet.

defer

Valgfritt medlem som er til stede når funksjonskallet ble utsatt cmake_language(DEFER). Hvis den finnes, er verdien astring som inneholder det utsatte kallet <id>.

cmd

navnet på funksjonen som ble kalt.

args

en strengliste over alle funksjonsparametere.

time

Tidsstempel (sekunder siden epoke) av funksjonskallet.

frame

Stakk ramme dybde av funksjonen som ble kalt.

I tillegg inneholder DET første json-dokumentet som skrives utversion – tasten for gjeldende hoved-og underordnet versjon av

json-sporingsformatet:

{ "version": { "major": 1, "minor": 1 }}

medlemmene er:version

Angir versjonen AV json-formatet. Versjonen har store og mindre komponenter etter semantiske versjonskonvensjoner.

--trace-source=<file>

sett cmake i sporingsmodus, men skriv bare ut linjer av en spesifisert fil.

Flere alternativer er tillatt.

--trace-redirect=<file>

Sett cmake i sporingsmodus og omdirigere sporutgang til en fil i stedet for stderr.

--warn-uninitialized

Advare om initialiserte verdier.

Skriv ut en advarsel når en initialisert variabel brukes.

--warn-unused-vars

Gjør ingenting. I CMake versjoner 3.2 og under dette aktiverte advarsler omubrukte variabler. I CMake versjoner 3.3 til 3.18 var alternativet broken.In CMake 3.19 og over alternativet er fjernet.

--no-warn-unused-cli

ikke advar 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 barei CMAKE_SOURCE_DIR og CMAKE_BINARY_DIR.Dette flagget forteller CMake å advare om andre filer også.

--profiling-output=<path>

Brukes sammen med --profiling-format for å sende ut til en gitt bane.

--profiling-format=<file>

Aktiver utdata av profileringsdata For CMake-skript i det angitte formatet.

Dette kan hjelpe ytelse analyse Av CMake skript utført. Tredjepartsapplikasjoner skal brukes til å behandle utdataene i lesbart format.

støttede verdier er: google-trace Utganger I Google Trace-Format,som kan analyseres av theabout: tracing-fanen I Google Chrome eller ved hjelp Av et plugin for et verktøy som TraceCompass.

--preset <preset>--preset=<preset>leser enpresetfra<path-to-source>/CMakePresets.jsonog<path-to-source>/CMakeUserPresets.json. Forhåndsinnstillingen angir generatoren og byggekatalogen, og eventuelt en liste over variabler og andre argumenter som skal overføres Til CMake. Den nåværende arbeidskatalogen må inneholdelag forhåndsinnstilte filer.CMake GUIkan også gjenkjenneCMakePresets.jsonogCMakeUserPresets.jsonfiler. For full informasjon om disse filene, secmake-presets(7).

forhåndsinnstillingene leses før alle andre kommandolinjealternativer. Alternativene er angitt av forhåndsinnstillingen(variabler, generator, etc.) kan alle overstyres avmanuelt angi dem på kommandolinjen. For eksempel, hvis forhåndsinnstilte setten variabel kalt MYVAR til 1, men brukeren setter den til 2 med en-D argument, verdien 2 foretrekkes.

--list-presets, --list-presets=<>

Viser tilgjengelige forhåndsinnstillinger. Hvis ingen alternativ er angitt, konfigurerer du bare forhåndsinnstillinger. Gjeldende arbeidskatalog må inneholde CMake forhåndsinnstilte filer.