INTERFACE_SYSTEM_INCLUDE_DIRECTORIES

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

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

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

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

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

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