alternativ¶
-C <initial-cache>
förinstallera ett skript för att fylla i cachen.
när cmake körs först i ett tomt byggträd skapar det aCMakeCache.txt-fil och fyller den med anpassningsbara inställningar förprojektet. Det här alternativet kan användas för att ange en fil från vilkenatt ladda cacheposter innan det första passet Genom project ’ scmake listfiles. De laddade posterna prioriteras framför projektets standardvärden. Den givna filen ska vara en cmake scriptcontaining SET kommandon som använder CACHE alternativet, inte acache – format fil.
-D <var>:<type>=<value>
skapa en cmake-cache-post.
när cmake körs först i ett tomt byggträd skapar det aCMakeCache.txt-fil och fyller den med anpassningsbara inställningar förprojektet. Det här alternativet kan användas för att ange en inställning somtar prioritet över projektets standardvärde. Alternativet kan varaupprepas för så många cache-poster som önskat.
-U <globbing_expr>
ta bort matchande poster från cmake cache.
det här alternativet kan användas för att ta bort en eller flera variabler från theCMakeCache.txt-fil, globbing uttryck med * och ? stöds. Alternativet kan upprepas för så många cache-poster somönskat.
använd med försiktighet, Du kan göra din CMakeCache.txt icke-arbetande.
-G <generator-name>
ange en byggsystemgenerator.
CMake kan stödja flera inbyggda byggsystem på vissa plattformar. En generator är ansvarig för att generera en vissbyggsystem. Möjliga generatornamn anges igeneratorer avsnitt.
-T <toolset-name>
ange verktygsuppsättningsnamn om det stöds av generator.
vissa cmake-generatorer stöder ett verktygsuppsättningsnamn som ska ges till det inbyggda byggsystemet för att välja en kompilator. Detta stöds endast påspecifika generatorer:
Visual Studio >= 10Xcode >= 3.0
se native build system dokumentation för tillåtna verktygsuppsättningsnamn.
-A <platform-name>
ange plattformsnamn om det stöds av generator.
vissa cmake-generatorer stöder ett plattformsnamn som ska ges till native build system för att välja en kompilator eller SDK. Detta stöds endast påspecifika generatorer:
Visual Studio >= 8
se native build system dokumentation för tillåtna plattformsnamn.
-Wno-dev
undertrycka utvecklarvarningar.
undertrycka varningar som är avsedda för författaren till theCMakeLists.txt-filer.
-Wdev
aktivera utvecklarvarningar.
aktivera varningar som är avsedda för författaren till CMakeLists.txtfiles.
-E
cmake kommandoläge.
för sann plattformsoberoende ger CMake en lista över kommandon som kan användas på alla system. Kör med – E hjälp för användningeninformation. Tillgängliga kommandon är: chdir, compare_files, kopiera, copy_directory, copy_if_different, echo, echo_append, env,miljö, make_directory, md5sum, ta bort, remove_directory, byta namn, sömn, tjära,tid, touch, touch_nocreate. Dessutom vissa plattformsspecifika kommandonär tillgängliga. På Windows: delete_regv, write_regv. OnUNIX: create_symlink.
-L
lista icke-avancerade cachade variabler.
listcachevariabler kör cmake och listar alla variabler från CMake-cachen som inte är markerade som interna eller avancerade. Thiswill effektivt visa aktuella cmake inställningar, som sedan kan bechanged med-D alternativ. Att ändra några av variablerna kan resulterai fler variabler skapas. Om A anges, så kommer det attvisa även avancerade variabler. Om H anges kommer det ocksåvisa hjälp för varje variabel.
--build <dir>
Bygg ett CMake-genererat projekt binärt träd.
detta abstraherar ett inbyggt byggverktygs kommandoradsgränssnitt med följande alternativ:
<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.
kör cmake-build utan alternativ för snabb hjälp.
-N
endast visningsläge.
ladda bara cachen. Kör inte configure och generatesteg.
-P <file>
bearbeta skriptläge.
bearbeta den givna cmake-filen som ett skript skrivet på CMakelanguage. Ingen konfigurera eller generera steg utförs och cacheis inte ändras. Om variabler definieras med -D måste detta göras före-P-argumentet.
--find-package
kör i pkg-config liknande läge.
sök ett paket med find_package() och skriv ut den resulterande flagsto stdout. Detta kan användas för att använda cmake istället för pkg-config tofind installerade bibliotek i vanliga Makefile-baserade projekt eller inautoconf-baserade projekt (via share/aclocal/cmake.m4).
--graphviz=
generera graphviz av beroenden, se CMakeGraphVizOptions.cmake för mer.
generera en graphviz-inmatningsfil som innehåller alla bibliotek ochutförbara beroenden i projektet. Se dokumentationen forCMakeGraphVizOptions.cmake för mer information.
--system-information
dumpa information om detta system.
dumpa ett brett utbud av information om det nuvarande systemet. Om det körs från toppen av ett binärt träd för ett CMake-projekt kommer det att dumpa ytterligare information som cache, loggfiler etc.
--debug-trycompile
ta inte bort byggträdet try_compile. Endast användbar på en try_compile åt gången.
ta inte bort filer och kataloger som skapats för try_compilecalls. Detta är användbart i felsökning misslyckades try_compiles. Det kan dock ändra resultaten av try-compiles som gammal skräp från aprevious try-compile kan orsaka ett annat test för att antingen passera orfail felaktigt. Det här alternativet används bäst för ett försök-kompilera åt gången, och endast vid felsökning.
--debug-output
sätt cmake i ett felsökningsläge.
Skriv ut extra saker under cmake-körningen som stack traces withmessage(send_error) – samtal.
--trace
sätt cmake i spårläge.
Skriv ut ett spår av alla samtal som gjorts och varifrån medmeddelande(send_error ) samtal.
--warn-uninitialized
varna om oinitierade värden.
Skriv ut en varning när en oinitierad variabel används.
--warn-unused-vars
varna om oanvända variabler.
hitta variabler som deklareras eller ställs in men som inte används.
--no-warn-unused-cli
varna inte om kommandoradsalternativ.
hitta inte variabler som deklareras på kommandoraden, men inteanvänds.
--check-system-vars
hitta problem med variabel användning i systemfiler.
normalt söks oanvända och oinitierade variabler endast efter CMAKE_SOURCE_DIR och CMAKE_BINARY_DIR. Denna flagga berättar CMake towarn om andra filer också.
--help,-help,-usage,-h,-H,/?
Skriv ut användningsinformation och avsluta.
användning beskriver det grundläggande kommandoradsgränssnittet och dess alternativ.
--version,-version,/V
Visa programnamn/version banner och avsluta.
om en fil anges skrivs versionen in i den.Hjälpen skrivs ut till en namngiven<f >ile om den ges.
--help-full
Skriv ut alla hjälpmanualer och avsluta.
alla manualer är tryckta i ett läsbart textformat.Hjälpen skrivs ut till en namngiven<f >ile om den ges.
--help-manual <man>
Skriv ut en hjälpmanual och avsluta.
den angivna handboken är tryckt i ett läsbart textformat.Hjälpen skrivs ut till en namngiven<f >ile om den ges.
--help-manual-list
Listhjälp manualer tillgängliga och avsluta.
listan innehåller alla manualer för vilka hjälp kan erhållas genom att använda alternativet --help-manual följt av ett manuellt namn.Hjälpen skrivs ut till en namngiven<f >ile om den ges.
--help-command <cmd>
Skriv ut hjälp för ett kommando och avsluta.
cmake-commands(7) manuell inmatning för <cmd> ärtryckt i ett läsbart textformat.Hjälpen skrivs ut till en namngiven<f >ile om den ges.
--help-command-list
Lista kommandon med hjälp tillgänglig och avsluta.
listan innehåller alla kommandon för vilka hjälp kan erhållas genom att använda alternativet --help-command följt av ett kommandonamn.Hjälpen skrivs ut till en namngiven<f >ile om den ges.
--help-commands
Skriv ut cmake-kommandon manuell och avsluta.
manualen cmake-commands(7) är tryckt i ahuman-läsbar textformat.Hjälpen skrivs ut till en namngiven<f >ile om den ges.
--help-module <mod>
Skriv ut hjälp för en modul och avsluta.
cmake-modules(7) manuell inmatning för <mod> skrivs ut i ett läsbart textformat.Hjälpen skrivs ut till en namngiven<f >ile om den ges.
--help-module-list
lista moduler med hjälp tillgänglig och avsluta.
listan innehåller alla moduler för vilka hjälp kan erhållas genom att använda alternativet --help-module följt av ett modulnamn.Hjälpen skrivs ut till en namngiven<f >ile om den ges.
--help-modules
skriv cmake-moduler manuell och avsluta.
manualen cmake-modules(7) skrivs ut i ett human-readabletext-format.Hjälpen skrivs ut till en namngiven<f >ile om den ges.
--help-policy <cmp>
Skriv ut hjälp för en policy och avsluta.
cmake-policies(7) manuell inmatning för <cmp> ärtryckt i ett läsbart textformat.Hjälpen skrivs ut till en namngiven<f >ile om den ges.
--help-policy-list
lista policyer med hjälp tillgänglig och avsluta.
listan innehåller alla policyer för vilka hjälp kan erhållas genom att använda alternativet --help-policy följt av ett principnamn.Hjälpen skrivs ut till en namngiven<f >ile om den ges.
--help-policies
Skriv ut cmake-policies manual och avsluta.
manualen cmake-policies(7) är tryckt i ahuman-läsbar textformat.Hjälpen skrivs ut till en namngiven<f >ile om den ges.
--help-property <prop>
Skriv ut hjälp för en egenskap och avsluta.
cmake-properties(7) manuella poster för <prop> skrivs ut i ett läsbart textformat.Hjälpen skrivs ut till en namngiven<f >ile om den ges.
--help-property-list
lista egenskaper med hjälp tillgänglig och avsluta.
listan innehåller alla egenskaper för vilka hjälp kan erhållas genom att använda alternativet --help-property följt av ett egenskapsnamn.Hjälpen skrivs ut till en namngiven<f >ile om den ges.
--help-properties
Skriv ut cmake-egenskaper manual och avsluta.
manualen cmake-properties(7) är tryckt i ahuman-läsbar textformat.Hjälpen skrivs ut till en namngiven<f >ile om den ges.
--help-variable <var>
Skriv ut hjälp för en variabel och avsluta.
cmake-variables(7) manuell inmatning för <var> ärtryckt i ett läsbart textformat.Hjälpen skrivs ut till en namngiven<f >ile om den ges.
--help-variable-list
lista variabler med hjälp tillgänglig och avsluta.
listan innehåller alla variabler för vilka hjälp kan erhållas genom att använda alternativet --help-variable följt av ett variabelnamn.Hjälpen skrivs ut till en namngiven<f >ile om den ges.
--help-variables
Skriv ut cmake-variabler manuell och avsluta.
manualen cmake-variables(7) är tryckt i ahuman-läsbar textformat.Hjälpen skrivs ut till en namngiven<f >ile om den ges.