CMP0079

target_link_libraries() разрешает использование с целевыми объектами в других каталогах.

До CMake 3.13 команда target_link_libraries() не принимала целевые объекты, не созданные в вызывающем каталоге, в качестве своего первого аргумента для вызовов, обновляющих LINK_LIBRARIES самого целевого объекта. Случайно она принимала целевые объекты из других каталогов в вызовах, которые обновляли только INTERFACE_LINK_LIBRARIES, но просто добавляла записи в свойство, как будто вызов был сделан в исходном каталоге. Таким образом, интерфейсные библиотеки, связанные таким образом, всегда находили генераторы в области исходного целевого объекта, а не в области, вызвавшей target_link_libraries().

CMake 3.13 теперь позволяет вызывать команду target_link_libraries() из любого каталога, чтобы добавить зависимости связывания и интерфейсные библиотеки связывания к целевым объектам, созданным в других каталогах. Записи добавляются в LINK_LIBRARIES и INTERFACE_LINK_LIBRARIES с использованием специального (внутреннего) суффикса, чтобы указать генераторам искать имена в области вызова, а не в области, создавшей целевой объект.

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

Поведение этого параметра по умолчанию — запретить вызовы target_link_libraries() с указанием целевых объектов из другого каталога, за исключением ранее разрешенного случая использования только ключевого слова INTERFACE. Поведение этого параметра по умолчанию — разрешить все такие вызовы, но использовать новые правила области видимости.

Этот параметр был введён в CMake версии 3.13. CMake версии 3.16.9 предупреждает, когда параметр не установлен, и использует поведение OLD. Используйте команду cmake_policy(), чтобы установить его явно в OLD или NEW.