CMP0060

警告

此策略的 OLD 行为已在 CMake 4.0 版本中移除。此策略必须通过调用 cmake_minimum_required()cmake_policy() 设置为 NEW

3.3 版本中新增。

即使在隐式目录中也按完整路径链接库。

引入策略 CMP0003 的目的是,当向 target_link_libraries() 命令提供完整路径时,始终按完整路径链接库文件。然而,在某些平台(例如 HP-UX)上,编译器前端会为当前架构添加备用库搜索路径(例如 /usr/lib/<arch> 拥有 /usr/lib 中库的备用路径,适用于当前架构)。在此类平台上,find_library() 可能会找到一个库,例如 /usr/lib/libfoo.so,它不属于当前架构。

在策略 CMP0003 之前,项目在这种情况下仍然会构建,因为不正确的库路径会在链接行上转换为 -lfoo,并且链接器会在编译器前端隐式提供的特定于架构的搜索路径中找到正确的库。当时我们选择通过始终将隐式链接目录中找到的库文件转换为 -lfoo 标志来请求链接器搜索它们,从而与此类项目保持兼容。这种方法允许现有项目继续构建,同时仍然通过完整路径(例如构建树中的库)链接到隐式链接目录之外的库。

CMake 允许项目通过使用 IMPORTED 库目标 并将其 IMPORTED_LOCATION 属性设置为库文件的所需完整路径来覆盖此行为。事实上,许多 Find 模块 正在学习提供 导入目标,而不是仅仅提供传统的 Foo_LIBRARIES 变量列出库文件。然而,这使得通过 Find 模块找到的库的生成的链接行取决于它是否通过导入目标链接,这不一致。此外,此行为一直是混淆的来源,因为库文件的生成的链接行取决于其位置。对于尝试静态链接的项目来说,这也很成问题,因为像 -Wl,-Bstatic -lfoo -Wl,-Bdynamic 这样的标志可能会用于帮助链接器选择 libfoo.a 而不是 libfoo.so,但随后会将动态链接泄露给后续库。(有关该问题的解决方案,通常请参阅 LINK_SEARCH_END_STATIC 目标属性。)

当首次引入隐式链接目录中库的特殊情况时,隐式链接目录的列表只是硬编码的(例如 /lib/usr/lib 和其他一些)。从那时起,CMake 已经学会了检测编译器前端使用的隐式链接目录。如有必要,可以教导 find_library() 命令使用此信息来帮助查找正确架构的库。

由于这些原因,CMake 3.3 及更高版本更倾向于取消特殊情况,即使库在隐式链接目录中也按完整路径链接库。策略 CMP0060 为现有项目提供兼容性。

此策略的 OLD 行为是请求链接器搜索已知位于隐式链接目录中的库的完整路径。此策略的 NEW 行为是即使库位于隐式链接目录中也按完整路径链接库。

此策略在 CMake 3.3 版本中引入。在 CMake 4.0 版本中移除之前,它可以通过 cmake_policy()cmake_minimum_required() 设置。如果未设置,CMake 默认发出警告,并使用 OLD 行为。

请参阅 CMAKE_POLICY_WARNING_CMP0060 变量的文档,以控制 CMake 4.0 之前的版本中的警告。