Obecné zprávy¶
message( "message text" ...)
Zaznamená zadaný text zprávy do protokolu. Pokud je zadáno více než jeden řetězec zpráv, jsou spojeny do jedné zprávy s nosným oddělovačem mezi řetězci.
Nepovinné klíčové slovo <mode> určuje typ zprávy, kterýovlivňuje způsob zpracování zprávy:
FATAL_ERROR
CMake Error, stop zpracování a generování.
SEND_ERROR
CMake Error, pokračujte ve zpracování, ale vynechejte generování.
WARNING
CMake Warning, pokračujte ve zpracování.
AUTHOR_WARNING
CMake Warning (dev), pokračujte ve zpracování.
DEPRECATION
CMake Deprecation Error nebo Warning, pokud je povolena proměnnáCMAKE_ERROR_DEPRECATED, respektive CMAKE_WARN_DEPRECATED, jinak žádná zpráva.
(žádná) nebo NOTICE
Důležitá zpráva vypsaná na stderr, aby upoutala pozornost uživatele.
STATUS
Hlavní zajímavé zprávy, které by mohly uživatele projektu zajímat. v ideálním případě by měly být stručné, ne více než jednořádkové, ale přestoinformativní.
VERBOSE
Podrobné informační zprávy určené pro uživatele projektu. Tyto zprávy by měly poskytovat další podrobnosti, které nebudou ve většině případů zajímavé, ale které mohou být užitečné pro ty, kteří projekt vytvářejí, když chtějí získat hlubší vhled do toho, co se děje.
DEBUG
Podrobné informační zprávy určené pro vývojáře, kteří pracují na samotném projektu, na rozdíl od uživatelů, kteří jej chtějí pouze vytvořit. Tyto zprávy obvykle nebudou zajímat ostatní uživatele, kteří projekt budují, a často budou úzce souviset s interními implementačními detaily.
TRACE
Podrobné zprávy s velmi nízkou úrovní implementačních detailů. Zprávy používající tuto úroveň protokolu by obvykle byly pouze dočasné a očekávalo by se, že budou odstraněny před vydáním projektu, zabalením souborů atd.
Novinka ve verzi 3.15: Přidány úrovně NOTICE, VERBOSE, DEBUG a TRACE.
Nástroj příkazového řádku CMake zobrazuje na stdout zprávy STATUS až TRACE, přičemž zprávě předcházejí dvě pomlčky a mezera. Všechny ostatní typy zprávjsou odesílány na stderr a nejsou uvozeny pomlčkami. PříkazCMake GUI zobrazuje všechny zprávy ve své oblasti protokolu.curses interface zobrazuje STATUS až TRACEzprávy po jedné na stavovém řádku a ostatní zprávy v interaktivním vyskakovacím okně. Volbou --log-level příkazového řádku ke každému z těchto nástrojů lze řídit, které zprávy se zobrazí.
Novinka ve verzi 3.17: Chcete-li, aby úroveň protokolu přetrvávala mezi spuštěními CMake, lze místo ní nastavit proměnnouCMAKE_MESSAGE_LOG_LEVEL.Všimněte si, že volba příkazového řádku má přednost před proměnnou cache.
Novinka ve verzi 3.16: Zprávy úrovně protokolu NOTICE a nižší budou mít před každým řádkem obsah proměnné CMAKE_MESSAGE_INDENT (převedené najediný řetězec spojením položek jejího seznamu). U zpráv STATUS až TRACE bude tento obsah odsazení vložen za pomlčky.
Nově ve verzi 3.17: Zprávy úrovně protokolu NOTICE a nižší mohou mít před každým řádkem také kontext ve tvaru . Obsah mezi hranatými závorkami se získá převodem proměnné CMAKE_MESSAGE_CONTEXTseznam na řetězec oddělený tečkami. Kontext zprávy se vždy objeví před jakýmkoli obsahem odsazení, ale za jakýmikoli automaticky přidanými úvodnímislovy. Ve výchozím nastavení se kontext zprávy nezobrazuje, musí být explicitnězapnut zadáním volby cmake --log-contextpříkazového řádku nebo nastavením proměnné CMAKE_MESSAGE_CONTEXT_SHOW na hodnotu true. Příklady použití naleznete v CMAKE_MESSAGE_CONTEXTdokumentaci.
CMake text varovných a chybových zpráv zobrazuje pomocí jednoduchého značkovacího jazyka. Text bez odrážek je formátován v odstavcích ohraničených novými řádky. Odsazený text je považován za předformátovaný.