add_compile_options

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

add_compile_options(<option> ...)

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

Аргументы

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

Пример

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

if (MSVC)
    # warning level 4 and all warnings as errors
    add_compile_options(/W4 /WX)
else()
    # lots of warnings and all warnings as errors
    add_compile_options(-Wall -Wextra -pedantic -Werror)
endif()

См. также

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

Команда target_compile_options() добавляет опции, специфичные для целевого файла.