Allmene meddelelser¶
message( "message text" ...)
Registrer den angivne meddelelsestekst i logfilen. Hvis der er angivet mere end én meddelelsestråd, sammenkædes de til en enkelt meddelelse med næseparator mellem strengene.
Det valgfrie nøgleord <mode> bestemmer meddelelsestypen, hvilket har indflydelse på den måde, meddelelsen håndteres:
FATAL_ERROR
CMake Error, stop behandling og generering.
SEND_ERROR
CMake Error, fortsæt behandlingen, men spring generering over.
WARNING
CMake Warning, fortsæt behandlingen.
AUTHOR_WARNING
CMake Warning (dev), fortsæt behandlingen.
DEPRECATION
CMake Deprecation Error eller Warning, hvis henholdsvis variabelCMAKE_ERROR_DEPRECATED eller CMAKE_WARN_DEPRECATED er aktiveret, ellers ingen meddelelse.
(ingen) eller NOTICE
Vigtig meddelelse udskrives til stderr for at tiltrække brugerens opmærksomhed.
STATUS
De vigtigste interessante meddelelser, som projektbrugere kan være interesserede i. Ideelt set bør disse være kortfattede, ikke mere end en enkelt linje, men stadig informative.
VERBOSE
Detaljerede informationsmeddelelser, der er beregnet til projektbrugere. Disse meddelelser bør give yderligere detaljer, der ikke vil være interessante i de fleste tilfælde, men som kan være nyttige for dem, der opbygger projektet, når de ønsker dybere indsigt i, hvad der sker.
DEBUG
Detaljerede informationsmeddelelser beregnet til udviklere, der arbejder på selve projektet, i modsætning til brugere, der blot ønsker at opbygge det. Disse meddelelser vil typisk ikke være af interesse for andre brugere, der opbygger projektet, og vil ofte være tæt forbundet med interne implementeringsdetaljer.
TRACE
Fejlstændige meddelelser med implementeringsdetaljer på meget lavt niveau. Meddelelser, der anvender dette logniveau, vil normalt kun være midlertidige og forventes at blive fjernet, før projektet frigives, filerne pakkes sammen osv.
Nyt i version 3.15: Tilføjet niveauerne NOTICE, VERBOSE, DEBUG og TRACE.
CMake-kommandolinjeværktøjet viser STATUS til TRACE-meddelelser på stdout, hvor meddelelsen indledes af to bindestreger og et mellemrum. Alle andre meddelelsestyper sendes til stderr og indledes ikke med bindestreger. CMake GUI viser alle meddelelser i sit logområde. curses interface viser STATUS til TRACEmeddelelser en ad gangen på en statuslinje og andre meddelelser i en interaktiv pop-up-boks. Kommandolinjeindstillingen --log-level til hvert af disse værktøjer kan bruges til at styre, hvilke meddelelser der skal vises.
Nyt i version 3.17: For at få et logniveau til at bestå mellem CMake-kørsler kan variablenCMAKE_MESSAGE_LOG_LEVEL indstilles i stedet.Bemærk, at kommandolinjeindstillingen har forrang for cache-variablen.
Nyt i version 3.16: Meddelelser med logniveau NOTICE og derunder vil hver linje have indholdet af CMAKE_MESSAGE_INDENT-variablen (konverteret til en enkelt streng ved at sammenkæde dens listeelementer) forud for hver linje. For STATUS til TRACE-meddelelser vil dette indrykningsindhold blive indsat efter bindestregerne.
Nyt i version 3.17: Meddelelser på logniveau NOTICE og derunder kan også have hver linje indledes med en kontekst af formen . Indholdet mellem de firkantede parenteser fås ved at konvertere variablen CMAKE_MESSAGE_CONTEXTlist til en punktsepareret streng. Meddelelseskonteksten vises altid før ethvert indrykningsindhold, men efter alle automatisk tilføjede ledende bindestreger. Som standard vises beskedkonteksten ikke, den skal eksplicit aktiveres ved at angive cmake --log-contextkommandolinjeindstillingen cmake eller ved at sætte CMAKE_MESSAGE_CONTEXT_SHOWvariablen til true. Se CMAKE_MESSAGE_CONTEXT dokumentationen for brugseksempler.
CMake Advarsels- og fejlmeddelelsestekst vises ved hjælp af et simpelt markupsprog. Ikke-indrykket tekst er formateret i linjeindrammede afsnit, der er afgrænset af nye linjer. Indrykket tekst anses for at være præformateret.