CMAKE_MSVC_DEBUG_INFORMATION_FORMAT¶
在 3.25 版本中新增。
选择针对 MSVC ABI 的 MSVC 调试信息格式。此变量用于初始化创建的所有目标的 MSVC_DEBUG_INFORMATION_FORMAT
属性。它还会通过 try_compile()
命令传播到测试项目中。
允许的值为
Embedded
使用
-Z7
或等效标志编译,以生成具有完整符号调试信息的对象文件。ProgramDatabase
使用
-Zi
或等效标志编译,以生成包含所有符号调试信息的用户数据库。EditAndContinue
使用
-ZI
或等效标志编译,以生成支持“编辑并继续”功能的用户数据库。
对于不以 MSVC ABI 为目标编译器的编译器,此值将被忽略,但当使用以 MSVC ABI 为目标编译器的编译器时,不受支持的值将被视为错误。
该值也可以是空字符串(""
),在这种情况下,CMake 不会显式添加任何调试信息格式标志。
使用 生成器表达式
来支持按配置进行指定。例如,以下代码
set(CMAKE_MSVC_DEBUG_INFORMATION_FORMAT "$<$<CONFIG:Debug,RelWithDebInfo>:ProgramDatabase>")
为所有后续目标选择 Debug
和 RelWithDebInfo
配置的用户数据库调试信息格式。
如果未设置此变量,则 MSVC_DEBUG_INFORMATION_FORMAT
目标属性不会自动设置。如果未设置该属性,CMake 会使用默认值 $<$<CONFIG:Debug,RelWithDebInfo>:ProgramDatabase>
(如果编译器支持)来选择调试信息格式,否则使用 $<$<CONFIG:Debug,RelWithDebInfo>:Embedded>
。
注意
此变量仅在策略 CMP0141
在启用使用针对 MSVC ABI 的编译器的语言的第一个 project()
或 enable_language()
命令之前设置为 NEW
时才生效。