Added VFC_STATIC_RUNTIME CMake flag.

Allows for linking to the static runtime library on Windows.

Updated the minimum CMake version to 3.15 on Windows to support
set(CMAKE_MSVC_RUNTIME_LIBRARY. Other systems now require 3.10 to silence
warnings that newer versions will drop compatibility for a declared minimum
version < 3.10.

Author: akb825

CMakeLists.txt

@@ -1,4 +1,9 @@
-cmake_minimum_required(VERSION 3.5)
+if (WIN32)
+	# Needs 3.15 for CMAKE_MSVC_RUNTIME_LIBRARY.
+	cmake_minimum_required(VERSION 3.15)
+else()
+	cmake_minimum_required(VERSION 3.10)
+endif()
 project(VFC)
 
 # Build options
@@ -9,6 +14,7 @@ else()
 	set(VFC_SHARED_DEFAULT OFF)
 endif()
 set(VFC_SHARED ${VFC_SHARED_DEFAULT} CACHE BOOL "Build VFC using shared libraries.")
+set(VFC_STATIC_RUNTIME OFF CACHE BOOL "Use static runtime library on Windows.")
 
 # Options for disabling portions of the build.
 set(VFC_BUILD_TESTS ON CACHE BOOL "Build unit tests.")

README.md

@@ -14,7 +14,7 @@ Example uses include:
 
 The following software is required to build VFC:
 
-* [CMake](https://cmake.org/) 3.1 or later
+* [CMake](https://cmake.org/) 3.10 or later
 * [GLM](https://glm.g-truc.net/) (required, included as a submodule)
 * [RapidJSON](https://rapidjson.org/) (required for tool, included as a submodule)
 * [doxygen](https://doxygen.nl/) (optional)
@@ -75,6 +75,7 @@ The following options may be used when running cmake:
 * `-DCMAKE_BUILD_TYPE=Debug|Release`: Building in `Debug` or `Release`. This should always be specified.
 * `-DCMAKE_INSTALL_PREFIX=path`: Sets the path to install to when running `make install`.
 * `-DVFC_SHARED=ON|OFF`: Set to `ON` to build with shared libraries, `OFF` to build with static libraries. Default is `OFF`.
+* `-DVFC_STATIC_RUNTIME=ON,OFF`: Set to `ON` to use the static runtime library on Windows. When `OFF`, it will respect the existing value of `CMAKE_MSVC_RUNTIME_LIBRARY`, or use dynamic runtime if otherwise unset. It is not recommended to set this to `ON` when `VFC_SHARED` is also `ON`. Default is `OFF`.
 
 ### Enabled Builds
 

cmake/config.cmake

@@ -1,4 +1,4 @@
-# Copyright 2020-2022 Aaron Barany
+# Copyright 2020-2024 Aaron Barany
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -20,6 +20,13 @@ set(CMAKE_CXX_STANDARD 14)
 set(CMAKE_POSITION_INDEPENDENT_CODE ON)
 
 if (MSVC)
+	if (VFC_STATIC_RUNTIME)
+		set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
+		if (VFC_SHARED)
+			message(WARNING
+				"It is not recommended to have VFC_SHARED and VFC_STATIC_RUNTIME both set to ON.")
+		endif()
+	endif()
 	add_compile_options(/W3 /WX /wd4200 /MP)
 	add_definitions(-D_CRT_SECURE_NO_WARNINGS -D_CRT_NONSTDC_NO_WARNINGS)
 else()