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