opciók¶

-S <path-to-source>

elérési út a CMake projekt gyökérkönyvtárához.

-B <path-to-build>

elérési út a könyvtárhoz, amelyet a CMake a build könyvtár gyökereként fog használni.

Ha a könyvtár még nem létezik CMake teszi.

-C <initial-cache>

a gyorsítótár feltöltéséhez előzetesen töltsön be egy szkriptet.

amikor a CMake először fut egy üres build fán, létrehoz egyCMakeCache.txt fájlt, majd betölti azt testreszabható beállításokkal a projekthez. Ez az opció használható egy fájl megadására, amelybőla gyorsítótár-bejegyzések betöltése a projekt’sCMake listfiles első áthaladása előtt. A betöltött bejegyzések elsőbbséget élveznek aa projekt alapértelmezett értékei. Az adott fájlnak cmake scriptcontaining set() parancsoknak kell lennie, amelyek a CACHE opciót használják, nem acache formátumú fájlt.

hivatkozások CMAKE_SOURCE_DIRés CMAKE_BINARY_DIR a szkripten belül értékeljük a legfelső szintű forrást és építsünk fát.

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

CMake CACHE bejegyzés létrehozása vagy frissítése.

amikor a CMake először fut egy üres build fán, létrehoz egyCMakeCache.txt fájlt, majd betölti azt testreszabható beállításokkal a projekthez. Ez az opció használható egy olyan beállítás megadására, amely elsőbbséget élvez a projekt alapértelmezett értékével szemben. Az opció annyi CACHE bejegyzést tartalmazhat, amennyit csak akar.

Ha a:<type> rész van megadva, akkor aset() parancsdokumentációnak kell lennie aCACHE aláírásához.Ha a:<type> rész elhagyásra kerül, akkor a bejegyzés nem jön létre típus nélkül, ha nem létezik már típussal. Ha az acommand a projektben PATH vagy FILEPATHtípusra állítja a típust, akkor a <value> abszolút elérési útra konvertálódik.

Ez az opció egyetlen argumentumként is megadható:-D<var>:<type>=<value>vagy -D<var>=<value>.

-U <globbing_expr>

távolítsa el a megfelelő bejegyzéseket a CMake CACHE.

Ez az opció Egy vagy több változó eltávolítására használható aCMakeCache.txt fájlból, a * és aresupported használatával. Az opció megismételhető annyi CACHE bejegyzések asdesired.

használja óvatosan, akkor lehet, hogy a CMakeCache.txt nem működik.

-G <generator-name>

adjon meg egy build rendszergenerátort.

a CMake támogathat több natív build rendszert a certainplatforms-on. A generátor felelős egy adott létrehozásáértépítési rendszer. A lehetséges generátorneveket acmake-generators(7) kézikönyv tartalmazza.

ha nincs megadva, a CMake ellenőrzi a CMAKE_GENERATOR környezetváltoztatható, és más módon visszaesik a beépített alapértelmezett kijelölésbe.

-T <toolset-spec>

eszközkészlet specifikáció a generátorhoz, ha támogatott.

néhány CMake generátor támogatja az eszközkészlet specifikációját, hogy elmondjaa natív build rendszer hogyan válasszon egy fordítót. A részletekért lásd aCMAKE_GENERATOR_TOOLSET változót.

-A <platform-name>

adja meg a platform nevét, ha a generator támogatja.

néhány CMake generátor támogatja a platform nevét, amelyet a thenative build rendszernek kell adni a fordító vagy az SDK kiválasztásához. A részletekért lásd aCMAKE_GENERATOR_PLATFORM változót.

-Wno-dev

elnyomja a fejlesztői figyelmeztetéseket.

aCMakeLists.txt fájlok szerzőjének szánt figyelmeztetések elnyomása. Alapértelmezés szerint ez is kikapcsol. pontozási figyelmeztetések.

-Wdev

fejlesztői figyelmeztetések engedélyezése.

engedélyezze aCMakeLists.txtfájlok szerzőjének szánt figyelmeztetéseket. Alapértelmezés szerint ez az értékcsökkenési figyelmeztetéseket is bekapcsolja.

-Werror=dev

fejlesztői figyelmeztetések hibái.

készítsen olyan figyelmeztetéseket, amelyek a CMakeLists.txt fileserrors szerzőjének szólnak. Alapértelmezés szerint ez az elavult figyelmeztetéseket hibaként is bekapcsolja.

-Wno-error=dev

A fejlesztői figyelmeztetések nem hibásak.

