opțiuni

-S <path-to-source>

calea către directorul rădăcină al proiectului CMake pentru a construi.

-B <path-to-build>

calea către directorul pe care CMake îl va folosi ca rădăcină a directorului de construire.

În cazul în care directorul nu există deja CMake va face.

-C <initial-cache>

preîncărcați un script pentru a popula memoria cache.

când CMake este rulat pentru prima dată într-un arbore de construcție gol, creează un fișierCMakeCache.txt și îl populează cu setări personalizabile pentru proiect. Această opțiune poate fi utilizată pentru a specifica un fișier din carepentru a încărca intrările cache înainte de prima trecere prin lista de fișiere project ‘ scmake. Intrările încărcate au prioritate față de valorile implicite ale proiectului. Fișierul dat ar trebui să fie un script CMake care conține set() comenzi care utilizează CACHE opțiune, nu fișier în format acache.

referințe la CMAKE_SOURCE_DIR și CMAKE_BINARY_DIRîn script-ul evalua la sursa de nivel superior și de a construi copac.

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

creați sau actualizați o intrare CMakeCACHE.

când CMake este rulat pentru prima dată într-un arbore de construcție gol, creează un fișierCMakeCache.txt și îl populează cu setări personalizabile pentru proiect. Această opțiune poate fi utilizată pentru a specifica o setare careare prioritate față de valoarea implicită a proiectului. Opțiunea poate firepetat pentru cât mai multe intrăriCACHE după cum doriți.

dacă porțiunea:<type> este dată, aceasta trebuie să fie una dintre tipurile specificate de documentația comenziiset() pentru semnătura saCACHE.Dacă:<type> porțiunea este omisă intrarea va fi createdwith nici un tip dacă nu există cu un tip deja. Dacă acommand din proiect Setează Tipul la PATH sau FILEPATHatunci <value> va fi convertit într-o cale absolută.

această opțiune poate fi dată și ca un singur argument:-D<var>:<type>=<value> sau -D<var>=<value>.

-U <globbing_expr>

eliminați intrările potrivite din CMakeCACHE.

această opțiune poate fi utilizată pentru a elimina una sau mai multe variabile din fișierulCMakeCache.txt, expresiile globbing folosind* și? aresupported. Opțiunea poate fi repetată pentru cât mai multeCACHE intrări asdesired.

utilizați cu grijă, puteți faceCMakeCache.txt nefuncțional.

-G <generator-name>

specificați un generator de sistem construi.

CMake poate suporta mai multe sisteme native construi pe anumiteplatforme. Un generator este responsabil pentru generarea unui anumitsistem de construcție. Numele posibile ale generatorului sunt specificate în manualulcmake-generators(7).

dacă nu este specificat, CMake verificăCMAKE_GENERATOR environmentvariable și altfel revine la o selecție implicită încorporată.

-T <toolset-spec>

CAIETUL DE SARCINI set de instrumente pentru generator, dacă este acceptat.

unele generatoare CMake acceptă o specificație a setului de instrumente pentru a spune sistemului de construcție nativ cum să aleagă un compilator. Vedeți variabilaCMAKE_GENERATOR_TOOLSET pentru detalii.

-A <platform-name>

specificați numele platformei dacă este acceptat de generator.

unele generatoare CMake acceptă un nume de platformă care urmează să fie dat sistemului de construire nenativă pentru a alege un compilator sau SDK. Vedeți variabilaCMAKE_GENERATOR_PLATFORM pentru detalii.

-Wno-dev

suprima avertismente Dezvoltator.

suprima avertismente care sunt destinate pentru autorulCMakeLists.txt fișiere. În mod implicit, acest lucru se va dezactiva, de asemeneaavertizări de depreciere.

-Wdev

activați avertismentele dezvoltatorului.

activați avertismentele destinate autorului fișierelorCMakeLists.txt. În mod implicit, aceasta va activa și avertismentele de depreciere.

-Werror=dev

face erori avertismente Dezvoltator.

face avertismente care sunt destinate pentru autorulCMakeLists.txt fileserrors. În mod implicit, acest lucru va activa, de asemenea, avertismente depreciate ca erori.

-Wno-error=dev

asigurați avertismente dezvoltator nu erori.

face avertismente care sunt destinate pentru autorulCMakeLists.txt fișiere noterrors. În mod implicit, acest lucru va dezactiva, de asemenea, avertismentele depreciate ca erori.

