CMP0184

4.0 版本新增。

MSVC 运行时检查标志由抽象层选择。

针对 MSVC ABI 的编译器具有用于选择运行时检查的标志。运行时检查的选择通常随构建配置而异。

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

CMake 4.0 及更高版本倾向于将运行时检查标志排除在默认的 CMAKE_<LANG>_FLAGS_<CONFIG> 值之外,而是提供一个一流的抽象。可以通过设置 CMAKE_MSVC_RUNTIME_CHECKS 变量和 MSVC_RUNTIME_CHECKS 目标属性来选择 MSVC 运行时检查。如果未设置,CMake 将仅为 Debug 配置启用运行时检查,使用默认值 $<$<CONFIG:Debug>:StackFrameErrorCheck;UninitializedVariable>(如果编译器支持),否则为空值。

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

注意

一旦该策略在项目顶层生效,该选择将在整个项目中被使用。在具有嵌套子项目的情况下,请确保确认所有内容是否与所选的策略行为正常工作。

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

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

注意

策略的 OLD 行为是 按定义弃用,并可能在未来的 CMake 版本中移除。