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 target.

Аргументы

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

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

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

Окончательный набор параметров компиляции или компоновки, используемых для цели, создается путем накопления параметров из текущей цели и требований к использованию ее зависимостей. Набор параметров дедуплицируется, чтобы избежать повторения. Хотя это полезно для отдельных параметров, шаг дедупликации может разбить группы параметров. Например, -D A -D B становится -D A B. Можно указать группу параметров, используя кавычки, похожие на shell, вместе с префиксом 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().