Options list

-S <path-to-source>

sti til rodmappe for CMake-projektet, der skal bygges.

-B <path-to-build>

sti til mappe, som CMake vil bruge som roden til build directory.

hvis mappen ikke allerede findes CMake vil gøre det.

-C <initial-cache>

indlæs et script for at udfylde cachen.

Når CMake først køres i et tomt build-træ, opretter det enCMakeCache.txt fil og udfylder den med tilpassede indstillinger forprojektet. Denne indstilling kan bruges til at angive en fil, hvorfraat indlæse cache-poster før den første passage gennem projektets scmake listfiles. De indlæste poster prioriteres overprojektets standardværdier. Den givne fil skal være en CMake scriptindeholder set() kommandoer, der bruger CACHE, ikke acache-format fil.

referencer tilCMAKE_SOURCE_DIR ogCMAKE_BINARY_DIRinden for scriptet evaluere til Top-niveau kilde og bygge træ.

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

Opret eller Opdater en CMakeCACHE indgang.

Når CMake først køres i et tomt build-træ, opretter det enCMakeCache.txt fil og udfylder den med tilpassede indstillinger forprojektet. Denne indstilling kan bruges til at angive en indstilling, der prioriterer projektets standardværdi. Indstillingen kan væregentag for så mangeCACHE poster som ønsket.

Hvis:<type> delen er givet, skal den være en af typernespecificeret afset() kommandodokumentation for densCACHE signatur.Hvis:<type> delen udelades, oprettes posten uden type, hvis den ikke findes med en type allerede. Hvis acommand i projektet indstiller typen til PATH eller FILEPATHså konverteres <value> til en absolut sti.

denne mulighed kan også gives som et enkelt argument:-D<var>:<type>=<value>eller -D<var>=<value>.

-U <globbing_expr>

Fjern matchende poster fra CMake CACHE.

denne indstilling kan bruges til at fjerne en eller flere variabler fraCMakeCache.txt fil, globbing udtryk ved hjælp af * og ? aresupported. Indstillingen kan gentages for så mangeCACHE poster somønsket.

brug med omhu, du kan gøre dinCMakeCache.txt ikke-fungerende.

-G <generator-name>

Angiv en build-SystemGenerator.

CMake understøtter muligvis flere indbyggede byggesystemer på visse platforme. En generator er ansvarlig for at generere en bestemtbygningssystem. Mulige generatornavne er angivet icmake-generators(7) manualen.

Hvis det ikke er angivet, kontrollerer CMake CMAKE_GENERATOR miljøvariabel og falder ellers tilbage til et indbygget standardvalg.

-T <toolset-spec>

værktøjssæt specifikation for generatoren, hvis understøttet.

nogle CMake-generatorer understøtter en værktøjsspecifikation for at fortælle det oprindelige byggesystem, hvordan man vælger en kompilator. Se variablenCMAKE_GENERATOR_TOOLSET for detaljer.

-A <platform-name>

Angiv platformnavn, hvis det understøttes af generator.

nogle CMake-generatorer understøtter et platformnavn, der skal gives til det oprindelige byggesystem for at vælge en kompilator eller SDK. Se variablenCMAKE_GENERATOR_PLATFORM for detaljer.

-Wno-dev

undertryk udvikleradvarsler.

undertryk advarsler, der er beregnet til forfatteren afCMakeLists.txt filer. Som standard vil dette også deaktiveredeprecation advarsler.

-Wdev

aktiver udvikleradvarsler.

aktiver advarsler, der er beregnet til forfatteren af CMakeLists.txtfiler. Som standard vil dette også slå afskrivningsadvarsler til.

-Werror=dev

lav fejl i udvikleradvarsler.

lav advarsler, der er beregnet til forfatteren af CMakeLists.txt fileserrors. Som standard vil dette også tænde forældede advarsler som fejl.

-Wno-error=dev

gør udvikleradvarsler ikke fejl.

lav advarsler, der er beregnet til forfatteren af CMakeLists.txt files noterrors. Som standard slukker dette også forældede advarsler som fejl.

-Wdeprecated

aktiver forældede funktionsadvarsler.

