target_compile_options

Добавление опций компиляции для целевого объекта.

target_compile_options(<target> [BEFORE]
  <INTERFACE|PUBLIC|PRIVATE> [items1...]
  [<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])

Добавляет опции к свойствам целевого объекта COMPILE_OPTIONS или INTERFACE_COMPILE_OPTIONS. Эти опции используются при компиляции заданного <target>, который должен быть создан командой, такой как add_executable() или add_library(), и не должен быть целевым объектом типа ALIAS.

Аргументы

Если BEFORE указано, содержимое будет добавлено в начало свойства, а не в конец.

Ключевые слова INTERFACE, PUBLIC и PRIVATE необходимы для определения области действия следующих аргументов. PRIVATE и PUBLIC элементы будут заполнять свойство COMPILE_OPTIONS объекта <target>. PUBLIC и INTERFACE элементы будут заполнять свойство INTERFACE_COMPILE_OPTIONS объекта <target>. Следующие аргументы задают опции компиляции. Повторные вызовы для одного и того же <target> добавляют элементы в порядке вызова.

Новое в версии 3.11: Разрешает установку INTERFACE элементов для импортированных целевых объектов.

Аргументы для target_compile_options могут использовать "генераторные выражения" с синтаксисом $<...>. Смотрите руководство cmake-generator-expressions(7) для доступных выражений. Смотрите руководство cmake-buildsystem(7) для получения дополнительной информации об определении свойств системы сборки.

Исключение дублирования опций

Окончательный набор опций, используемых для целевого объекта, формируется путём накопления опций текущего целевого объекта и требований к зависимым объектам. Набор опций исключает дублирование для избежания повторений.

Новое в версии 3.12: Хотя это выгодно для отдельных опций, этап исключения дублирования может разрывать группы опций. Например, -option A -option B превращается в -option A B. Можно задать группу опций с помощью оболочковых кавычек вместе с префиксом SHELL:. Префикс SHELL: отбрасывается, а остальная часть строки опций анализируется с использованием режима separate_arguments() UNIX_COMMAND. Например, "SHELL:-option A" "SHELL:-option B" превращается в -option A -option B.

См. также

Эта команда может быть использована для добавления любых опций. Однако для добавления определений препроцессора и каталогов включения рекомендуется использовать более специфичные команды target_compile_definitions() и target_include_directories().

Для настроек на уровне каталога существует команда add_compile_options().

Для настроек на уровне файлов существует свойство файла исходного кода COMPILE_OPTIONS.

© 2000–2022 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.23/command/target_compile_options.html