MSVC_RUNTIME_LIBRARY

在 3.15 版本中加入。

选择供面向 MSVC ABI 的编译器使用的 MSVC 运行时库。

允许的值为

MultiThreaded

使用 -MT 或等效标志编译，以使用多线程静态链接运行时库。

MultiThreadedDLL

使用 -MD 或等效标志编译，以使用多线程动态链接运行时库。

MultiThreadedDebug

使用 -MTd 或等效标志编译，以使用多线程静态链接运行时库。

MultiThreadedDebugDLL

使用 -MDd 或等效标志编译，以使用多线程动态链接运行时库。

该值在不面向 MSVC ABI 的编译器上会被忽略，但当使用面向 MSVC ABI 的编译器时，不支持的值将被拒绝并报错。

该值也可以是空字符串（""），在这种情况下，CMake 不会显式添加运行时库选择标志。请注意，对于 Visual Studio 生成器，原生构建系统可能会选择添加其自身的默认运行时库选择标志。

使用 generator expressions 以支持按配置指定。例如，以下代码

add_executable(foo foo.c)
set_property(TARGET foo PROPERTY
  MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")

为目标 foo 选择一个多线程静态链接运行时库，是否包含调试信息取决于配置。

该属性从 CMAKE_MSVC_RUNTIME_LIBRARY 变量的值初始化（如果已设置）。如果未设置该属性，则 CMake 使用默认值 MultiThreaded$<$<CONFIG:Debug>:Debug>DLL 来选择 MSVC 运行时库。

注意

此属性仅在策略 CMP0091 在首次调用 project() 或 enable_language() 命令之前设置为 NEW 时生效，该命令启用了使用面向 MSVC ABI 的编译器的语言。