COMPILE_DEFINITIONS

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

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

CMake автоматически удаляет некоторые определения, которые не поддерживаются родным инструментом сборки. Xcode не поддерживает определения на уровне конфигурации для исходных файлов.

Оговорка: большинство родных инструментов сборки слабо поддерживают экранирование определенных значений. 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-generator-expressions(7) руководство для доступных выражений. Однако Xcode не поддерживает настройки на уровне конфигурации для каждого исходного файла, поэтому выражения, зависящие от конфигурации сборки, не разрешены с этим генератором.

Выражения генератора следует предпочесть вместо установки альтернативного свойства на уровне конфигурации.