Mensagens gerais
message( "message text" ...)
Recordar o texto da mensagem especificada no log. Se mais de uma string de mensagens for dada, elas são concatenadas em uma única mensagem com o noseparator entre as strings.
A palavra-chave opcional <mode> determina o tipo de mensagem, o que influencia a maneira como a mensagem é tratada:
FATAL_ERROR
CMake Error, pare o processamento e a geração.
SEND_ERROR
CMake Error, continue o processamento, mas pule a geração.
WARNING
CMake Warning, continue o processamento.
AUTHOR_WARNING
CMake Warning (dev), continue o processamento.
DEPRECATION
CMake Deprecation Error or Warning if variableCMAKE_ERROR_DEPRECATED or CMAKE_WARN_DEPRECATEDis enabled, respectively, else no message.
(none) or NOTICE
Important message printed to stderr to attract user’s attention.
STATUS
As principais mensagens interessantes em que os usuários do projeto podem estar interessados. O ideal é que sejam concisas, não mais do que uma linha, mas ainda assim pouco informativas.
VERBOSE
Mensagens informativas detalhadas destinadas aos usuários do projeto. Estas mensagens devem fornecer detalhes adicionais que não serão de interesse na maioria dos casos, mas que podem ser úteis para aqueles que estão construindo o projeto quando querem ter uma visão mais profunda do que está acontecendo.
DEBUG
Mensagens informativas detalhadas destinadas aos desenvolvedores que trabalham no projeto em si, ao contrário dos usuários que apenas querem construí-lo. Estas mensagens não serão tipicamente de interesse para outros usuários construindo o projeto e muitas vezes estarão intimamente relacionadas aos detalhes internos de implementação.
TRACE
Mensagens finalizadas com detalhes de implementação de nível muito baixo. Mensagens usando este nível de log normalmente seriam apenas temporárias e esperariam ser removidas antes de liberar o projeto, empacotar os arquivos, etc.
Nova na versão 3.15: Adicionadas as mensagens NOTICE, VERBOSE, DEBUG, e TRACE levels.
A ferramenta de linha de comando CMake exibe STATUS a TRACE mensagens em stdout com a mensagem precedida por dois hífens e um espaço. Todos os outros tipos de mensagem são enviados para stderr e não são prefixados com hífens. O CMake GUI mostra todas as mensagens em sua área de log. O curses interface mostra STATUS a TRACEmensagens uma de cada vez em uma linha de status e outras mensagens em uma caixa pop-up interativa. A opção --log-level para cada uma destas ferramentas pode ser usada para controlar quais mensagens serão mostradas.
Nova na versão 3.17: Para fazer um nível de log persistir entre execuções CMake, a variávelCMAKE_MESSAGE_LOG_LEVEL pode ser definida em seu lugar.Note que a opção de linha de comando tem precedência sobre a variável de cache.
Nova na versão 3.16: Mensagens de níveis de log NOTICE e abaixo terão cada linha precedida pelo conteúdo da variável CMAKE_MESSAGE_INDENT (convertida para uma única string ao concatenar seus itens de lista). Para STATUS a TRACEmessages, este conteúdo de indentação será inserido após os hífens.
Novo na versão 3.17: Mensagens de níveis de log NOTICE e abaixo também pode ter cada linha precedida pelo contexto do formulário . O conteúdo entre parênteses rectos é obtido através da conversão da variável CMAKE_MESSAGE_CONTEXTlist para uma string separada por pontos. O contexto da mensagem aparecerá sempre antes de qualquer conteúdo de recuo, mas após a adição automática de um leadinghyphens. Por padrão, o contexto da mensagem não é mostrado, ele tem que ser explicitamente ativado dando a opção cmake --log-contextlinha de comando ou definindo a opção CMAKE_MESSAGE_CONTEXT_SHOWvariável como verdadeira. Veja a documentação CMAKE_MESSAGE_CONTEXT exemplos de utilização.
CMake Warning and Error message text displays using a markuplanguage simple. O texto não-inventado é formatado em parágrafos embrulhados em linhasdelimitados por novas linhas. O texto indentado é considerado pré-formatado.