aktiver advarsler for brug af forældet funktionalitet, der menesfor forfatteren af CMakeLists.txt filer.

-Wno-deprecated

undertryk forældede funktionalitetsadvarsler.

undertryk advarsler for brug af forældet funktionalitet, der menesfor forfatteren afCMakeLists.txt filer.

-Werror=deprecated

lav forældede makro-og funktionsadvarselsfejl.

lav advarsler for brug af forældede makroer og funktioner, der menesfor forfatteren af CMakeLists.txt filer, fejl.

-Wno-error=deprecated

gør forældede makro-og funktionsadvarsler ikke fejl.

lav advarsler om brug af forældede makroer og funktioner, der menes for forfatteren af CMakeLists.txt filer, ikke fejl.

-L

liste ikke-avancerede cachelagrede variabler.

ListCACHE variabler vil køre CMake og liste alle variablerne fracmakeCACHE der ikke er markeret somINTERNAL ellerADVANCED.Dette vil effektivt vise aktuelle CMake-indstillinger, som derefter kan ændres med -D valgmulighed. Ændring af nogle af variablerne kan resultere i, at der oprettes flere variabler. Hvis A er angivet, så vil detvis også avancerede variabler. Hvis H er angivet, vil det ogsådisplay hjælp til hver variabel.

-N

visningstilstand kun.

Indlæs kun cachen. Kør faktisk ikke configure and generatesteps.

--graphviz=

Generer grafvisning af afhængigheder, seCMakeGraphVizOptions for mere.

Generer en grafvis-inputfil, der vil indeholde alt biblioteket ogudførbare afhængigheder i projektet. Se dokumentationen forCMakeGraphVizOptions for flere detaljer.

--system-information

Dump oplysninger om dette system.

Dump en bred vifte af oplysninger om det nuværende system. Hvis det køres fra toppen af et binært træ til et CMake-projekt, vil det dumpeyderligere oplysninger såsom cachen, logfiler osv.

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

Indstil logniveauet.

message() kommandoen udsender kun meddelelser på det angivne logniveau eller højere. Standard log niveau er STATUS.

for at gøre et logniveau vedvarende mellem CMake-kørsler, skal du indstilleCMAKE_MESSAGE_LOG_LEVEL som en cache-variabel i stedet.Hvis både kommandolinjemuligheden og variablen er givet, har kommandolinjemuligheden forrang.

af bagudkompatibilitetsårsager accepteres --loglevel også som asynonym for denne mulighed.

--log-context

aktivermessage() kommando output kontekst knyttet til eachmessage.

denne indstilling aktiverer visning af kontekst for den aktuelle CMake-kørsel only.To gør visning af konteksten vedvarende for alle efterfølgende CMake-kørsler, IndstilCMAKE_MESSAGE_CONTEXT_SHOW som en cache-variabel i stedet.Når denne kommandolinjeindstilling er givet, ignoreresCMAKE_MESSAGE_CONTEXT_SHOW.

--debug-trycompile

slet ikketry_compile() byg træ.Kun nyttig på en try_compile() ad gangen.

slet ikke de filer og mapper, der er oprettet til try_compile()opkald. Dette er nyttigt i debugging mislykkedes try_compiles. Det kan dog ændre resultaterne af prøvekompilerne, da gammelt skrammel fra en tidligere prøvekompilering kan forårsage, at en anden test enten passerer eller fejler forkert. Denne mulighed bruges bedst til et forsøg-kompilere ad gangen, og kun ved fejlfinding.

--debug-output

sæt cmake i en debug-tilstand.

Udskriv ekstra information under CMake-kørslen som stakspor medmessage(SEND_ERROR) opkald.

--debug-find

sæt CMake find kommandoer i en debug-tilstand.

Udskriv ekstra find opkaldsoplysninger under CMake-kørslen til standarderror. Output er designet til konsum og ikke til parsing.Se også variablenCMAKE_FIND_DEBUG_MODE til fejlfinding af en mere lokal del af projektet.

--trace

sæt cmake i sporingstilstand.

Udskriv et spor af alle foretagne opkald og hvorfra.

--trace-expand

sæt cmake i sporingstilstand.

Synes godt om --trace, men med variabler udvidet.

