INTERFACE_INCLUDE_DIRECTORIES

Список публичных включаемых каталогов, необходимых для библиотеки.

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

Когда зависимости цели задаются с помощью target_link_libraries(), CMake будет читать это свойство от всех зависимостей цели, чтобы определить свойства сборки потребителя.

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

Требования к использованию включаемых каталогов обычно отличаются между деревом сборки и деревом установки. Генераторные выражения BUILD_INTERFACE и INSTALL_INTERFACE могут быть использованы для описания отдельных требований к использованию в зависимости от места использования. В выражении INSTALL_INTERFACE разрешены относительные пути, которые интерпретируются относительно префикса установки. Например:

target_include_directories(mylib INTERFACE
  $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include/mylib>
  $<INSTALL_INTERFACE:include/mylib>  # <prefix>/include/mylib
)

Создание переносимых пакетов

Обратите внимание, что не рекомендуется заполнять INSTALL_INTERFACE INTERFACE_INCLUDE_DIRECTORIES цели абсолютными путями к включаемым каталогам зависимостей. Это закрепит в установленных пакетах пути к включаемым каталогам зависимостей так, как они были найдены на машине, на которой пакет был создан.

INSTALL_INTERFACE INTERFACE_INCLUDE_DIRECTORIES подходит только для указания требуемых включаемых каталогов для заголовков, предоставляемых самой целью, а не тех, которые предоставляются зависимостями, перечисленными в свойстве цели INTERFACE_LINK_LIBRARIES. Эти зависимости должны сами быть целями, которые указывают свои собственные местоположения заголовков в INTERFACE_INCLUDE_DIRECTORIES.

См. раздел «Создание переносимых пакетов» в руководстве Создание переносимых пакетов cmake-packages(7) для обсуждения дополнительных мер предосторожности, которые необходимо принять при указании требований к использованию при создании пакетов для перераспределения.