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> может быть задано для указания определений для каждой конфигурации. Вместо настройки альтернативного свойства следует использовать генераторские выражения.