-Wdeprecated

activați avertismentele de funcționalitate depreciate.

activați avertismente pentru utilizarea funcționalității depreciate, care sunt meantfor autorulCMakeLists.txt fișiere.

-Wno-deprecated

suprimă avertismentele de funcționalitate depreciate.

suprima avertismente pentru utilizarea funcționalității depreciate, care sunt meantfor autorulCMakeLists.txt fișiere.

-Werror=deprecated

efectuați erori de avertismente macro și funcționale depreciate.

face avertismente pentru utilizarea de macro-uri și funcții depreciate, care sunt meantfor autorulCMakeLists.txt fișiere, erori.

-Wno-error=deprecated

Faceți avertismente macro și funcționale depreciate, nu erori.

face avertismente pentru utilizarea de macro-uri și funcții depreciate, care sunt meantfor autorulCMakeLists.txt fișiere, nu erori.

-L

lista variabilelor cache non-avansate.

ListCACHE variabilele vor rula CMake și vor lista toate variabilele din CMakeCACHE care nu sunt marcate caINTERNAL sauADVANCED.Aceasta va afișa în mod eficient setările curente CMake, care pot fi schimbate cu opțiunea -D. Schimbarea unora dintre variabile poate rezultaîn mai multe variabile fiind create. DacăA este specificat, atunci vaafișează și variabile avansate. DacăH este specificat, acesta va afișa, de asemenea, ajutor pentru fiecare variabilă.

-N

numai modul de vizualizare.

încărcați numai memoria cache. Nu rulați de fapt configurarea și generațipași.

--graphviz=

genera graphviz de dependențe, a se vedeaCMakeGraphVizOptions pentru mai multe.

genera un fișier de intrare graphviz care va conține toate dependențele bibliotecă andexecutable în proiect. Consultați documentația pentru CMakeGraphVizOptions pentru mai multe detalii.

--system-information

aruncați informații despre acest sistem.

aruncați o gamă largă de informații despre sistemul actual. În cazul în care runfrom partea de sus a unui copac binar pentru un proiect CMake va dumpaditional informații, cum ar fi cache-ul, fișierele jurnal etc.

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

setați nivelul jurnalului.

message() comanda va afișa numai mesaje de nivel specificat sau mai mare. Nivelul de jurnal implicit este STATUS.

pentru a menține un nivel de jurnal între rulările CMake, setațiCMAKE_MESSAGE_LOG_LEVEL ca variabilă cache.Dacă sunt date atât opțiunea liniei de comandă, cât și variabila, opțiunea liniei de comandă are prioritate.

Din motive de compatibilitate inversă, --loglevel este de asemenea acceptat ca asinonim pentru această opțiune.

--log-context

activațimessage() comanda de ieșire context atașat la eachmessage.

această opțiune activează afișarea contextului pentru rularea CMake curentă only.To faceți afișarea contextului persistent pentru toate rulările CMake ulterioare, setațiCMAKE_MESSAGE_CONTEXT_SHOW ca variabilă cache.Când această opțiune de linie de comandă este dată, CMAKE_MESSAGE_CONTEXT_SHOWeste ignorat.

--debug-trycompile

nu ștergeți try_compile() construi copac.Numai util pe un singur try_compile() la un moment dat.

nu ștergeți fișierele și directoarele create pentrutry_compile()apeluri. Acest lucru este util în depanare a eșuat try_compiles. Se mayhowever schimba rezultatele try-compiles ca junk vechi de la aprevious try-compile poate provoca un test diferit fie trece saufail incorect. Această opțiune este utilizată cel mai bine pentru o încercare-compilați atimp, și numai atunci când depanare.

--debug-output

puneți cmake într-un mod de depanare.

imprimați informații suplimentare în timpul rulării cmake ca urme de stivă cumessage(SEND_ERROR) apeluri.

--debug-find

puneți comenzile CMake find într-un mod de depanare.

Print extra găsi informații apel în timpul CMake rula la standarderror. Producția este concepută pentru consumul uman și nu pentru analiză.A se vedea, de asemenea, CMAKE_FIND_DEBUG_MODE variabilă pentru debugginga parte mai locală a proiectului.

--trace

pune cmake în modul de urmărire.

