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 указано, содержимое будет добавлено в начало свойства, а не в конец. См. политику CMP0101, которая влияет на то, будет ли BEFORE игнорироваться в определенных случаях.
Ключевые слова INTERFACE, PUBLIC и PRIVATE необходимы для указания области применения следующих аргументов. Элементы PRIVATE и PUBLIC будут заполнять свойство COMPILE_OPTIONS целевого объекта <target>. Элементы PUBLIC и INTERFACE будут заполнять свойство INTERFACE_COMPILE_OPTIONS целевого объекта <target>. Следующие аргументы задают опции компиляции. Повторные вызовы для тех же <target> добавляют элементы в порядке вызова.
Новое в версии 3.11: Возможность устанавливать INTERFACE элементы для импортированных целевых объектов.
Аргументы к target_compile_options могут использовать выражения генератора с синтаксисом $<...>. См. руководство cmake-generator-expressions(7) для доступных выражений. См. руководство cmake-buildsystem(7) для получения дополнительной информации о определении свойств системы построения.
Устранение дублирования опций
Набор опций, используемых для целевого объекта, строится путём накопления опций текущего целевого объекта и требований его зависимостей. Набор опций дублируется для предотвращения повторений.
Новое в версии 3.12: Хотя это полезно для отдельных опций, этап дублирования может разрывать группы опций. Например, -option A -option B становится -option A B. Можно указать группу опций, используя оболочечные кавычки вместе с префиксом SHELL:. Префикс SHELL: удаляется, а остальная часть строки опций анализируется с использованием режима separate_arguments() UNIX_COMMAND. Например, "SHELL:-option A" "SHELL:-option B" становится -option A -option B.
См. также
- Эта команда может использоваться для добавления любых опций. Однако для добавления определений препроцессора и каталогов заголовков рекомендуется использовать более специфичные команды
target_compile_definitions()иtarget_include_directories(). - Для настроек на уровне каталога существует команда
add_compile_options(). - Для настроек на уровне файла существует свойство файла исходного кода
COMPILE_OPTIONS. target_compile_features()target_link_libraries()target_link_directories()target_link_options()target_precompile_headers()target_sources()
© 2000–2023 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.26/command/target_compile_options.html