MSVC_DEBUG_INFORMATION_FORMAT

在 3.25 版本加入.

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

允许的值为:

嵌入式

使用“-Z7”或等效标志编译以生成具有完整符号调试信息的目标文件。

程序数据库

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

编辑并继续

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

在不以 MSVC ABI 为目标的编译器上会忽略该值,但在使用以 MSVC ABI 为目标的编译器时,不受支持的值将作为错误被拒绝。

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

使用 generator expressions 来支持每个配置规范。例如,代码:

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

为目标“foo”选择调试配置的程序数据库调试信息格式。

如果未设置此属性,CMake 将使用默认值``$<$<CONFIG:Debug,RelWithDebInfo>:ProgramDatabase>`` 选择调试信息格式(如果编译器支持),否则为 $<$<CONFIG:Debug,RelWithDebInfo>:Embedded>

备注

只有在第一个使用针对 MSVC ABI 的编译器启用语言的 project 或 enable_language 命令之前将策略 CMP0141 设置为 NEW 时,此属性才有效.