opcje¶
-C <initial-cache>
wstępnie załaduj skrypt, aby zapełnić pamięć podręczną.
gdy cmake jest uruchamiany po raz pierwszy w pustym drzewie kompilacji, tworzy aCMakeCache.plik txt i zapełnia go konfigurowalnymi ustawieniami dla projektu. Opcja ta może być użyta do określenia pliku, z którego można załadować wpisy pamięci podręcznej przed pierwszym przejściem przez pliki listy projektów. Załadowane wpisy mają pierwszeństwo przed domyślnymi wartościami projektu. Podany plik powinien być skryptem CMake zawierającym polecenia SET, które używają opcji CACHE, a nie plik w formacie acache.
-D <var>:<type>=<value>
Utwórz wpis cache cmake.
gdy cmake jest uruchamiany po raz pierwszy w pustym drzewie kompilacji, tworzy aCMakeCache.plik txt i zapełnia go konfigurowalnymi ustawieniami dla projektu. Ta opcja może być użyta do określenia ustawienia, którawatuje priorytet nad domyślną wartością projektu. Opcja może być ustawiona na dowolną liczbę wpisów cache.
-U <globbing_expr>
Usuń pasujące wpisy z pamięci podręcznej CMake.
ta opcja może być użyta do usunięcia jednej lub więcej zmiennych z theCMakeCache.plik txt, wyrażenia za pomocą * i ? wsparcie. Opcja może być powtórzona dla tylu wpisów pamięci podręcznej, ile jest wymaganych.
używaj ostrożnie, możesz zrobić CMakeCache.txt nie działa.
-G <generator-name>
Określ generator systemu budowania.
CMake może obsługiwać wiele natywnych systemów kompilacji na określonych platformach. Generator jest odpowiedzialny za generowanie konkretnego systemu. Możliwe nazwy generatorów są podane w sekcji generatory.
-T <toolset-name>
Określ nazwę zestawu narzędzi, jeśli jest obsługiwany przez generator.
niektóre Generatory CMake obsługują nazwę zestawu narzędzi, którą należy nadać systemowi kompilacji, aby wybrać kompilator. Jest to obsługiwane tylko na konkretnych generatorach:
Visual Studio >= 10Xcode >= 3.0
zobacz natywną dokumentację systemu budowania, aby uzyskać dozwolone nazwy zestawów narzędzi.
-A <platform-name>
Określ nazwę platformy, jeśli jest obsługiwana przez generator.
niektóre Generatory CMake obsługują nazwę platformy, którą należy nadać systemowi budowania, aby wybrać kompilator lub SDK. Jest to obsługiwane tylko na konkretnych generatorach:
Visual Studio >= 8
zobacz natywną dokumentację systemu budowania, aby uzyskać dozwolone nazwy platform.
-Wno-dev
Wyłącz Ostrzeżenia dewelopera.
Pomiń ostrzeżenia, które są przeznaczone dla Autora tekstu.pliki txt.
-Wdev
Włącz ostrzeżenia dla programistów.
Włącz Ostrzeżenia przeznaczone dla autora Cmakelistów.txtfiles.
-E
tryb komend CMake.
aby uzyskać prawdziwą niezależność od platformy, CMake dostarcza listę poleceń, które mogą być używane na wszystkich systemach. Uruchom z-E pomoc dla usageinformation. Dostępne polecenia to: chdir, compare_files,copy, copy_directory, copy_if_different, echo, echo_append, env,environment, make_directory, md5sum, remove, remove_directory, rename, sleep, tar,time, touch, touch_nocreate. Ponadto dostępne są niektóre polecenia specyficzne dla platformy. W systemie Windows: delete_regv, write_regv. Onunix: create_symlink.
-L
lista niezaangażowanych zmiennych buforowanych.
lista zmiennych bufora uruchomi CMake i wyświetli listę wszystkich zmiennych z bufora CMake, które nie są oznaczone jako wewnętrzne lub zaawansowane. To będzie skutecznie wyświetlać aktualne ustawienia CMake, które następnie mogą być zmieniane za pomocą opcji – D. Zmiana niektórych zmiennych może skutkować tworzeniem kolejnych zmiennych. Jeśli zostanie określone A, wtedy będzie odtwarzać również zaawansowane zmienne. Jeśli podano H, będzie on również odtwarzał pomoc dla każdej zmiennej.
--build <dir>
Zbuduj drzewo binarne projektu generowane przez CMake.
ten abstrahuje natywny interfejs wiersza poleceń narzędzia do budowania z opcjami następnymi:
<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.
Uruchom cmake-build bez opcji szybkiej pomocy.
-N
tylko tryb wyświetlania.
ładuj tylko pamięć podręczną. Nie uruchamiaj configure i generatesteps.
-P <file>
tryb skryptu procesowego.
przetwarza podany plik cmake jako skrypt napisany w języku CMakelanguage. Nie jest wykonywany żaden krok konfiguracji ani generowania, a pamięć podręczna nie jest modyfikowana. Jeśli zmienne są zdefiniowane za pomocą-D, musi to być poprzedzone argumentem-P.
--find-package
Uruchom w trybie pkg-config.
wyszukaj pakiet za pomocą find_package () i wydrukuj wynikowe znaczniki na standardowe wyjście. Może to być użyte do użycia cmake zamiast pkg-config, aby znaleźć zainstalowane biblioteki w zwykłych projektach opartych na plikach Makefile lub projektach opartych na autoconf (poprzez share/aclocal/cmake.m4).
--graphviz=
generowanie graphviz zależności, patrz CMakeGraphVizOptions.cmake więcej.
Wygeneruj plik wejściowy graphviz, który będzie zawierał wszystkie biblioteki i możliwe zależności w projekcie. Zobacz dokumentację forCMakeGraphVizOptions.cmake po więcej szczegółów.
--system-information
wyrzuć informacje o tym systemie.
wyrzuć szeroki zakres informacji o aktualnym systemie. Jeśli zostanie uruchomiony z góry drzewa binarnego dla projektu CMake, zrzuci dodatkowe informacje, takie jak pamięć podręczna, pliki dziennika itp.
--debug-trycompile
nie usuwaj drzewa kompilacji try_compile. Użyteczny tylko na jednym try_compile naraz.
nie usuwaj plików i katalogów utworzonych dla try_compilecalls. Jest to przydatne przy debugowaniu nieudanych try_compiles. Może się jednak zdarzyć, że zmiana wyników try-compiles jako starych śmieci z previous TRY-compile może spowodować, że inny test albo przejdzie, albo napisze się nieprawidłowo. Ta opcja jest najlepsza dla jednej próby-kompilacji atime i tylko podczas debugowania.
--debug-output
umieść cmake w trybie debugowania.
drukuje dodatkowe rzeczy podczas uruchamiania cmake, takie jak ślady stosu za pomocą wywołań message(send_error).
--trace
Ustaw cmake w trybie śledzenia.
wyświetla ślad wszystkich wykonanych połączeń i skąd wywołania withmessage (send_error).
--warn-uninitialized
ostrzegaj o niezainicjalizowanych wartościach.
wypisuje ostrzeżenie, gdy używana jest niezainicjalizowana zmienna.
--warn-unused-vars
ostrzegaj o nieużywanych zmiennych.
Znajdź zmienne, które są zadeklarowane lub ustawione, ale nie są używane.
--no-warn-unused-cli
nie ostrzegaj o opcjach linii poleceń.
nie znajduj zmiennych, które są zadeklarowane w wierszu poleceń, ale nie są używane.
--check-system-vars
Znajdź problemy z użyciem zmiennych w plikach systemowych.
Zwykle nieużywane i niezainicjalizowane zmienne są wyszukiwane tylko w CMAKE_SOURCE_DIR i CMAKE_BINARY_DIR. Ta flaga mówi CMake towarn o innych plikach, jak również.
--help,-help,-usage,-h,-H,/?
wypisuje informacje o użytkowaniu i kończy pracę.
użycie opisuje podstawowy interfejs wiersza poleceń i jego opcje.
--version,-version,/V
Pokaż nazwę programu/banner wersji i zakończ.
jeśli podany jest plik, zapisywana jest do niego wersja.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.
--help-full
Wydrukuj wszystkie instrukcje pomocy i zakończ.
wszystkie podręczniki są drukowane w formacie tekstowym czytelnym dla człowieka.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.
--help-manual <man>
Wydrukuj jedną instrukcję pomocy i zakończ.
podany podręcznik jest drukowany w formacie tekstowym czytelnym dla człowieka.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.
--help-manual-list
Wyświetl dostępne instrukcje pomocy i zakończ.
lista zawiera wszystkie podręczniki, dla których pomoc można uzyskać, używając opcji --help-manual
, po której następuje nazwa podręcznika.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.
--help-command <cmd>
wypisuje pomoc dla jednego polecenia i kończy pracę.
cmake-commands(7)
wpis ręczny dla <cmd>
jest wydrukowany w formacie tekstowym czytelnym dla człowieka.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.
--help-command-list
wyświetla polecenia z dostępną pomocą i kończy działanie.
lista zawiera wszystkie polecenia, dla których pomoc można uzyskać, używając opcji --help-command
, po której następuje nazwa polecenia.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.
--help-commands
Drukuj CMake-polecenia ręcznie i zakończ.
Instrukcja cmake-commands(7)
jest drukowana w formacie tekstowym czytelnym dla ludzi.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.
--help-module <mod>
wypisuje pomoc dla jednego modułu i kończy pracę.
cmake-modules(7)
wpis ręczny dla <mod>
jest drukowany w formacie tekstowym czytelnym dla człowieka.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.
--help-module-list
lista modułów z dostępną pomocą i wyjście.
lista zawiera wszystkie moduły, dla których pomoc można uzyskać, używając opcji --help-module
, po której następuje nazwa modułu.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.
--help-modules
Drukuj instrukcję obsługi cmake-modules i zakończ.
podręcznik cmake-modules(7)
jest drukowany w formacie human-readabletext.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.
--help-policy <cmp>
Drukuj pomoc dla jednej zasady i zakończ.
cmake-policies(7)
wpis ręczny dla <cmp>
jest wydrukowany w formacie tekstowym czytelnym dla człowieka.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.
--help-policy-list
Wyświetla listę zasad z dostępną pomocą i kończy działanie.
lista zawiera wszystkie zasady, dla których pomoc można uzyskać, używając opcji --help-policy
, po której następuje nazwa Zasady.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.
--help-policies
Drukuj podręcznik CMake-policies i zakończ.
Instrukcja cmake-policies(7)
jest drukowana w formacie tekstowym czytelnym dla ludzi.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.
--help-property <prop>
wypisuje pomoc dla jednej właściwości i kończy działanie.
wpisy instrukcji cmake-properties(7)
dla <prop>
są drukowane w formacie tekstowym czytelnym dla człowieka.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.
--help-property-list
Wyświetla właściwości z dostępną pomocą i kończy działanie.
lista zawiera wszystkie właściwości, dla których pomoc można uzyskać, używając opcji --help-property
, po której następuje nazwa właściwości.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.
--help-properties
Wydrukuj instrukcję cmake-properties i zakończ.
Instrukcja cmake-properties(7)
jest drukowana w formacie tekstowym czytelnym dla ludzi.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.
--help-variable <var>
wypisuje pomoc dla jednej zmiennej i kończy działanie.
cmake-variables(7)
wpis ręczny dla <var>
jest wydrukowany w formacie tekstowym czytelnym dla człowieka.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.
--help-variable-list
wyświetla zmienne z dostępną pomocą i kończy działanie.
lista zawiera wszystkie zmienne, dla których można uzyskać pomoc przy użyciu opcji --help-variable
, po której następuje nazwa zmiennej.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.
--help-variables
Drukuj CMake-zmienne manual i zakończ.
Instrukcja cmake-variables(7)
jest drukowana w formacie tekstowym czytelnym dla ludzi.Pomoc jest drukowana na nazwanym < f> ile, jeśli jest podana.