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 之前的版本中的警告。