New in version 3.15.
Select the MSVC runtime library for use by compilers targeting the MSVC ABI. This variable is used to initialize the MSVC_RUNTIME_LIBRARY
property on all targets as they are created. It is also propagated by calls to the try_compile()
command into the test project.
The allowed values are:
MultiThreaded
Compile with -MT
or equivalent flag(s) to use a multi-threaded statically-linked runtime library.
MultiThreadedDLL
Compile with -MD
or equivalent flag(s) to use a multi-threaded dynamically-linked runtime library.
MultiThreadedDebug
Compile with -MTd
or equivalent flag(s) to use a multi-threaded statically-linked runtime library.
MultiThreadedDebugDLL
Compile with -MDd
or equivalent flag(s) to use a multi-threaded dynamically-linked runtime library.
The value is ignored on non-MSVC compilers but an unsupported value will be rejected as an error when using a compiler targeting the MSVC ABI.
The value may also be the empty string (""
) in which case no runtime library selection flag will be added explicitly by CMake. Note that with Visual Studio Generators the native build system may choose to add its own default runtime library selection flag.
Use generator expressions
to support per-configuration specification. For example, the code:
set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
selects for all following targets a multi-threaded statically-linked runtime library with or without debug information depending on the configuration.
If this variable is not set then the MSVC_RUNTIME_LIBRARY
target property will not be set automatically. If that property is not set then CMake uses the default value MultiThreaded$<$<CONFIG:Debug>:Debug>DLL
to select a MSVC runtime library.
Note
This variable has effect only when policy CMP0091
is set to NEW
prior to the first project()
or enable_language()
command that enables a language using a compiler targeting the MSVC ABI.
© 2000–2020 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.19/variable/CMAKE_MSVC_RUNTIME_LIBRARY.html