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.