COMPILE_DEFINITIONS

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

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

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