Volby¶

-S <path-to-source>

Cesta k kořenový adresář CMake projekt stavět.

-B <path-to-build>

cesta k adresáři, který CMake použije jako kořen adresáře sestavení.

Pokud adresář ještě neexistuje CMake bude dělat to.

-C <initial-cache>

Pre-load skript naplnit cache.

Když je CMake poprvé spuštěn v prázdném stromu sestavení, vytvoří souborCMakeCache.txt a naplní jej přizpůsobitelnými nastaveními pro projekt. Tato volba může být použita k určení souboru, ze kterého chcete načíst položky mezipaměti před prvním průchodem přes seznam projektůsoubory. Načtené položky mají přednost před výchozími hodnotami projektu. Daný soubor by měl být CMake scriptcontaining set() příkazy, které používají CACHE možnost, ne acache-formát souboru.

Odkazy CMAKE_SOURCE_DIRCMAKE_BINARY_DIRdo skriptu, vyhodnotit nejvyšší úrovně zdroj a postavit strom.

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

Vytvořte nebo aktualizujte CMake CACHE záznam.

Když je CMake poprvé spuštěn v prázdném stromu sestavení, vytvoří souborCMakeCache.txt a naplní jej přizpůsobitelnými nastaveními pro projekt. Tato volba může být použita k určení nastavení, které má přednost před výchozí hodnotou projektu. Volba může být použita pro tolik CACHE položek podle potřeby.

Pokud :<type> část je dána musí být jeden z typesspecified set() příkaz dokumentaci pro jehoCACHE podpis.Pokud je část :<type> vynechána, položka bude vytvořena bez typu, pokud již neexistuje s typem. Pokud v příkazové projektu nastaví typ PATH nebo FILEPATH<value> budou převedeny na absolutní cestu.

tato volba může být také zadána jako jediný argument:-D<var>:<type>=<value> nebo -D<var>=<value>.

-U <globbing_expr>

Odebrat odpovídající položky z CMake CACHE.

Tato volba může být použita pro odstranění jedné nebo více proměnných zCMakeCache.txt soubor, globbing výrazů pomocí *? aresupported. Volba může být opakována pro tolik CACHE položek asdesired.

používejte opatrně, můžete svůj CMakeCache.txt nepracovat.

-G <generator-name>

zadejte generátor sestavení systému.

CMake může podporovat více nativních sestavovacích systémů na určitých platformách. Generátor je zodpovědný za generování konkrétníchstavební systém. Možné názvy generátorů jsou uvedeny v příručcecmake-generators(7).

Pokud není zadáno, CMake zkontroluje CMAKE_GENERATOR environmentvariable a jinak se vrátí zpět na vestavěný výchozí výběr.

-T <toolset-spec>

SPECIFIKACE sady nástrojů pro generátor, pokud je podporována.

některé generátory CMake podporují specifikaci sady nástrojů, která říká nativnímu systému sestavení, jak vybrat kompilátor. Podrobnosti viz proměnnáCMAKE_GENERATOR_TOOLSET.

-A <platform-name>

zadejte název platformy, pokud je podporován generátorem.

některé generátory CMake podporují název platformy, který má být dán systému pro sestavení kompilátoru nebo SDK. Podrobnosti viz proměnnáCMAKE_GENERATOR_PLATFORM.

-Wno-dev

potlačit varování vývojářů.

potlačit varování, která jsou určena pro autora souborůCMakeLists.txt. Ve výchozím nastavení se také vypnedepředchozí varování.

-Wdev

povolit varování pro vývojáře.

povolte varování, která jsou určena pro autora souborů CMakeLists.txt. Ve výchozím nastavení se také zapne varování o zastaralosti.

-Werror=dev

proveďte chyby varování pro vývojáře.

, Aby varování, které jsou určeny pro autora CMakeLists.txt fileserrors. Ve výchozím nastavení se také zapnou zastaralá varování jako chyby.

-Wno-error=dev

ujistěte se, že varování vývojářů nejsou chyby.

, Aby varování, které jsou určeny pro autora CMakeLists.txt soubory noterrors. Ve výchozím nastavení se také vypne zastaralé varování jako chyby.

-Wdeprecated