imprimați o urmă a tuturor apelurilor efectuate și de unde.

--trace-expand

pune cmake în modul de urmărire.

ca--trace, dar cu variabile extinse.

--trace-format=<format>

pune cmake în modul trace și setează formatul de ieșire trace.

<format> poate fi una dintre următoarele valori.

human

imprimă fiecare linie de urmărire într-un format care poate fi citit de om. Acesta este formatul implicit.

json-v1

imprimă fiecare linie ca document JSON separat. Fiecare document este separat de o linie nouă (\n ). Se garantează că caracterele nonewline vor fi prezente în interiorul unui document JSON.

JSON trace format:

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

membrii sunt:

file

calea completă către fișierul sursă CMake unde a fost apelată funcția.

line

linia dinfile a apelului de funcții.

defer

membru opțional care este prezent atunci când apelul funcției a fost amânat decmake_language(DEFER). Dacă este prezent, valoarea sa este astring care conține apelul amânat <id>.

cmd

numele funcției care a fost apelată.

args

o listă șir de toți parametrii funcției.

time

Timestamp (secunde de la epocă) a apelului funcției.

frame

adâncimea cadrului stivei funcției care a fost apelată.

în plus, primul document JSON scos conțineversion cheie pentru versiunea curentă majoră și minoră a

JSON trace format:

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

membrii sunt: version

indică versiunea formatului JSON. Versiunea are componente amajor și minore în urma convențiilor versiunii semantice.

--trace-source=<file>

pune cmake în modul de urmărire, dar de ieșire numai linii de un fișier specificat.

sunt permise mai multe opțiuni.

--trace-redirect=<file>

puneți cmake în modul de urmărire și redirecționați ieșirea de urmărire către un fișier în loc de stderr.

--warn-uninitialized

avertizați despre valorile neinițializate.

imprimați un avertisment atunci când se utilizează o variabilă neinițializată.

--warn-unused-vars

nu face nimic. În CMake versiunile 3.2 și mai jos acest lucru a permis avertismente about unused variabile. În versiunile CMake 3.3 până la 3.18 opțiunea a fost broken.In CMake 3.19 și mai sus opțiunea a fost eliminată.

--no-warn-unused-cli

nu avertizați despre opțiunile liniei de comandă.

nu găsiți variabile care sunt declarate pe linia de comandă, dar nuutilizate.

--check-system-vars

găsiți probleme cu utilizarea variabilelor în fișierele de sistem.

în mod normal, variabilele neutilizate și neinițializate sunt căutate numai înCMAKE_SOURCE_DIR șiCMAKE_BINARY_DIR.Acest steag îi spune lui CMake să avertizeze și despre alte fișiere.

--profiling-output=<path>

utilizat împreună cu--profiling-format pentru a ieși la o cale dată.

--profiling-format=<file>

activați ieșirea datelor de profilare a scriptului CMake în formatul dat.

aceasta poate ajuta analiza performanței scripturilor CMake executate. A treia parteaplicațiile ar trebui utilizate pentru a procesa ieșirea în format lizibil de om.

Valorile acceptate în prezent sunt:google-trace ieșiri în format Google Trace, care pot fi analizate dedespre:fila urmărire din Google Chrome sau folosind un plugin pentru un instrument precum TraceCompass.

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

Citește un preset din<path-to-source>/CMakePresets.json și<path-to-source>/CMakeUserPresets.json. Presetarea specifică generatorul și directorul de construire și, opțional, o listă de variabile și alte argumente pentru a trece la CMake. Directorul de lucru curent trebuie să conținăface fișiere presetate. CMake GUI poate recunoaște, de asemenea, CMakePresets.json și CMakeUserPresets.json fișiere. Pentru detalii complete despre aceste fișiere, consultați cmake-presets(7).

presetările sunt citite înainte de toate celelalte opțiuni din linia de comandă. Opțiunilespecificate de presetare (variabile, generator etc.) toate pot fi suprascrise prin specificarea manuală a acestora pe linia de comandă. De exemplu, dacă presetarea setează o variabilă numită MYVAR la 1, dar utilizatorul o setează la 2 cu un-D argument, valoarea 2 este de preferat.

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

listează presetările disponibile. Dacă nu este specificată nicio opțiune, configurați numai presetărileva fi listat. Directorul de lucru curent trebuie să conțină fișiere presetate CMake.