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

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