add call decision between a shared and a static library

Author: daixtrose

library_1/CMakeLists.txt

@@ -2,16 +2,21 @@ cmake_minimum_required(VERSION 3.29)
 
 project(library_1 VERSION 1.0.0 LANGUAGES CXX DESCRIPTION "my description")
 
-add_library(${PROJECT_NAME} SHARED)
+# This option changes the implicit behavior of CMake
+# See https://cmake.org/cmake/help/latest/variable/BUILD_SHARED_LIBS.html
+option(BUILD_SHARED_LIBS "Build as shared library" ON)
+
+add_library(${PROJECT_NAME})
 add_library(demo::${PROJECT_NAME} ALIAS ${PROJECT_NAME})
 
 # add_library(MyStuff SHARED source1.cpp ...)
 set_target_properties(${PROJECT_NAME} PROPERTIES
     VERSION 2.0.0
     SOVERSION 2
-    # This is for the Windows platform. 
+
+    # This is for the Windows platform.
     # Check Craig Scott "Professional CMake", Chapter "Shared Library Versioning"
-    DLL_NAME_WITH_SOVERSION TRUE 
+    DLL_NAME_WITH_SOVERSION TRUE
 )
 
 target_sources(${PROJECT_NAME}

library_1/README.md

@@ -4,11 +4,23 @@ This example shows a minimal configuration for a C++ project yielding a library.
 
 ## Build Instructions
 
+### Build Static Library
+
 ```bash
 mkdir build_library_1
 cd build_library_1/
-cmake ../library_1/
+cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=FALSE ../library_1
 make
 ```
 
+### Build Shared Library
+
+```bash
+mkdir build_library_1
+cd build_library_1/
+cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=TRUE ../library_1
+make
+```
+
+
 Hint: there are more options to be considered for building stuff, see the other examples.