VS_USE_DEBUG_LIBRARIES

添加于 3.30 版本。

向 Visual Studio 生成器 指示哪些配置被认为是调试配置。 这控制着 UseDebugLibraries 设置在 .vcxproj 文件的每个配置中。

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

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

使用 generator expressions 进行配置相关的指定。 例如，以下代码

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。