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 版本中移除。