povolte zastaralá varování funkčnosti.

povolte varování pro použití zastaralých funkcí, které jsou určeny pro autora souborů CMakeLists.txt.

-Wno-deprecated

potlačit zastaralá varování funkčnosti.

potlačit varování pro použití zastaralé funkce, které jsou meantfor autora CMakeLists.txt soubory.

-Werror=deprecated

dělat zastaralé makro a funkce varování chyby.

aby varování pro použití zastaralých Maker a funkcí, které jsou meantfor autora CMakeLists.txt soubory, chyby.

-Wno-error=deprecated

aby zastaralé makro a funkce varování není chyby.

aby varování pro použití zastaralých Maker a funkcí, které jsou meantfor autora CMakeLists.txt soubory, ne chyby.

-L

seznam pokročilých proměnných v mezipaměti.

Seznam CACHE proměnné spustit CMake a seznam všech proměnných z CMake CACHE, které nejsou označeny jako INTERNAL nebo ADVANCED.Tím se efektivně zobrazí aktuální nastavení CMake, které pak lze změnit pomocí volby -D. Změna některých proměnných může mít za následek vytvoření více proměnných. Je-li zadán A, pak to budezobrazí i pokročilé proměnné. Pokud je zadán H, bude také zobrazovat nápovědu pro každou proměnnou.

-N

Pouze Režim zobrazení.

načte pouze mezipaměť. Ve skutečnosti nespouštějte konfiguraci a generujtekroky.

--graphviz=

Generovat graphviz závislostí, viz CMakeGraphVizOptions pro více informací.

Vygenerujte vstupní soubor graphviz, který bude obsahovat všechny knihovny a ověřitelné závislosti v projektu. Další podrobnosti naleznete v dokumentaci proCMakeGraphVizOptions.

--system-information

výpis informací o tomto systému.

vypíše širokou škálu informací o aktuálním systému. Pokud běží z horní části binárního stromu pro projekt CMake, vypíše další informace, jako je mezipaměť, soubory protokolu atd.

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

nastavte úroveň protokolu.

příkaz message() zobrazí pouze zprávy zadané úrovně log nebo vyšší. Výchozí úroveň protokolu je STATUS.

Chcete-li, aby úroveň protokolu přetrvávala mezi běhy CMake, nastavteCMAKE_MESSAGE_LOG_LEVEL jako proměnnou mezipaměti.Pokud je zadána volba příkazového řádku i proměnná, má přednost příkazová řádka.

z důvodů zpětné kompatibility je --loglevel také akceptováno jako asynonym pro tuto volbu.

--log-context

Povolit message() příkaz výstupu souvislosti připojené k eachmessage.

Tato volba se změní na ukazující kontext pro aktuální CMake spustit pouze.Aby se zobrazuji kontextu trvalé pro všechny následné CMake běží, nastavteCMAKE_MESSAGE_CONTEXT_SHOW jako cache variabilní místo.Pokud je zadána tato volba příkazového řádku, CMAKE_MESSAGE_CONTEXT_SHOWje ignorována.

--debug-trycompile

neodstraňujte try_compile() stavět strom.Užitečné pouze na jednom try_compile() najednou.

neodstraňujte soubory a adresáře vytvořené pro volání try_compile(). To je užitečné při ladění neúspěšných try_compiles. To mayhowever změnit výsledky try-sestavuje jako starý krámy z předchozí zkusit-kompilace může způsobit různé zkušební buď projít orfail nesprávně. Tato možnost se nejlépe používá pro jeden pokus-kompilovat najednou a pouze při ladění.

--debug-output

uveďte cmake do režimu ladění.

tiskněte další informace během běhu cmake jako stopy zásobníku pomocí volánímessage(SEND_ERROR).

--debug-find

vložte příkazy cmake find do režimu ladění.

tisk extra najít informace o volání během běhu cmake na standarderror. Výstup je určen pro lidskou spotřebu a ne pro analýzu.Viz takéCMAKE_FIND_DEBUG_MODE proměnná pro ladění více lokální části projektu.

--trace

uveďte cmake do režimu trasování.

vytiskne stopu všech uskutečněných hovorů a odkud.

--trace-expand