--trace-format=<format>

sæt cmake i sporingstilstand og indstiller sporingsudgangsformatet.

<format> kan være en af følgende værdier.

human

udskriver hver sporlinje i et menneskeligt læsbart format. Dette er thedefault format.

json-v1

udskriver hver linje som et separat JSON-dokument. Hvert dokument er adskilt af en nylinje ( \n ). Det er garanteret, at ikke-nye tegn vil være til stede 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}

medlemmerne er:

file

den fulde sti til CMake-kildefilen, hvor funktionenblev kaldt.

line

linjen i file af funktionsopkaldet.

defer

Valgfrit medlem, der er til stede, når funktionsopkaldet blev udskudt afcmake_language(DEFER). Hvis den er til stede, er dens værdi astring indeholdende det udskudte opkald <id>.

cmd

navnet på den funktion, der blev kaldt.

args

en strengliste over alle funktionsparametre.

time

tidsstempel (sekunder siden epoke) for funktionsopkaldet.

frame

stak rammedybde af den funktion, der blev kaldt.

derudover indeholder det første JSON-dokument, der udsendes,version – tasten for den aktuelle større og mindre version af

JSON-sporingsformatet:

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

medlemmerne er:

version

angiver versionen af JSON-formatet. Versionen har en større og mindre komponenter efter semantiske versionskonventioner.

--trace-source=<file>

sæt cmake i sporingstilstand, men udfør kun linjer af en bestemt fil.

flere muligheder er tilladt.

--trace-redirect=<file>

sæt cmake i sporingstilstand og omdirigere sporingsoutput til en fil i stedet for stderr.

--warn-uninitialized

advar om uinitialiserede værdier.

Udskriv en advarsel, når der anvendes en ikke-initialiseret variabel.

--warn-unused-vars

gør intet. I CMake versioner 3.2 og under dette aktiveret advarsler omubrugte variabler. I CMake versioner 3.3 til 3.18 var indstillingen broken.In CMake 3.19 og over indstillingen er blevet fjernet.

--no-warn-unused-cli

advar ikke om kommandolinjeindstillinger.

find ikke variabler, der er erklæret på kommandolinjen, men ikkebrugt.

--check-system-vars

Find problemer med variabel brug i systemfiler.

normalt søges ubrugte og ikke-initialiserede variabler kuni CMAKE_SOURCE_DIRog CMAKE_BINARY_DIR.Dette flag fortæller CMake også at advare om andre filer.

--profiling-output=<path>

bruges sammen med --profiling-format til output til en given sti.

--profiling-format=<file>

aktiver output af profileringsdata af CMake script i det givne format.

dette kan hjælpe ydeevne analyse af CMake scripts udført. Tredjepartsapplikationer bør anvendes til at behandle output i menneskeligt læsbart format.

aktuelt understøttede værdier er:google-trace udgange i Google Trace-Format, som kan analyseres afabout:tracing-fanen i Google Chrome eller ved hjælp af et plugin til et værktøj som TraceCompass.

--preset <preset>--preset=<preset>

læser en preset fra<path-to-source>/CMakePresets.json og<path-to-source>/CMakeUserPresets.json. Forudindstillingen specificerer generatoren og build-mappen og eventuelt en liste over variabler og andre argumenter, der skal overføres til CMake. Den aktuelle arbejdsmappe skal indeholdelav forudindstillede filer. CMake GUIkanogså genkendeCMakePresets.jsonogCMakeUserPresets.json filer. For fuldstændige oplysninger om disse filer, se cmake-presets(7).

forudindstillingerne læses før alle andre kommandolinjeindstillinger. Indstillingernespecificeret af forudindstillingen (variabler, generator osv.) kan alle tilsidesættes afmanuelt angive dem på kommandolinjen. For eksempel, hvis den forudindstillede sætteren variabel kaldet MYVAR til 1, men brugeren indstiller den til 2 med et-D argument, værdien 2 foretrækkes.

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

viser de tilgængelige forudindstillinger. Hvis der ikke er angivet nogen indstilling, skal du kun konfigurere forudindstillingervil blive opført. Den aktuelle arbejdsmappe skal indeholde CMake forudindstillede filer.