CMP0060

Связывание библиотек полным путем даже в неявных каталогах.

Политика CMP0003 была введена с целью всегда связывать файлы библиотек полным путем, когда полному пути передается в команду target_link_libraries(). Однако на некоторых платформах (например, HP-UX) фронтенд компилятора добавляет альтернативные пути поиска библиотек для текущей архитектуры (например, /usr/lib/<arch> имеет альтернативы для библиотек в /usr/lib для текущей архитектуры). На таких платформах find_library() может найти библиотеку, такую как /usr/lib/libfoo.so, которая не относится к текущей архитектуре.

До политики CMP0003 проекты по-прежнему компилировались в таких случаях, потому что неправильный путь к библиотеке преобразовывался в -lfoo в строке компоновки, и компоновщик находил соответствующую библиотеку в пути поиска, специфичном для архитектуры, который неявно предоставлял фронтенд компилятора. В то время мы решили сохранить совместимость с такими проектами, всегда преобразовывая файлы библиотек, найденные в неявных каталогах компоновки, в -lfoo флаги, чтобы попросить компоновщик искать их. Этот подход позволил существующим проектам продолжать компиляцию, одновременно связывая библиотеки за пределами неявных каталогов компоновки через полный путь (например, те, которые находятся в дереве сборки).

CMake позволяет проектам переопределить это поведение, используя IMPORTED библиотечный целевой объект со свойством IMPORTED_LOCATION, установленным на желаемый полный путь к файлу библиотеки. На самом деле, многие модули поиска учатся предоставлять импортированные целевые объекты вместо просто традиционной Foo_LIBRARIES переменной, перечисляющей файлы библиотек. Однако это делает строку компоновки, сгенерированную для библиотеки, найденной модулем поиска, зависящей от того, связана ли она через импортированный целевой объект или нет, что несогласованно. Кроме того, это поведение стало источником путаницы, так как сгенерированная строка компоновки для файла библиотеки зависит от его расположения. Это также проблематично для проектов, пытающихся скомпоновать статически, потому что флаги, такие как -Wl,-Bstatic -lfoo -Wl,-Bdynamic, могут использоваться для помощи компоновщику в выборе libfoo.a вместо libfoo.so, но затем пропускают динамическую компоновку для последующих библиотек. (См. свойство целевого объекта LINK_SEARCH_END_STATIC для решения, обычно используемого для этой проблемы.)

Когда был впервые введен специальный случай для библиотек в неявных каталогах компоновки, список неявных каталогов компоновки был просто жестко закодирован (например, /lib, /usr/lib, и несколько других). С тех пор CMake научился обнаруживать неявные каталоги компоновки, используемые фронтендом компилятора. При необходимости команда find_library() может быть обучена использовать эту информацию для поиска библиотек правильной архитектуры.

По этим причинам CMake 3.3 и выше предпочитают отказаться от специального случая и связывать библиотеки полным путем, даже если они находятся в неявных каталогах компоновки. Политика CMP0060 обеспечивает совместимость для существующих проектов.

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

Эта политика была введена в версии CMake 3.3. В отличие от большинства политик, CMake версии 3.7.2 по умолчанию не предупреждает, если эта политика не установлена, и просто использует старое поведение. См. документацию переменной CMAKE_POLICY_WARNING_CMP0060 для управления предупреждением.