Mesaje generale¶
message( "message text" ...)
Înregistrează textul mesajului specificat în jurnal. Dacă sunt date mai multe șiruri de mesaje, acestea sunt concatenate într-un singur mesaj cu noseparator între șiruri.
Cuvântul cheie opțional <mode> determină tipul de mesaj, careinfluențează modul în care este tratat mesajul:
FATAL_ERROR
CMake Error, oprește procesarea și generarea.
SEND_ERROR
CMake Error, continuați procesarea, dar săriți generarea.
WARNING
CMake Warning, continuați procesarea.
AUTHOR_WARNING
CMake Warning (dev), continuați procesarea.
DEPRECATION
CMake Deprecation Error sau Warning dacă variabilaCMAKE_ERROR_DEPRECATED sau CMAKE_WARN_DEPRECATEDeste activată, respectiv, în caz contrar, niciun mesaj.
(niciunul) sau NOTICE
Mesaj important tipărit pe stderr pentru a atrage atenția utilizatorului.
STATUS
Principalele mesaje interesante de care utilizatorii proiectului ar putea fi interesați. în mod ideal, acestea ar trebui să fie concise, nu mai mult de un singur rând, dar totușiinformative.
VERBOSE
Mesaje informative detaliate destinate utilizatorilor proiectului. Aceste mesaje ar trebui să ofere detalii suplimentare care nu vor fi de interes în cele mai multe cazuri, dar care pot fi utile celor care construiesc proiectul atunci când doresc o înțelegere mai profundă a ceea ce se întâmplă.
DEBUG
Mesaje informative detaliate destinate dezvoltatorilor care lucrează la proiectul în sine, spre deosebire de utilizatorii care doresc doar să-l construiască. Aceste mesaje nu vor fi de obicei de interes pentru alți utilizatori care construiesc proiectul și vor fi adesea strâns legate de detalii interne de implementare.
TRACE
Mesaje detaliate cu detalii de implementare de nivel foarte scăzut. Mesajele care utilizează acest nivel de jurnal vor fi în mod normal doar temporare și se așteaptă să fie eliminate înainte de eliberarea proiectului, împachetarea fișierelor, etc.
Noi în versiunea 3.15: Au fost adăugate nivelurile NOTICE, VERBOSE, DEBUG și TRACE.
Unitatea de linie de comandă CMake afișează mesajele de la STATUS la TRACE pe stdoutcu mesajul precedat de două liniuțe și un spațiu. Toate celelalte tipuri de mesaje sunt trimise pe stderr și nu sunt precedate de cratimă. CMake GUI afișează toate mesajele în zona sa de jurnal.curses interface afișează mesajele de la STATUS la TRACE unul câte unul pe o linie de stare și alte mesaje într-o casetă pop-up interactivă. Opțiunea de linie de comandă --log-level a fiecăruia dintre aceste instrumente poate fi utilizată pentru a controla ce mesaje vor fi afișate.
Noi în versiunea 3.17: Pentru a face ca un nivel de jurnal să persiste între execuțiile CMake, se poate seta în schimb variabilaCMAKE_MESSAGE_LOG_LEVEL.Rețineți că opțiunea din linia de comandă are prioritate față de variabila cache.
Noi în versiunea 3.16: Mesajele de nivel de jurnal NOTICE și mai jos vor avea fiecare linie precedată de conținutul variabilei CMAKE_MESSAGE_INDENT (convertită într-un singur șir de caractere prin concatenarea elementelor din lista sa). Pentru mesajele de la STATUS la TRACE, acest conținut de indentare va fi inserat după liniuțe.
Noi în versiunea 3.17: Mesajele de nivel de jurnal NOTICE și mai jos pot avea, de asemenea, fiecare linie precedată de un context de forma . Conținutul dintre parantezele pătrate se obține prin conversia variabilei CMAKE_MESSAGE_CONTEXTlistă la un șir de caractere separate prin puncte. Contextul mesajului va apărea întotdeauna înainte de orice conținut de indentare, dar după orice cratimă de început adăugată automat. În mod implicit, contextul mesajului nu este afișat, acesta trebuie să fie activat în mod explicit prin opțiunea de linie de comandă cmake --log-context sau prin setarea variabilei CMAKE_MESSAGE_CONTEXT_SHOW la true. Consultați documentația CMAKE_MESSAGE_CONTEXT pentruexemple de utilizare.
CMake Textul mesajelor de avertizare și de eroare se afișează folosind un markuplanguage simplu. Textul neindentat este formatat în paragrafe înfășurate în liniidelimitate prin linii noi. Textul indentat este considerat preformatat.
.