indstillinger¶
-C <initial-cache>
Forudindlæs et script for at udfylde cachen.
når cmake først køres i et tomt byggetræ, opretter det aCMakeCache.tekstfil og udfylder den med indstillinger, der kan tilpasses projektet. Denne indstilling kan bruges til at angive en fil, hvorfraat indlæse cache-poster før den første passage gennem projektets scmake listfiles. De indlæste poster prioriteres overprojektets standardværdier. Den givne fil skal være en CMake scriptindeholder sæt kommandoer, der bruger CACHE-indstillingen, ikke acache-format fil.
-D <var>:<type>=<value>
Opret en CMake cache-post.
når cmake først køres i et tomt byggetræ, opretter det aCMakeCache.tekstfil og udfylder den med indstillinger, der kan tilpasses projektet. Denne indstilling kan bruges til at angive en indstilling, der prioriterer projektets standardværdi. Indstillingen kan væregentaget for så mange cache-poster som ønsket.
-U <globbing_expr>
Fjern matchende poster fra CMake cache.
denne indstilling kan bruges til at fjerne en eller flere variabler fra theCMakeCache.tekstfil, globbing udtryk ved hjælp af * og ? aresupported. Indstillingen kan gentages for så mange cache-poster somønsket.
brug med omhu, du kan lave din CMakeCache.ikke-arbejdende.
-G <generator-name>
Angiv en build system generator.
CMake understøtter muligvis flere indbyggede byggesystemer på visse platforme. En generator er ansvarlig for at generere en bestemtbygningssystem. Mulige generatornavne er angivet igenerator sektion.
-T <toolset-name>
Angiv værktøjssættets navn, hvis det understøttes af generator.
nogle CMake-generatorer understøtter et værktøjssætnavn, der skal gives til det oprindelige byggesystem for at vælge en kompilator. Dette understøttes kun påspecifikke generatorer:
Visual Studio >= 10Xcode >= 3.0
se native build system dokumentation for tilladte værktøjssæt navne.
-A <platform-name>
Angiv platformnavn, hvis det understøttes af generator.
nogle CMake-generatorer understøtter et platformnavn, der skal gives til det oprindelige byggesystem for at vælge en kompilator eller SDK. Dette understøttes kun påspecifikke generatorer:
Visual Studio >= 8
se native build system dokumentation for tilladte platform navne.
-Wno-dev
undertryk udvikleradvarsler.
undertryk advarsler, der er beregnet til forfatteren afmakelister.tekst filer.
-Wdev
aktiver udvikleradvarsler.
aktiver advarsler, der er beregnet til forfatteren af CMakeLists.files.
-E
CMake kommandotilstand.
for ægte platformuafhængighed giver CMake en liste over kommandoer, der kan bruges på alle systemer. Kør med-E hjælp til brugoplysninger. Tilgængelige kommandoer er: chdir, compare_files, copy, copy_directory, copy_if_different, echo, echo_append, env,miljø, make_directory, md5sum, fjerne, remove_directory, omdøbe, sove, tjære,tid, touch, touch_nocreate. Derudover er nogle platformspecifikke kommandoerer tilgængelige. På vinduer: delete_regv, skriv_regv. Onuniks: create_symlink.
-L
liste ikke-avancerede cachelagrede variabler.
List cache-variabler kører CMake og viser alle variablerne fra CMake-cachen, der ikke er markeret som intern eller avanceret. Dette vil effektivt vise aktuelle CMake-indstillinger, som derefter kan bechanged med-D mulighed. Ændring af nogle af variablerne kan resultere i, at der oprettes flere variabler. Hvis A er angivet, så vil detvis også avancerede variabler. Hvis H er angivet, vil det ogsådisplay hjælp for hver variabel.
--build <dir>
Byg et CMake-genereret projekt binært træ.
dette abstraherer et indbygget byggeværktøjs kommandolinjegrænseflade med følgende indstillinger:
<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 uden muligheder for hurtig hjælp.
-N
kun visningstilstand.
Indlæs kun cachen. Kør faktisk ikke configure and generatesteps.
-P <file>
proces script-tilstand.
behandle den givne CMake-fil som et script skrevet i CMakelanguage. Ingen konfigurere eller generere trin udføres og cacheer ikke ændret. Hvis variabler defineres ved hjælp af-D, skal dette gøres før-p-argumentet.
--find-package
Kør i pkg-config lignende tilstand.
Søg i en pakke ved hjælp af find_package() og udskriv det resulterende flagsto stdout. Dette kan bruges til at bruge cmake i stedet for pkg-config tofind installerede biblioteker i almindelige Makefile-baserede projekter eller inautoconf-baserede projekter (via share/aclocal/cmake.m4).
--graphviz=
Generer grafvisning af afhængigheder, se Cmakegrafvisningsmuligheder.cmake for mere.
Generer en grafvis inputfil, der vil indeholde alle biblioteket ogeksekverbare afhængigheder i projektet. Se dokumentationen for makegraphvisoptioner.cmake for flere detaljer.
--system-information
Dump oplysninger om dette system.
Dump en bred vifte af oplysninger om det nuværende system. Hvis det køres fra toppen af et binært træ til et CMake-projekt, vil det dumpeyderligere oplysninger såsom cachen, logfiler osv.
--debug-trycompile
slet ikke try_compile build-træet. Kun nyttig på en try_compile ad gangen.
slet ikke de filer og mapper, der er oprettet til try_compilecalls. Dette er nyttigt i debugging mislykkedes try_compiles. Det kan dog ændre resultaterne af prøvekompilerne, da gammelt skrammel fra en tidligere prøvekompilering kan forårsage, at en anden test enten passerer eller fejler forkert. Denne mulighed bruges bedst til et forsøg-kompilere ad gangen, og kun ved fejlfinding.
--debug-output
sæt cmake i en debug-tilstand.
Udskriv ekstra ting under cmake-kørslen som stakspor med beskeder(send_error ) opkald.
--trace
sæt cmake i sporingstilstand.
Udskriv et spor af alle foretagne opkald og hvorfra medmessage(send_error ) opkald.
--warn-uninitialized
advar om uinitialiserede værdier.
Udskriv en advarsel, når der anvendes en ikke-initialiseret variabel.
--warn-unused-vars
advar om ubrugte variabler.
Find variabler, der er erklæret eller indstillet, men ikke brugt.
--no-warn-unused-cli
advar ikke om kommandolinjeindstillinger.
find ikke variabler, der er erklæret på kommandolinjen, men ikkebrugt.
--check-system-vars
Find problemer med variabel brug i systemfiler.
normalt søges ubrugte og ikke-initialiserede variabler kun i CMAKE_SOURCE_DIR og cmake_binary_dir. Dette flag fortæller CMake tiladvarsel om andre filer også.
--help,-help,-usage,-h,-H,/?
Udskriv brugsoplysninger og afslut.
brug beskriver den grundlæggende kommandolinjegrænseflade og dens indstillinger.
--version,-version,/V
Vis programnavn/version banner og afslut.
hvis en fil er angivet, skrives versionen ind i den.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.
--help-full
Udskriv alle hjælpemanualer og afslut.
alle manualer er trykt i et menneskeligt læsbart tekstformat.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.
--help-manual <man>
Udskriv en hjælpehåndbog og afslut.
den angivne manual er trykt i et menneskeligt læsbart tekstformat.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.
--help-manual-list
liste hjælp manualer til rådighed og afslut.
listen indeholder alle manualer, for hvilke hjælp kan fås ved hjælp af --help-manual valgmulighed efterfulgt af et manuelt navn.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.
--help-command <cmd>
Udskriv hjælp til en kommando og afslut.
den cmake-commands(7) manuelle indtastning for <cmd> ertrykt i et menneskeligt læsbart tekstformat.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.
--help-command-list
liste kommandoer med hjælp til rådighed og afslut.
listen indeholder alle kommandoer, for hvilke hjælp kan fås ved hjælp af --help-command valgmulighed efterfulgt af et kommandonavn.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.
--help-commands
Udskriv CMake-kommandoer manuel og afslut.
manualen cmake-commands(7) er trykt i ahuman-læsbart tekstformat.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.
--help-module <mod>
Udskriv hjælp til et modul og afslut.
den cmake-modules(7) manuelle indtastning for <mod> er udskriveti et menneskeligt læsbart tekstformat.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.
--help-module-list
liste moduler med hjælp til rådighed og afslut.
listen indeholder alle moduler, for hvilke hjælp kan fås ved hjælp af --help-module valgmulighed efterfulgt af et modulnavn.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.
--help-modules
Udskriv CMake-modules manual og afslut.
cmake-modules(7) manualen er trykt i et human-readabletekstformat.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.
--help-policy <cmp>
Udskriv hjælp til en politik og afslut.
den cmake-policies(7) manuelle indtastning for <cmp> ertrykt i et menneskeligt læsbart tekstformat.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.
--help-policy-list
liste politikker med hjælp til rådighed og afslut.
listen indeholder alle politikker, for hvilke der kan fås hjælp ved hjælp af indstillingen --help-policy efterfulgt af et politiknavn.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.
--help-policies
Udskriv CMake-politikker manual og afslut.
manualen cmake-policies(7) er trykt i ahuman-læsbart tekstformat.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.
--help-property <prop>
Udskriv hjælp til en ejendom og afslut.
de cmake-properties(7) manuelle poster for <prop> ertrykt i et menneskeligt læsbart tekstformat.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.
--help-property-list
liste egenskaber med hjælp til rådighed og afslut.
listen indeholder alle egenskaber, for hvilke hjælp kan fås ved hjælp af --help-property valgmulighed efterfulgt af et egenskabsnavn.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.
--help-properties
Udskriv CMake-egenskaber manual og afslut.
cmake-properties(7) manualen er trykt i ahuman-læsbart tekstformat.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.
--help-variable <var>
Udskriv hjælp til en variabel og afslut.
den cmake-variables(7) manuelle indtastning for <var> ertrykt i et menneskeligt læsbart tekstformat.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.
--help-variable-list
liste variabler med hjælp til rådighed og afslut.
listen indeholder alle variabler, for hvilke hjælp kan fås ved hjælp af --help-variable valgmulighed efterfulgt af et variabelnavn.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.
--help-variables
Udskriv CMake-variable manual og afslut.
cmake-variables(7) manualen er trykt i ahuman-læsbart tekstformat.Hjælpen udskrives til en navngivet < f > ile, hvis den gives.