Spec-Zone.ru › CMake 3.31

COMPILE_DEFINITIONS

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

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

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

Добавлен в версии 3.26: Любой ведущий -D в элементе будет удален.

Отказ от ответственности: Большинство системных инструментов сборки слабо поддерживают экранирование определённых значений. CMake имеет обходные пути для многих случаев, но некоторые значения могут просто не быть правильно переданы. Если значение, по-видимому, не экранируется правильно, не пытайтесь обойти проблему, добавляя escape-последовательности в значение. Ваш обходной путь может сломаться в будущей версии 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–2024 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.31/prop_sf/COMPILE_DEFINITIONS.html

Spec-Zone.ru

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