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(), и не должен быть целевым объектом типа ПСЕВДОНИМ.

Аргументы

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

Ключевые слова 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.

См. также

Эта команда может быть использована для добавления любых опций. Однако для добавления определений препроцессора и включаемых каталогов рекомендуется использовать более специфические команды target_compile_definitions() и target_include_directories().

Для параметров на уровне каталога существует команда add_compile_options().