VS_USE_DEBUG_LIBRARIES

3.30 版本新增。

指示 Visual Studio Generators 哪些配置被视为调试配置。这会控制 .vcxproj 文件中每个配置的 UseDebugLibraries 设置。

Visual Studio 项目中的“使用调试库”设置,尽管名称听起来很具体,但它是一个通用指示器,用于表明哪些配置被视为调试配置。在独立项目中,这可能会影响 MSBuild 对 MSVC 运行时库、优化标志、运行时检查等的默认选择。在 CMake 项目中,这些设置通常是根据项目规范显式生成的,例如,MSVC 运行时库由 MSVC_RUNTIME_LIBRARY 控制。但是,UseDebugLibraries 指示器对于人类和工具的参考都很有用,并且还可能影响特定于平台的 SDK 的行为。

VS_USE_DEBUG_LIBRARIES 设置为真或假值,以指示每个配置是否被视为调试配置。该值也可以是空字符串(""),在这种情况下,CMake 不会显式添加 UseDebugLibraries,MSBuild 将使用其默认值 false

使用 生成器表达式 进行按配置的指定。例如,以下代码

add_executable(foo foo.c)
set_property(TARGET foo PROPERTY
  VS_USE_DEBUG_LIBRARIES "$<CONFIG:Debug,Custom>")

表示目标 foo 将其“Debug”和“Custom”配置视为调试配置,而将其其他配置视为非调试配置。

如果设置了 CMAKE_VS_USE_DEBUG_LIBRARIES 变量,则此属性将从该变量的值初始化。如果未设置此属性,则 CMake 会根据启发式方法生成 UseDebugLibraries 来确定哪些配置是调试配置。请参阅策略 CMP0162