CMP0091

版本 3.15 新增。

MSVC 运行时库标志由抽象选择。

针对 MSVC ABI 的编译器具有用于选择 MSVC 运行时库的标志。运行时库选择通常随构建配置而变化,因为 Debug 构建有单独的运行时库。

在 CMake 3.14 及更早版本中,CMake 会自动将 MSVC 运行时库选择标志添加到默认的 CMAKE_<LANG>_FLAGS_<CONFIG> 缓存条目中。这允许用户编辑其缓存条目以调整标志。但是,这种默认标志的存在对于希望以编程方式选择不同运行时库的项目来说是有问题的。特别是,它需要了解 CMake 内置默认值的字符串编辑 CMAKE_<LANG>_FLAGS_<CONFIG> 变量,以便可以替换它们。

CMake 3.15 及更高版本倾向于不将 MSVC 运行时库选择标志包含在默认的 CMAKE_<LANG>_FLAGS_<CONFIG> 值中,而是提供第一类抽象。可以通过设置 CMAKE_MSVC_RUNTIME_LIBRARY 变量和 MSVC_RUNTIME_LIBRARY 目标属性来选择 MSVC 运行时库。如果未设置,CMake 将使用默认值 MultiThreaded$<$<CONFIG:Debug>:Debug>DLL,这等同于原始标志。

此策略提供与未更新以了解抽象的项目兼容性。策略设置从第一个 project()enable_language() 命令开始生效,该命令启用一个针对 MSVC ABI 的编译器的语言。

注意

一旦策略在项目顶部生效,就必须在整个树中使用该选择。在包含嵌套项目的项目中,请确保一起转换所有内容。

此策略的 OLD 行为是将 MSVC 运行时库标志放入默认的 CMAKE_<LANG>_FLAGS_<CONFIG> 缓存条目中,并忽略 CMAKE_MSVC_RUNTIME_LIBRARY 抽象。此策略的 NEW 行为是不将 MSVC 运行时库标志放入默认缓存条目中,而是使用抽象。

此策略是在 CMake 版本 3.15 中引入的。它可以由 cmake_policy()cmake_minimum_required() 设置。如果未设置,CMake 不会发出警告,并使用 OLD 行为。

注意

策略的 OLD 行为 根据定义已被弃用,并且可能会在未来版本的 CMake 中被删除。