készítsen olyan figyelmeztetéseket, amelyek a CMakeLists.txt fájlok noterrors. Alapértelmezés szerint ez az elavult figyelmeztetéseket hibaként is kikapcsolja.

-Wdeprecated

az elavult funkciójelzések engedélyezése.

figyelmeztetések engedélyezése az elavult funkciók használatához, amelyek a CMakeLists.txt fájlok szerzője számára szükségesek.

-Wno-deprecated

elnyomja az elavult funkcionalitási figyelmeztetéseket.

aCMakeLists.txt fájlok szerzőjéhez tartozó elavult funkciók használatára vonatkozó figyelmeztetések elnyomása.

-Werror=deprecated

elavult makró-és funkciófigyelési hibák.

aCMakeLists.txt fájlok, hibák szerzője számára figyelmeztetéseket kell tenni az elavult makrók és funkciók használatára.

-Wno-error=deprecated

elavult makró és funkció figyelmeztetések nem hibák.

aCMakeLists.txt fájlok szerzője számára figyelmeztetéseket kell tenni az elavult makrók és funkciók használatára, nem pedig hibákat.

-L

nem haladó gyorsítótárazott változók listája.

List CACHE a változók futtatják a CMake-et, és felsorolják a CMake CACHE változókat, amelyeket nem jelölnek INTERNAL vagy ADVANCED.Ez hatékonyan megjeleníti az aktuális CMake beállításokat, amelyek ezután bechanged a opcióval. A változók egy részének megváltoztatása több változó létrehozását eredményezheti. HaA meg van adva, akkor ez leszmegjeleníti a fejlett változókat is. HaH van megadva, akkor alsodisplay segítséget minden változó.

-N

csak nézet módban.

csak a gyorsítótárat töltse be. Ne futtassa a configure and generatesteps programot.

--graphviz=

Generate graphviz of dependencies, see CMakeGraphVizOptions for more.

Hozzon létre egy graphviz bemeneti fájlt, amely tartalmazza az összes könyvtárat ésmegváltoztatható függőségek a projektben. További részletekért lásd aCMakeGraphVizOptions dokumentációját.

--system-information

Dump információk erről a rendszerről.

Dump széles körű információt az aktuális rendszer. Ha egy bináris fa tetejéről futsz egy CMake projekthez, akkor dumpadovábbi információk, például a gyorsítótár, a naplófájlok stb.

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

állítsa be a naplószintet.

a message() parancs csak a megadott vagy magasabb szintű üzeneteket jeleníti meg. Az alapértelmezett naplószint STATUS.

ahhoz, hogy a naplószint továbbra is fennmaradjon a CMake futások között, állítsa be aCMAKE_MESSAGE_LOG_LEVEL gyorsítótár változóként.Ha mind a parancssori opció, mind a változó meg van adva, akkor a parancssor elsőbbséget élvez.

visszamenőleges kompatibilitási okokból a--loglevel ezen opció szinonimájaként is elfogadásra kerül.

--log-context

engedélyezze a message() parancs kimenete összefüggésben csatolt eachmessage.

Ez az opció bekapcsolja az aktuális CMake Futtatás kontextusának megjelenítését only.To az összes későbbi CMake-futáshoz a kontextus tartós megjelenítését állítsa be aCMAKE_MESSAGE_CONTEXT_SHOW gyorsítótár-változóként.Ha ez a parancssori opció meg van adva, a CMAKE_MESSAGE_CONTEXT_SHOWfigyelmen kívül marad.

--debug-trycompile

ne törölje a try_compile() build fa.Csak akkor hasznos, egy try_compile() egy időben.

ne törölje a try_compile()hívásokhoz létrehozott fájlokat és könyvtárakat. Ez hasznos a sikertelen try_compiles hibakeresésében. Előfordulhat, hogy az aprevious try-compile-ből származó régi junk-ként a próbafordítás eredményeit nem változtatja meg, mert egy másik teszt hibás vagy hibásan halad át. Ez az opció a legjobban használható egy próbálkozáshoz-fordításkor, csak hibakereséskor.

--debug-output

helyezze a cmake-t hibakeresési módba.

további információk nyomtatása a cmake futtatása során, mint a verem nyomai amessage(SEND_ERROR) hívásokkal.

--debug-find

helyezze a cmake find parancsokat hibakeresési módban.

nyomtasson extra keresési hívásinformációkat a CMake futtatás során a standarderror-hoz. A kimenetet emberi fogyasztásra tervezték, nem elemzésre.Lásd még aCMAKE_FIND_DEBUG_MODE változó debugginga több helyi része a projekt.

--trace

helyezze a CMake-t nyomkövetési módba.

nyomtassa ki az összes hívás nyomát, ahonnan.

