CMP0060

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

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

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

CMake позволяет проектам переопределить это поведение, используя целевое назначение импортированной библиотеки со свойством 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.6.3 по умолчанию не выводит предупреждение, когда эта политика не установлена, а просто использует старое поведение. См. документацию переменной CMAKE_POLICY_WARNING_CMP0060 для управления предупреждением.