CMP0164

在版本 3.30 中添加。

add_library() 在平台不支持时拒绝 SHARED 库。

在 CMake 3.29 及更低版本中，在不支持共享库的平台上（TARGET_SUPPORTS_SHARED_LIBS 为 false），add_library() 命令自动将 SHARED 库转换为 STATIC 库，以帮助用户在此类平台上构建项目。然而，共享库和静态库的语义差异很大，以至于这种自动转换通常无法工作。使用共享库的项目需要根据具体情况移植到此类平台。

在 CMake 3.30 及更高版本中，add_library() 倾向于拒绝在不支持共享库的平台上创建共享库，并因致命错误消息而失败。此策略为那些恰好可以通过自动转换为静态库工作且尚未通过显式移植更新的项目提供兼容性。

此策略的 OLD 行为是隐式创建带有开发者警告的静态库。此策略的 NEW 行为是失败。

此策略在 CMake 版本 3.30 中引入。它可以通过 cmake_policy() 或 cmake_minimum_required() 设置。如果未设置，CMake 不 会警告行为更改，并使用 OLD 行为。

注意

策略的 OLD 行为根据定义 deprecated by definition，并且可能会在未来的 CMake 版本中删除。