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 target.

Аргументы

Если 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–2021 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.22/command/target_compile_options.html