add_compile_options

Добавление опций к компиляции исходных файлов.

add_compile_options(<option> ...)

Добавляет опции к свойству каталога COMPILE_OPTIONS. Эти опции используются при компиляции целевых файлов из текущего каталога и ниже.

Примечание

Эти опции не используются при линковке. Для этого используйте команду add_link_options().

Аргументы

Аргументы для add_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.

Пример

Поскольку разные компиляторы поддерживают разные опции, типичным применением этой команды является условный блок, специфичный для компилятора:

if (MSVC)
    # warning level 4
    add_compile_options(/W4)
else()
    # additional warnings
    add_compile_options(-Wall -Wextra -Wpedantic)
endif()

Для установки опций, специфичных для языка, используйте выражения генератора $<COMPILE_LANGUAGE> или $<COMPILE_LANGUAGE:languages>.

См. также

Данная команда может использоваться для добавления любых опций. Однако для добавления определений препроцессора и каталогов заголовочных файлов рекомендуется использовать более специализированные команды add_compile_definitions() и include_directories().
Команда target_compile_options() добавляет опции, специфичные для целевого файла.
Данная команда добавляет опции компиляции для всех языков. Используйте выражение генератора COMPILE_LANGUAGE для указания опций компиляции, специфичных для языка.
Свойство исходного файла COMPILE_OPTIONS добавляет опции к одному исходному файлу.
add_link_options() добавляет опции для линковки.
CMAKE_<LANG>_FLAGS и CMAKE_<LANG>_FLAGS_<CONFIG> добавляют флаги, относящиеся к языку, передаваемые во все вызовы компилятора. Это включает вызовы, которые запускают компиляцию и те, которые запускают линковку.

© 2000–2024 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/latest/command/add_compile_options.html