Spec-Zone.ru › CMake 3.22

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

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

© 2000–2021 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.22/prop_sf/COMPILE_DEFINITIONS.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API