Spec-Zone.ru › CMake 3.21

add_compile_options

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

add_compile_options(<option> ...)

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

Аргументы

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

Устранение дублирования параметров

Конечный набор параметров, используемых для целевого объекта, создается путём накопления параметров от текущего целевого объекта и требований его зависимостей. Набор параметров дублируется, чтобы избежать повторений.

Новое в версии 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 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() добавляет параметры, специфичные для целевого объекта.

Свойство исходного файла COMPILE_OPTIONS добавляет параметры для одного исходного файла.

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API