Spec-Zone.ru › CMake

include_directories

Добавить каталоги включаемых файлов в сборку.

include_directories([AFTER|BEFORE] [SYSTEM] dir1 [dir2 ...])

Добавляет указанные каталоги к каталогам, в которых компилятор ищет файлы включения. Относительные пути интерпретируются относительно текущего каталога исходных файлов.

Каталоги включаемых файлов добавляются в свойство каталога INCLUDE_DIRECTORIES для текущего файла CMakeLists. Они также добавляются в свойство цели INCLUDE_DIRECTORIES для каждой цели в текущем файле CMakeLists. Значения свойств целей используются генераторами.

По умолчанию указанные каталоги добавляются в конец текущего списка каталогов. Это поведение по умолчанию можно изменить, задав для CMAKE_INCLUDE_DIRECTORIES_BEFORE значение ON. Используя явным образом AFTER или BEFORE, можно выбрать добавление в конец или в начало списка независимо от поведения по умолчанию.

Если указан параметр SYSTEM, компилятору сообщается, что на некоторых платформах эти каталоги предназначены для системных файлов включения. Указание этой настройки может привести к таким эффектам, как пропуск компилятором предупреждений или исключение этих системных файлов фиксированной установки из расчётов зависимостей — см. документацию компилятора.

Аргументы команды include_directories могут использовать генераторные выражения с синтаксисом $<...>. Доступные выражения см. в руководстве cmake-generator-expressions(7). Подробнее об определении свойств системы сборки см. в руководстве cmake-buildsystem(7).

Примечание

Предпочтительно использовать команду target_include_directories(), чтобы добавлять каталоги включаемых файлов к отдельным целям и при необходимости передавать их зависимым целям или экспортировать для них.

См. также

  • target_include_directories()

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

Spec-Zone.ru

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