Advanced¶
zaawansowani użytkownicy mogą być ponadto zainteresowani ustawieniami następujących opcji, które w większości przypadków są automatycznie pobierane z nie zaawansowanych opcji CMake. Aby wyświetlić te opcje w interfejsie graficznym CMake, naciśnij klawisz t w ccmake (Unix) lub zaznacz pole Show Advanced Values (Windows).
-DBASIS_ALL_DOC:BOOL¶
Zażądaj zbudowania wszystkich celów dokumentacji w ramach ALL targetif BUILD_DOCUMENTATION to ON.
-DBASIS_COMPILE_SCRIPTS:BOOL¶
Włącz kompilację modułów Pythona. Jeśli ta opcja jest włączona, instalowane są tylko skompilowane pliki .pyc.
-DBASIS_COMPILE_MATLAB:BOOL¶
czy skompilować źródła MATLAB za pomocą kompilatora MATLAB (mcc), jeśli jest dostępny.Jeśli jest ustawione na OFF, pliki źródłowe MATLAB są kopiowane jako część instalacji, a skrypt Bash do wykonania matlab z opcją -c jest generowany odpowiednio na Uniksie lub skrypcie poleceń Windows NT w systemie Windows. Pozwala to na wygodne wykonanie pliku wykonywalnego zaimplementowanego w MATLAB nawet bez posiadania alicense dla kompilatora MATLAB. Każda instancja zbudowanego pliku wykonywalnego zajmie jednak jedną licencję MATLAB. Co więcej, uruchamianie pliku wykonywalnego jest dłuższe za każdym razem, nie tylko przy pierwszym uruchomieniu, jak ma to miejsce w przypadku kompilacji mcc executables.It dlatego zaleca się włączenie tej opcji i uzyskanie licencji kompilatora MATLAB, jeśli to możliwe. Domyślnie ta opcja to ON.
-DBASIS_DEBUG:BOOL¶
Włącz debugowanie wiadomości podczas konfiguracji kompilacji.
-DBASIS_INSTALL_APIDOC_DIR:PATH¶
katalog instalacyjny dokumentacji API względem prefiksu instalacji.
-DBASIS_INSTALL_RPATH:BOOL¶
czy BASIS ma ustawić odpowiednią właściwość INSTALL_RPATH bibliotek wykonywalnych i shared zamiast CMake. Opcja ta jest domyślnie ON, która jest zgodna ze standardem bazowym. Zauważ, że ta opcja może zostać nadpisana przez twórcę projektu lub w wierszu poleceń przez ustawienie zmiennej variableCMAKE_SKIP_RPATH NA FALSE. Odbywa się to typowo w config / Settings.cmake.
-DBASIS_INSTALL_SCHEME:STRING¶
schemat instalacji, tj. hierarchia systemu plików, używany do instalacji plików oprogramowania względem prefiksu instalacji określonego przez -DCMAKE_INSTALL_PREFIX.Poprawne wartości to default, usr, opt, lub win. Zobacz Instalacja Treeas zdefiniowany przez układ systemu plików BASIS po więcej szczegółów.
-DBASIS_INSTALL_SITE_DIR:PATH¶
katalog instalacyjny strony www względem prefiksu instalacyjnego.
-DBASIS_INSTALL_SITE_PACKAGES:BOOL¶
czy instalować publiczne biblioteki modułów napisane w języku skryptowym, takim jak asPython lub Perl, w domyślnych lokalizacjach całego systemu dla pakietów witryny. Opcja ta jest domyślnie wyłączona, ponieważ w przeciwnym razie wymagane są prawa zapisu do tych katalogów.
-DBASIS_MCC_FLAGS:STRING¶
dodatkowe flagi dla kompilatora MATLAB oddzielone spacjami.
-DBASIS_MCC_MATLAB_MODE:BOOL¶
czy wywołać kompilator MATLAB w trybie MATLAB. Jeśli ON, kompilator MATLAB jest wywoływany z sesji interpretera MATLAB, co skutkuje natychmiastowym wydaniem licencji kompilatora MATLAB po zakończeniu kompilacji.W przeciwnym razie licencja jest zarezerwowana na określony czas(np.
-DBASIS_MCC_RETRY_ATTEMPTS:INT¶
wiele razy kompilacja celu kompilatora MATLAB jest powtarzana w przypadku błędu kasowania licencji.
-DBASIS_MCC_RETRY_DELAY:INT¶
opóźnienie w liczbie sekund pomiędzy ponownymi próbami budowania celów kompilatora MATLAB po wystąpieniu błędu alicense checkout.
-DBASIS_MCC_TIMEOUT:INT¶
limit czasu w sekundach na zbudowanie celu kompilatora MATLAB. Jeśli budowa celu nie może zostać ukończona w określonym czasie, budowa jest przerywana.
-DBASIS_MEX_FLAGS:STRING¶
dodatkowe flagi dla skryptu MEX oddzielone spacjami.
-DBASIS_MEX_TIMEOUT:INT¶
limit czasu w sekundach dla kompilacji plików MEX.
-DBASIS_REGISTER:BOOL¶
czy zarejestrować zainstalowany pakiet w rejestrze pakietów CMake. Opcja ta jest domyślnie włączona tak, że pakiety są znalezione przez CMake, gdy są wymagane przez inne pakiety oparte na tym narzędziu kompilacyjnym.
-DBASIS_SUPERBUILD_MODULES:BOOL¶
eksperymentalne Włącz superbuild modułów projektu. W przypadku projektów z dużą liczbą modułów może to znacznie skrócić czas konfiguracji systemu budowania, ponieważ konfiguracja każdego modułu jest odroczona do etapu budowania.Superbuild modułów jest domyślnie wyłączony.Więcej informacji: Superbuild of Modules.
-DBASIS_VERBOSE:BOOL¶
Włącz gadatliwe wiadomości podczas konfiguracji kompilacji.
-DBUILD_BASIS_UTILITIES_FOR_<LANG>:BOOL¶
domyślnie narzędzia bazowe dla danego języka programowania są budowane tylko wtedy, gdy każdy z celów wykonywalnych projektu lub biblioteki zbudowanych z kodu źródłowego w języku docelowym korzysta z tych narzędzi. Użyj tych opcji, aby wymusić zbudowanie podstawowych narzędzi dla danego języka. Nawet jeśli nie jest używany przez sam projekt, wygenerowane funkcje narzędziowe i pliki nagłówków lub skryptów mogą być używane przez inny projekt, aby uzyskać dostęp do metadanych projektu, takich jak jego nazwa i Wersja, poprzez włączenie odpowiednich narzędzi bazowych dla danego projektu.
-DBUILD_CHANGELOG:BOOL¶
poproś o zbudowanie changelogu jako elementu docelowego ALL. Zauważ, że changelog jest generowany albo z historii Subversion, jeśli drzewo źródłowe jest kopią SVNworking, albo z historii Git, jeśli jest repozytorium Git. W przeciwnym razie nie można wygenerować dziennika zmian i ta opcja jest ponownie wyłączona przez BASIS.In w przypadku Subversion, należy pamiętać, że generowanie dziennika zmian zajmuje kilka minut i może wymagać wprowadzenia poświadczeń użytkownika w celu uzyskania dostępu do repozytorium Subversion. Zaleca się pozostawienie tej opcji wyłączonej i zbudowanie celu changelog oddzielonego od reszty pakietu oprogramowania (patrz tworzenie oprogramowania).
-DBUILD_MODULES_BY_DEFAULT::BOOL¶
czy domyślnie włączyć Moduły projektu (np. podprojekty), czy nie. Ta opcja działa tylko wtedy, gdy jest podana bezpośrednio w wierszu poleceń podczas wywoływania odpowiednio cmake lubccmake. W przeciwnym razie wartość domyślna tej opcji zostanie użyta do uruchomienia pierwszej konfiguracji systemu kompilacji, która dodaje już Opcje MODULE_*i ustawia je na odpowiednie domyślne (TRUE). Wartość domyślna nie może być nadpisana kolejnymi uruchomieniami konfiguracyjnymi, chyba że same opcje MODULE_*zostaną zmienione.
-DITK_DIR:PATH