Opțiuni¶
-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ă aCMakeCache.fișier txt și populează-l cu setări personalizabile pentruproiectul. 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 comenzi setate care utilizează opțiunea CACHE, nu fișierul în format acache.
-D <var>:<type>=<value>
creați o intrare cache cmake.
când cmake este rulat pentru prima dată într-un arbore de construcție gol, creează aCMakeCache.fișier txt și populează-l cu setări personalizabile pentruproiectul. 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ări cache după cum doriți.
-U <globbing_expr>
eliminați intrările potrivite din memoria cache CMake.
această opțiune poate fi utilizată pentru a elimina una sau mai multe variabile din theCMakeCache.fișier txt, expresii globbing folosind * și ? sunt sprijinite. Opțiunea poate fi repetată pentru cât mai multe intrări cache cadorit.
utilizați cu grijă, puteți face CMakeCache.txt non-de lucru.
-G <generator-name>
specificați un generator de sistem construi.
CMake poate sprijini mai multe sisteme native construi pe anumiteplatforms. Un generator este responsabil pentru generarea unui anumitsistem de construcție. Numele posibile ale generatoarelor sunt specificate însecțiunea generatoare.
-T <toolset-name>
specificați numele setului de instrumente dacă este acceptat de generator.
unele generatoare CMake acceptă un nume de set de instrumente care trebuie dat sistemului de construire nenativă pentru a alege un compilator. Acest lucru este acceptat numai onspecific generatoare:
Visual Studio >= 10Xcode >= 3.0
consultați documentația sistemului de construire nativă pentru numele seturilor de instrumente permise.
-A <platform-name>
specificați numele platformei dacă este acceptat de generator.
unele generatoare CMake acceptă un nume de platformă care trebuie dat sistemului de construire nenativă pentru a alege un compilator sau SDK. Acest lucru este acceptat numai onspecific generatoare:
Visual Studio >= 8
consultați documentația sistemului de construire nativă pentru numele de platformă permise.
-Wno-dev
suprima avertismente Dezvoltator.
suprima avertismente care sunt destinate pentru autorul theCMakeLists.fișiere txt.
-Wdev
activați avertismentele dezvoltatorului.
activați avertismentele care sunt destinate autorului CMakeLists.txtfiles.
-E
modul de comandă CMake.
pentru adevărata independență a platformei, CMake oferă o listă de comenzi care pot fi utilizate pe toate sistemele. Rulați cu ajutorul-e pentru utilizareinformații. Comenzile disponibile sunt: chdir, compare_files,copie, copy_directory, copy_if_different, ecou, echo_append, env,mediu, make_directory, md5sum, elimina, remove_directory, redenumi, somn, gudron,timp, atingere, touch_nocreate. În plus, unele comenzi specifice platformeisunt disponibile. Pe Windows: delete_regv, write_regv. OnUNIX: create_symlink.
-L
lista variabilelor cache non-avansate.
lista variabilelor cache va rula CMake și lista tuturor variabilelor din cache-ul CMake care nu sunt marcate ca interne sau avansate. Thiswill afișa în mod eficient setările curente CMake, care poate apoi bechanged cu opțiunea-D. Schimbarea unora dintre variabile poate rezultaîn mai multe variabile fiind create. Dacă A este specificat, atunci vaafișați și variabile avansate. Dacă H este specificat, va fi, de asemeneaafișați ajutor pentru fiecare variabilă.
--build <dir>
construiți un arbore binar de proiect generat de CMake.
aceasta abstractizează interfața liniei de comandă a unui instrument de construire nativ cu următoarele opțiuni:
<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.
rulați cmake-construiți fără opțiuni pentru ajutor rapid.
-N
numai modul de vizualizare.
încărcați numai memoria cache. Nu rulați de fapt configurarea și generațipași.
-P <file>
modul script de proces.
procesați fișierul CMake dat ca un script scris în CMakelanguage. Nu configurați sau generați pasul și memoria cache nu este modificată. Dacă variabilele sunt definite folosind -D, Acest lucru trebuie să fiefăcut înainte de argumentul-P.
--find-package
Rulați în modul pkg-config.
căutați un pachet folosind find_package() și imprimați flagsto stdout rezultat. Acest lucru poate fi folosit pentru a utiliza cmake în loc de pkg-config tofind biblioteci instalate în proiecte simple bazate pe Makefile sau proiecte bazate pe neautoconf (prin share/aclocal/cmake.m4).
--graphviz=
genera graphviz de dependențe, a se vedea CMakeGraphVizOptions.cmake pentru mai multe.
generați un fișier de intrare graphviz care va conține toate dependențele bibliotecă andexecutable în proiect. Consultați documentația forCMakeGraphVizOptions.cmake pentru mai multe detalii.
--system-information
Dump 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.
--debug-trycompile
nu ștergeți arborele de construcție try_compile. Numai util pe un try_compile la un moment dat.
nu ștergeți fișierele și directoarele create pentru try_compilecalls. 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.
Print chestii suplimentare în timpul CMake rula ca stivă urme withmessage(send_error ) apeluri.
--trace
puneți cmake în modul de urmărire.
imprimați o urmă a tuturor apelurilor efectuate și de unde apeluri withmessage(send_error).
--warn-uninitialized
avertizează despre valorile neinițializate.
imprimați un avertisment atunci când se utilizează o variabilă neinițializată.
--warn-unused-vars
avertizați despre Variabilele neutilizate.
găsiți variabile care sunt declarate sau setate, dar nu sunt utilizate.
--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 variabilă în fișierele de sistem.
în mod normal, variabilele neutilizate și neinițializate sunt căutate numai în CMAKE_SOURCE_DIR și CMAKE_BINARY_DIR. Acest steag spune CMake towarn despre alte fișiere, de asemenea.
--help,-help,-usage,-h,-H,/?
tipăriți informațiile de utilizare și ieșiți.
utilizare descrie interfața liniei de comandă de bază și opțiunile sale.
--version,-version,/V
Afișați numele programului/bannerul versiunii și ieșiți.
dacă este specificat un fișier, versiunea este scrisă în el.Ajutorul este tipărit la un nume < f > ile dacă este dat.
--help-full
tipăriți toate manualele de ajutor și ieșiți.
Toate manualele sunt tipărite într-un format text care poate fi citit de om.Ajutorul este tipărit la un nume < f > ile dacă este dat.
--help-manual <man>
imprimați un manual de ajutor și ieșiți.
manualul specificat este tipărit într-un format de text care poate fi citit de om.Ajutorul este tipărit la un nume < f > ile dacă este dat.
--help-manual-list
lista manualelor de ajutor disponibile și ieșire.
lista conține toate manualele pentru care se poate obține ajutor utilizând opțiunea --help-manual urmată de un nume manual.Ajutorul este tipărit la un nume < f > ile dacă este dat.
--help-command <cmd>
imprimare ajutor pentru o comandă și ieșire.
intrarea manuală cmake-commands(7) pentru <cmd> este imprimată într-un format text care poate fi citit de om.Ajutorul este tipărit la un nume < f > ile dacă este dat.
--help-command-list
Lista de comenzi cu ajutor disponibil și ieșire.
lista conține toate comenzile pentru care ajutorul poate fi obținut prin utilizarea opțiunii --help-command urmată de un nume de comandă.Ajutorul este tipărit la un nume < f > ile dacă este dat.
--help-commands
imprimare cmake-comenzi manual și ieșire.
manualul cmake-commands(7) este tipărit într-un format text care poate fi citit de om.Ajutorul este tipărit la un nume < f > ile dacă este dat.
--help-module <mod>
imprimați ajutor pentru un modul și ieșiți.
intrarea manuală cmake-modules(7) pentru <mod> este imprimată într-un format text lizibil de om.Ajutorul este tipărit la un nume < f > ile dacă este dat.
--help-module-list
listați modulele cu ajutorul disponibil și ieșiți.
lista conține toate modulele pentru care se poate obține ajutor utilizând opțiunea --help-module urmată de un nume de modul.Ajutorul este tipărit la un nume < f > ile dacă este dat.
--help-modules
imprimare cmake-module manual și ieșire.
manualul cmake-modules(7) este tipărit într-un format de text care poate fi citit de om.Ajutorul este tipărit la un nume < f > ile dacă este dat.
--help-policy <cmp>
imprimare ajutor pentru o politică și ieșire.
intrarea manuală cmake-policies(7) pentru <cmp> este imprimată într-un format text care poate fi citit de om.Ajutorul este tipărit la un nume < f > ile dacă este dat.
--help-policy-list
listați politicile cu ajutorul disponibil și ieșiți.
lista conține toate politicile pentru care se poate obține ajutor utilizând opțiunea --help-policy urmată de un nume de politică.Ajutorul este tipărit la un nume < f > ile dacă este dat.
--help-policies
Print cmake-politici manual și de ieșire.
manualul cmake-policies(7) este tipărit într-un format text care poate fi citit de om.Ajutorul este tipărit la un nume < f > ile dacă este dat.
--help-property <prop>
ajutor de imprimare pentru o proprietate și ieșire.
intrările manuale cmake-properties(7) pentru <prop> sunt tipărite într-un format text care poate fi citit de om.Ajutorul este tipărit la un nume < f > ile dacă este dat.
--help-property-list
listați proprietățile cu ajutorul disponibil și ieșiți.
lista conține toate proprietățile pentru care se poate obține ajutor utilizând opțiunea --help-property urmată de un nume de proprietate.Ajutorul este tipărit la un nume < f > ile dacă este dat.
--help-properties
imprimare CMake-proprietăți manual și ieșire.
manualul cmake-properties(7) este tipărit într-un format text care poate fi citit de om.Ajutorul este tipărit la un nume < f > ile dacă este dat.
--help-variable <var>
ajutor de imprimare pentru o variabilă și ieșire.
intrarea manuală cmake-variables(7) pentru <var> este imprimată într-un format text care poate fi citit de om.Ajutorul este tipărit la un nume < f > ile dacă este dat.
--help-variable-list
enumerați variabilele cu ajutorul disponibil și ieșiți.
lista conține toate variabilele pentru care ajutorul poate fi obținut prin utilizarea opțiunii --help-variable urmată de un nume de variabilă.Ajutorul este tipărit la un nume < f > ile dacă este dat.
--help-variables
imprimare CMake-variabile manual și ieșire.
manualul cmake-variables(7) este tipărit într-un format text care poate fi citit de om.Ajutorul este tipărit la un nume < f > ile dacă este dat.