MSVC_DEBUG_INFORMATION_FORMAT

在 3.25 版本中新增。

在目标为 MSVC ABI 时选择调试信息格式。

允许的值为

Embedded

使用 -Z7 或等效的标志进行编译,以生成包含完整符号调试信息的对象文件。

ProgramDatabase

使用 -Zi 或等效的标志进行编译,以生成包含所有符号调试信息的程序数据库。

EditAndContinue

使用 -ZI 或等效的标志进行编译,以生成支持“编辑并继续”功能的程序数据库。

对于不以 MSVC ABI 为目标编译器的编译器,此值将被忽略,但当使用以 MSVC ABI 为目标编译器的编译器时,不受支持的值将被视为错误。

该值也可以是空字符串 (""),在这种情况下,CMake 不会显式添加任何调试信息格式标志。

使用 生成器表达式 来支持按配置指定。例如,以下代码

add_executable(foo foo.c)
set_property(TARGET foo PROPERTY
  MSVC_DEBUG_INFORMATION_FORMAT "$<$<CONFIG:Debug,RelWithDebInfo>:ProgramDatabase>")

为目标 fooDebugRelWithDebInfo 配置中选择程序数据库调试信息格式。

此属性从 CMAKE_MSVC_DEBUG_INFORMATION_FORMAT 变量的值初始化(如果已设置)。如果未设置此属性,CMake 将使用默认值 $<$<CONFIG:Debug,RelWithDebInfo>:ProgramDatabase>(如果编译器支持),否则使用 $<$<CONFIG:Debug,RelWithDebInfo>:Embedded> 来选择调试信息格式。

注意

此属性仅在策略 CMP0141 在启用使用针对 MSVC ABI 的编译器启用语言的第一个 project()enable_language() 命令之前设置为 NEW 时才生效。