uveďte cmake do režimu trasování.

jako --trace, ale s rozšířenými proměnnými.

--trace-format=<format>

vložte cmake do režimu trasování a nastavte výstupní formát trasování.

<format> může být jednou z následujících hodnot.

human

vytiskne každou stopovou čáru v lidsky čitelném formátu. Toto je formát default.

json-v1

vypíše každý řádek jako samostatný JSON dokument. Každý dokument je oddělen novým řádkem (\n). Je zaručeno, že nonewline znaky budou přítomny uvnitř JSON dokumentu.

JSON stopy formát:

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

členové jsou:

file

úplná cesta k CMake zdroj souboru, kde functionwas volal.

line

řádek v file volání funkce.

defer

volitelný člen, který je přítomen, když bylo volání funkce odloženo cmake_language(DEFER). Pokud je přítomen, jeho hodnota je astring obsahující odložené volání <id>.

cmd

název volané funkce.

args

seznam řetězců všech parametrů funkce.

time

časové razítko (sekundy od epochy) volání funkce.

frame

hloubka zásobníku rámce funkce, která byla volána.

kromě toho první výstup dokumentu JSON obsahuje klíčversion pro aktuální hlavní a vedlejší verzi formátu stopy

JSON:

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

členové jsou:

version

Označuje verzi formátu JSON. Verze má amajor a vedlejší komponenty podle konvencí sémantické verze.

--trace-source=<file>

Dát cmake v režimu trasování, ale výstup pouze řádky zadaného souboru.

je povoleno více možností.

--trace-redirect=<file>

vložte cmake do režimu trasování a přesměrujte výstup trasování do souboru místo stderr.

--warn-uninitialized

varovat před neinicializovanými hodnotami.

vypíše varování, pokud je použita neinicializovaná proměnná.

--warn-unused-vars

nedělá nic. Ve verzi cmake 3.2 a pod tímto povoleným varovánímpoužité proměnné. Ve verzích CMake 3.3 až 3.18 byla možnost broken.In CMake 3.19 a vyšší možnost byla odstraněna.

--no-warn-unused-cli

nevarujte před možnostmi příkazového řádku.

nenaleznete proměnné, které jsou deklarovány na příkazovém řádku, ale notused.

--check-system-vars

Najděte problémy s použitím proměnných v systémových souborech.

Normálně, nepoužité a neinicializované proměnné jsou vyhledávány v CMAKE_SOURCE_DIRCMAKE_BINARY_DIR.Tento příznak říká CMake, aby varoval před dalšími soubory.

--profiling-output=<path>

Používá se ve spojení s --profiling-format pro výstup na danou cestu.

--profiling-format=<file>

povolte výstup profilovacích dat CMake skriptu v daném formátu.

to může pomoci analýzu výkonu CMake skriptů provedených. Aplikace třetí strany by měly být použity ke zpracování výstupu do čitelného formátu.

v Současné době podporované hodnoty jsou:google-trace Výstupy v Google Stopa ve Formátu, který může být analyzován theabout:obrysu záložce Google Chrome nebo pomocí plugin pro nástroj, jako TraceCompass.

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

Čte preset<path-to-source>/CMakePresets.json<path-to-source>/CMakeUserPresets.json. Předvolba určuje generátor a adresář sestavení a volitelně seznam proměnných a dalších argumentů, které mají být předány CMake. Aktuální pracovní adresář musí obsahovatvytvořte přednastavené soubory. CMake GUI pokud nechcete rozpoznat CMakePresets.jsonCMakeUserPresets.json soubory. Podrobné informace o těchto souborech naleznete v cmake-presets(7).

předvolby se čtou před všemi ostatními možnostmi příkazového řádku. Možnosti specifikované předvolbou (proměnné, generátor atd.) mohou být všechny přepsányručně je zadejte na příkazovém řádku. Například, pokud přednastavené setsa proměnné s názvem MYVAR1, ale uživatel nastaví na 2-D argument, hodnota 2 je přednostní.

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

uvádí dostupné předvolby. Není-li zadána žádná volba, nakonfigurujte pouze přednastaveníbude uveden. Aktuální pracovní adresář musí obsahovat přednastavené soubory CMake.