Wiadomo¶ci ogólne¶
message( "message text" ...)
Zapisuje podany tekst komunikatu w dzienniku. Jeśli podano więcej niż jeden messagestring, są one konkatenowane w jeden komunikat z separatorem między łańcuchami.
Opcjonalne słowo kluczowe <mode> określa typ komunikatu, co wpływa na sposób jego obsługi:
FATAL_ERROR
CMake Error, zatrzymanie przetwarzania i generowania.
SEND_ERROR
CMake Error, kontynuuj przetwarzanie, ale pomiń generowanie.
WARNING
CMake Warning, kontynuuj przetwarzanie.
AUTHOR_WARNING
CMake Warning (dev), kontynuuj przetwarzanie.
DEPRECATION
CMake Deprecation Error lub Warning, jeśli zmiennaCMAKE_ERROR_DEPRECATED lub CMAKE_WARN_DEPRECATED jest włączona, odpowiednio, w przeciwnym razie brak komunikatu.
(brak) lub NOTICE
Important message printed to stderr to attract user’s attention.
STATUS
Główne interesujące wiadomości, którymi mogą być zainteresowani użytkownicy projektu.Najlepiej, aby były one zwięzłe, nie więcej niż jedna linia, ale nadal informacyjne.
VERBOSE
Szczegółowe wiadomości informacyjne przeznaczone dla użytkowników projektu. Te komunikaty powinny dostarczać dodatkowych szczegółów, które nie będą interesujące w większości przypadków, ale które mogą być użyteczne dla osób budujących projekt, gdy chcą mieć głębszy wgląd w to, co się dzieje.
DEBUG
Szczegółowe komunikaty informacyjne przeznaczone dla deweloperów pracujących nad samym projektem, w przeciwieństwie do użytkowników, którzy chcą go tylko zbudować. Te komunikaty zazwyczaj nie będą interesujące dla innych użytkowników budujących projekt i często będą ściśle związane z wewnętrznymi szczegółami implementacji.
TRACE
Dokładne komunikaty z bardzo niskim poziomem szczegółów implementacji. Komunikaty używające tego poziomu dziennika byłyby zwykle tylko tymczasowe i powinny zostać usunięte przed wydaniem projektu, spakowaniem plików itp.
Nowość w wersji 3.15: Dodano poziomy NOTICE, VERBOSE, DEBUG i TRACE.
Narzędzie wiersza poleceń CMake wyświetla na stdout komunikaty od STATUS do TRACE z komunikatem poprzedzonym dwoma myślnikami i spacją. Wszystkie inne typy komunikatów są wysyłane na stderr i nie są poprzedzane myślnikami. Model CMake GUI wyświetla wszystkie komunikaty w swoim obszarze dziennika. Model curses interface wyświetla komunikaty od STATUS do TRACE pojedynczo w wierszu stanu oraz inne komunikaty w interaktywnym wyskakującym okienku. Opcja --log-level wiersza poleceń każdego z tych narzędzi może być użyta do kontrolowania, które komunikaty będą wyświetlane.
Nowość w wersji 3.17: Aby poziom dziennika utrzymywał się między uruchomieniami CMake, można zamiast tego ustawić zmiennąCMAKE_MESSAGE_LOG_LEVEL.Zauważ, że opcja wiersza poleceń ma pierwszeństwo przed zmienną cache.
Nowość w wersji 3.16: Komunikaty o poziomach dziennika NOTICE i niższych będą miały każdy wiersz poprzedzony zawartością zmiennej CMAKE_MESSAGE_INDENT (przekształconej na pojedynczy łańcuch przez konkatenację jej elementów listy). W przypadku komunikatów od STATUS do TRACE zawartość tego wcięcia zostanie wstawiona po myślnikach.
Nowość w wersji 3.17: Komunikaty o poziomach dziennika NOTICE i niższych mogą również mieć każdy wiersz poprzedzony kontekstem w postaci . Zawartość między nawiasami kwadratowymi jest uzyskiwana przez konwersję zmiennej CMAKE_MESSAGE_CONTEXTlista na łańcuch oddzielony kropkami. Kontekst komunikatu zawsze pojawi się przed treścią wcięcia, ale po automatycznie dodanych myślnikach wiodących. Domyślnie kontekst komunikatów nie jest wyświetlany, musi być jawnie włączony przez podanie opcji wiersza poleceń cmake --log-context lub przez ustawienie zmiennej CMAKE_MESSAGE_CONTEXT_SHOW na true. Zobacz CMAKE_MESSAGE_CONTEXT dokumentację dla przykładów użycia.
Teksty ostrzeżeń i komunikatów o błędach CMake wyświetla przy użyciu prostego języka znaczników. Tekst nieindentowany jest formatowany w zawiniętych w wiersz akapitach ograniczonych znakami nowej linii. Tekst z wcięciami jest uważany za wstępnie sformatowany.
.