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_policy() или cmake_minimum_required(). Если она не установлена, CMake выдает предупреждение и использует поведение по умолчанию OLD.