target_compile_options

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

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

Укажите опции компиляции, которые нужно использовать при компиляции заданного целевого объекта. Названный <target> объект должен был создан командой, такой как add_executable() или add_library(), и не должен быть целевым объектом-псевдонимом.

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

Эта команда может быть использована для добавления любых опций, но существуют альтернативные команды для добавления определений препроцессора (target_compile_definitions() и add_compile_definitions()) или каталогов включения (target_include_directories() и include_directories()). См. документацию по свойству directory и target COMPILE_OPTIONS.

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

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

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