target_compile_options

Добавляет параметры компиляции для цели.

target_compile_options(<target> [BEFORE]
  {INTERFACE|PUBLIC|PRIVATE} <item>...
  [{INTERFACE|PUBLIC|PRIVATE} <item>...]...)

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

Аргументы

Если указано BEFORE, содержимое будет добавлено в начало свойства, а не в конец. См. политику CMP0101, которая определяет, будет ли BEFORE игнорироваться в некоторых случаях.

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

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

Удаление дубликатов параметров

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

См. также

• Эту команду можно использовать для добавления любых параметров. Однако для добавления определений препроцессора и каталогов включаемых файлов рекомендуется использовать более специализированные команды target_compile_definitions() и target_include_directories().
• Для настроек на уровне каталога предусмотрена команда add_compile_options().
• Для настроек отдельных файлов предусмотрено свойство исходного файла COMPILE_OPTIONS.
• Эта команда добавляет параметры компиляции для всех языков в цели. Используйте генераторное выражение COMPILE_LANGUAGE, чтобы задать параметры компиляции для отдельных языков.
• target_compile_features()
• target_link_libraries()
• target_link_directories()
• target_link_options()
• target_precompile_headers()
• target_sources()
• CMAKE_<LANG>_FLAGS и CMAKE_<LANG>_FLAGS_<CONFIG> добавляют флаги для всего языка, передаваемые при каждом вызове компилятора. Это относится как к вызовам, запускающим компиляцию, так и к вызовам, запускающим компоновку.
• Модуль CheckCompilerFlag позволяет проверить, поддерживает ли компилятор заданный флаг.