CMP0141

在版本 3.25 中添加。

MSVC 调试信息格式标志由抽象概念选择。

目标 MSVC ABI 的编译器具有选择调试信息格式的标志。调试信息格式的选择通常随构建配置而变化。

在 CMake 3.24 及更低版本中，调试信息格式标志由 CMake 自动添加到默认的 CMAKE_<LANG>_FLAGS_<CONFIG> 缓存条目中。这允许用户编辑他们的缓存条目以调整标志。然而，对于希望以编程方式选择不同调试信息格式的项目，这些默认标志的存在是有问题的。特别是，它需要字符串编辑 CMAKE_<LANG>_FLAGS_<CONFIG> 变量，并且需要了解 CMake 内置默认值，以便可以替换它们。

CMake 3.25 及更高版本倾向于将调试信息格式标志从默认的 CMAKE_<LANG>_FLAGS_<CONFIG> 值中移除，而是提供一流的抽象概念。CMAKE_MSVC_DEBUG_INFORMATION_FORMAT 变量和 MSVC_DEBUG_INFORMATION_FORMAT 目标属性可以设置为选择 MSVC 调试信息格式。如果未设置，CMake 将在调试配置中使用默认值 $<$<CONFIG:Debug,RelWithDebInfo>:ProgramDatabase> 启用调试信息（如果编译器支持），否则使用 $<$<CONFIG:Debug,RelWithDebInfo>:Embedded>。

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

注意

一旦策略在项目的顶层生效，该选择将在整个树中使用。在子目录中具有嵌套项目的项目中，请务必确认一切都按选定的策略行为工作。

此策略的 OLD 行为是将 MSVC 调试信息格式标志放在默认的 CMAKE_<LANG>_FLAGS_<CONFIG> 缓存条目中，并忽略 CMAKE_MSVC_DEBUG_INFORMATION_FORMAT 抽象概念。此策略的 NEW 行为是不将 MSVC 调试信息格式标志放在默认缓存条目中，而是使用抽象概念。

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

注意

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