--trace-expand

helyezze a CMake-t nyomkövetési módba.

Like --trace, de a változók bővült.

--trace-format=<format>

helyezze a CMake-et nyomkövetési módba, majd állítsa be a trace kimeneti formátumot.

<format> lehet az alábbi értékek egyike.

human

minden nyomvonalat emberi olvasható formátumban nyomtat ki. Ez thedefault formátum.

json-v1

minden sort külön JSON dokumentumként nyomtat. Minden dokumentumot egy újsor választ el (\n). Garantált, hogy a nem újsoros karakterek jelen lesznek a JSON dokumentumban.

JSON trace format:

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

a tagok a következők:

file

a CMake forrásfájl teljes elérési útja, ahol a funkciót hívták.

line

a függvényhívásfile sorában.

defer

opcionális tag, amely a függvényhívás elhalasztásakor jelen van cmake_language(DEFER). Ha jelen van, akkor az értéke a <id>halasztott hívást tartalmazza.

cmd

a hívott függvény neve.

args

az összes funkcióparaméter karakterlánc-listája.

time

időbélyeg (másodperc a korszak óta) a függvényhívás.

frame

Stack keret mélysége a függvény, hogy hívták.

ezenkívül az első JSON-dokumentum a version kulcsot tartalmazza a

JSON trace formátum jelenlegi nagyobb és kisebb verziójához:

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

a tagok:

version

jelzi a JSON formátum verzióját. A verziónak van amajor és kisebb komponensei a szemantikai változat konvencióit követve.

--trace-source=<file>

helyezze a CMake-et nyomkövetési módba, de csak egy megadott fájl sorait adja ki.

Több lehetőség is megengedett.

--trace-redirect=<file>

helyezze a CMake-et nyomkövetési módba, majd átirányítsa a trace kimenetet egy fájlba az stderr helyett.

--warn-uninitialized

figyelmeztet a nem kezdeményezett értékekre.

figyelmeztetés kinyomtatására, ha nem kezdő változót használ.

--warn-unused-vars

nem tesz semmit. A CMake 3.2-es és alatti verzióiban ez lehetővé tette a figyelmeztetéseketa nem használt változók. A CMake 3.3-3.18 verziókban a következő volt broken.In CMake 3.19 felett az opció eltávolításra került.

--no-warn-unused-cli

ne figyelmeztesse a parancssori opciókat.

nem talál olyan változókat, amelyek a parancssorban vannak deklarálva, de nem használatosak.

--check-system-vars

problémák keresése változó használat rendszerfájlokban.

normál esetben a fel nem használt és nem kezdeményezett változókat csak a CMAKE_SOURCE_DIR és CMAKE_BINARY_DIRután kell keresni.Ez a zászló azt mondja a CMake-nek, hogy figyelmeztessen más fájlokra is.

--profiling-output=<path>

együtt használják --profiling-format A kimenet egy adott útvonal.

--profiling-format=<file>

engedélyezze a CMake szkript profilozási adatainak kimenetét az adott formátumban.

Ez segíthet a végrehajtott CMake szkriptek teljesítményelemzésében. Harmadik részalkalmazásokat kell használni a kimenet emberi olvasható formátumba történő feldolgozásához.

a jelenleg támogatott értékek a következők:google-trace kimenetek Google Trace formátumban, amelyet aabout:tracing fül a Google Chrome vagy egy plugin használata egy olyan eszközhöz, mint a TraceCompass.

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

olvas a preset<path-to-source>/CMakePresets.json és<path-to-source>/CMakeUserPresets.json. A preset megadja a generátorkönyvtárat és a build könyvtárat, valamint opcionálisan a változók és a CMake-hez továbbítandó egyéb argumentumok listáját. Az aktuális munkakönyvtárnak tartalmaznia kellkészítsen előre beállított fájlokat. A CMake GUI canalso recognize CMakePresets.json and CMakeUserPresets.json files. A fájlokkal kapcsolatos részletes információkat lásd: cmake-presets(7).

a készletek az összes többi parancssori opció előtt olvashatók. Az opciókaz előre beállított (változók, generátor stb.) mind felülírhatókanuálisan megadva őket a parancssorban. Például, ha az előre beállított készletegy MYVAR to 1 nevű változó, de a felhasználó 2 értékre állítja be-D argumentummal, az érték 2 előnyös.

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

felsorolja a rendelkezésre álló készleteket. Ha nincs megadva opció, csak konfigurálja a készleteketlistára kerül. Az aktuális munkakönyvtárnak tartalmaznia kell a CMake előre beállított fájlokat.