CMAKE_MSVC_RUNTIME_LIBRARY

版本 3.15 新增。

选择用于以 MSVC ABI 为目标的编译器的 MSVC 运行时库。此变量用于在所有目标创建时初始化 MSVC_RUNTIME_LIBRARY 属性。它也会被 try_compile() 命令的调用传播到测试项目中。

允许的值为

MultiThreaded

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

MultiThreadedDLL

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

MultiThreadedDebug

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

MultiThreadedDebugDLL

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

对于不以 MSVC ABI 为目标编译器的编译器，此值将被忽略，但当使用以 MSVC ABI 为目标编译器的编译器时，不受支持的值将被视为错误。

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

使用 生成器表达式 来支持按配置指定。例如，以下代码

set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")

根据配置，为所有后续目标选择带有或不带有调试信息的​​多线程静态链接运行时库。

如果未设置此变量，则不会自动设置 MSVC_RUNTIME_LIBRARY 目标属性。如果未设置该属性，则 CMake 使用默认值 MultiThreaded$<$<CONFIG:Debug>:Debug>DLL 来选择 MSVC 运行时库。

注意

此变量仅在策略 CMP0091 设置为 NEW 并在第一个 project() 或 enable_language() 命令（该命令使用以 MSVC ABI 为目标的编译器启用语言）之前生效。