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) для обсуждения дополнительной предосторожности, которую необходимо принять при указании требований к использованию при создании пакетов для перераспределения.