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).