Allmänna meddelanden¶
message( "message text" ...)
Registrera den angivna meddelandetexten i loggen. Om mer än en meddelandetext anges sammanfogas de till ett enda meddelande med noseparator mellan strängarna.
Det valfria nyckelordet <mode> bestämmer typen av meddelande, vilketinfluerar hur meddelandet hanteras:
FATAL_ERROR
CMake Error, stop processing and generation.
SEND_ERROR
CMake Error, fortsätt bearbetningen, men hoppa över genereringen.
WARNING
CMake Warning, fortsätt bearbetningen.
AUTHOR_WARNING
CMake Warning (dev), fortsätt bearbetningen.
DEPRECATION
CMake Deprecation Error eller Warning om variabelnCMAKE_ERROR_DEPRECATED eller CMAKE_WARN_DEPRECATED är aktiverad respektive, annars inget meddelande.
(none) eller NOTICE
Betydelsefullt meddelande skrivs ut på stderr för att fånga användarens uppmärksamhet.
STATUS
De viktigaste intressanta meddelandena som projektanvändare kan vara intresserade av. Helst ska dessa vara kortfattade, inte mer än en enda rad, men ändå informativa.
VERBOSE
Detaljerade informationsmeddelanden avsedda för projektanvändare. Dessa meddelanden bör ge ytterligare detaljer som i de flesta fall inte är intressanta, men som kan vara användbara för dem som bygger projektet när de vill ha en djupare inblick i vad som händer.
DEBUG
Detaljerade informationsmeddelanden som är avsedda för utvecklare som arbetar med själva projektet i motsats till användare som bara vill bygga det. Dessa meddelanden kommer vanligtvis inte att vara av intresse för andra användare som bygger projektet och kommer ofta att vara nära relaterade till interna implementeringsdetaljer.
TRACE
Finriktade meddelanden med implementeringsdetaljer på mycket låg nivå. Meddelanden som använder denna loggnivå är normalt endast tillfälliga och förväntas tas bort innan projektet släpps, filerna paketeras etc.
Nytt i version 3.15: Nivåerna NOTICE, VERBOSE, DEBUG och TRACE har lagts till.
Cmake-kommandoradsverktyget visar STATUS till TRACE-meddelanden på stdout, med meddelandet föregånget av två bindestreck och ett blanksteg. Alla andra meddelandetyper skickas till stderr och föregås inte av bindestreck. CMake GUI visar alla meddelanden i sitt loggområde. curses interface visar STATUS till TRACEmeddelanden ett i taget på en statusrad och andra meddelanden i en interaktiv popup-rutan. Kommandoradsalternativet --log-level till vart och ett av dessa verktyg kan användas för att styra vilka meddelanden som ska visas.
Nytt i version 3.17: För att få en loggnivå att bestå mellan CMake-körningar kan variabelnCMAKE_MESSAGE_LOG_LEVEL ställas in istället.Observera att kommandoradsalternativet har företräde framför cache-variabeln.
Nytt i version 3.16: Meddelanden med loggnivå NOTICE och lägre kommer att ha varje rad föregått av innehållet i variabeln CMAKE_MESSAGE_INDENT (konverterad till en enda sträng genom att sammanfoga dess listobjekt). För STATUS till TRACE meddelanden kommer detta innehåll att införas efter bindestrecken.
Nytt i version 3.17: Meddelanden på loggnivåerna NOTICE och lägre kan också ha varje rad föregången av en kontext av formen . Innehållet mellan de fyrkantiga parenteserna erhålls genom att konvertera variabeln CMAKE_MESSAGE_CONTEXTlist till en punktseparerad sträng. Meddelandekontexten kommer alltid att visas före innehåll med indrag men efter alla automatiskt tillagda inledande bindestreck. Som standard visas inte meddelandekontexten, den måste uttryckligen aktiveras med kommandoradsalternativet cmake --log-context eller genom att ställa in variabeln CMAKE_MESSAGE_CONTEXT_SHOW till true. Se CMAKE_MESSAGE_CONTEXT dokumentationen för användningsexempel.
CMake Warning and Error message text displays using a simple markuplanguage. Text som inte är indragen formateras i radavgränsade stycken som avgränsas av nya rader. Inställd text anses vara förformaterad.