COMPILE_DEFINITIONS

Препроцессорные определения для компиляции исходных файлов каталога.

Это свойство задаёт список опций, предоставленных до сих пор команде add_compile_definitions() (или add_definitions()).

Свойство COMPILE_DEFINITIONS можно задать как список препроцессорных определений, разделённых точкой с запятой, используя синтаксис VAR или VAR=value. Определения в стиле функций не поддерживаются. CMake автоматически правильно экранирует значение для системной сборки (обратите внимание, что синтаксис языка CMake может потребовать экранирования для задания некоторых значений).

Это свойство будет инициализировано в каждом каталоге значением из родительского каталога.

CMake автоматически удалит некоторые определения, которые не поддерживаются используемым инструментом сборки.

Оговорка: большинство инструментов системной сборки плохо поддерживают экранирование определённых значений. CMake имеет обходные пути для многих случаев, но некоторые значения могут просто не быть правильно переданы. Если значение не кажется правильно экранированным, не пытайтесь обойти проблему, добавляя последовательности экранирования в значение. Ваш обходной путь может сломаться в будущей версии CMake, у которой улучшена поддержка экранирования. Вместо этого подумайте о определении макроса в (настроенном) файле заголовков. Затем сообщите об ограничении. Известные ограничения включают:

#          - broken almost everywhere
;          - broken in VS IDE 7.0 and Borland Makefiles
,          - broken in VS IDE
%          - broken in some cases in NMake
& |        - broken in some cases on MinGW
^ < > \"   - broken in most Make tools on Windows

CMake не отбрасывает эти значения сразу, так как они работают в некоторых случаях. Используйте с осторожностью.

Содержимое COMPILE_DEFINITIONS может использовать «генераторские выражения» с синтаксисом $<...>. Обратитесь к руководству cmake-generator-expressions(7) для доступных выражений. Обратитесь к руководству cmake-buildsystem(7) для получения дополнительной информации об определении свойств системы сборки.

Соответствующее свойство COMPILE_DEFINITIONS_<CONFIG> можно задать для указания определений для каждой конфигурации. Вместо задания альтернативного свойства рекомендуется использовать генераторские выражения.