CMP0008

警告

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

通过完整路径链接的库必须具有有效的库文件名。

在 CMake 2.4 及更早版本中,可以编写如下代码:

target_link_libraries(myexe /full/path/to/somelib)

其中 somelib 应该是一个有效的库文件名,例如 libsomelib.asomelib.lib。对于 Makefile 生成器,这会在构建时产生一个错误,因为无法找到对完整路径的依赖。对于 Visual Studio 生成器 IDE 和 Xcode 生成器,以前会因为偶然原因而工作,因为 CMake 会始终将库目录分离出来,并要求链接器按名称搜索库(-lsomelibsomelib.lib)。尽管在 Makefiles 中会失败,但一些项目有类似的代码,并且只使用 Visual Studio 和/或 Xcode 构建。此版本的 CMake 倾向于将完整路径直接传递给本机构建工具,在这种情况下会失败,因为它没有命名一个有效的库文件。

此策略决定了如何处理看起来不像有效库文件的完整路径。此策略的 OLD 行为是根据路径拆分库名称并要求链接器搜索它。此策略的 NEW 行为是信任给定的路径,并将其原样直接传递给本机构建工具。

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