CMake: Add support for building only static libraries

.github/workflows/build.yaml

@@ -23,7 +23,7 @@ jobs:
     # https://docs.github.com/en/actions/using-github-hosted-runners/about-github-hosted-runners
     runs-on: ubuntu-latest
 
-    name: ubuntu (${{ matrix.compiler }} ${{ matrix.cuda }} CUDA ${{ matrix.openmp }} OpenMP)
+    name: ubuntu (${{ matrix.compiler }} ${{ matrix.cuda }} CUDA ${{ matrix.openmp }} OpenMP, ${{ matrix.link }})
 
     strategy:
       # Allow other runners in the matrix to continue if some fail
@@ -33,6 +33,7 @@ jobs:
         compiler: [gcc, clang]
         cuda: [with, without]
         openmp: [with]
+        link: [both]
         include:
           - compiler: gcc
             compiler-pkgs: "g++ gcc"
@@ -61,6 +62,22 @@ jobs:
             cuda: without
             openmp: without
             openmp-cmake-flags: "-DNOPENMP=ON"
+          - compiler: gcc
+            compiler-pkgs: "g++ gcc"
+            cc: "gcc"
+            cxx: "g++"
+            ccache-max: 600M
+            cuda: with
+            cuda-pkgs: "nvidia-cuda-dev nvidia-cuda-toolkit"
+            cuda-cmake-flags:
+              -DENABLE_CUDA=On
+              -DCUDAToolkit_INCLUDE_DIR="/usr/include"
+              -DCMAKE_CUDA_COMPILER_LAUNCHER="ccache"
+            openmp: with
+            link: static
+            link-cmake-flags:
+              -DBUILD_SHARED_LIBS=OFF
+              -DBUILD_STATIC_LIBS=ON
 
     env:
       CC: ${{ matrix.cc }}
@@ -85,7 +102,7 @@ jobs:
         # used in action/cache/restore and action/cache/save steps
         id: ccache-prepare
         run: |
-          echo "key=ccache:ubuntu:${{ matrix.compiler }}:${{ matrix.cuda }}:${{ matrix.openmp }}:${{ github.ref }}:$(date +"%Y-%m-%d_%H-%M-%S"):${{ github.sha }}" >> $GITHUB_OUTPUT
+          echo "key=ccache:ubuntu:${{ matrix.compiler }}:${{ matrix.cuda }}:${{ matrix.openmp }}:${{ matrix.link }}:${{ github.ref }}:$(date +"%Y-%m-%d_%H-%M-%S"):${{ github.sha }}" >> $GITHUB_OUTPUT
 
       - name: restore ccache
         # setup the GitHub cache used to maintain the ccache from one job to the next
@@ -95,8 +112,8 @@ jobs:
           key: ${{ steps.ccache-prepare.outputs.key }}
           # Prefer caches from the same branch. Fall back to caches from the dev branch.
           restore-keys: |
-            ccache:ubuntu:${{ matrix.compiler }}:${{ matrix.cuda }}:${{ matrix.openmp }}:${{ github.ref }}
-            ccache:ubuntu:${{ matrix.compiler }}:${{ matrix.cuda }}:${{ matrix.openmp }}:
+            ccache:ubuntu:${{ matrix.compiler }}:${{ matrix.cuda }}:${{ matrix.openmp }}:${{ matrix.link }}:${{ github.ref }}
+            ccache:ubuntu:${{ matrix.compiler }}:${{ matrix.cuda }}:${{ matrix.openmp }}:${{ matrix.link }}:
 
       - name: create empty libraries
         # This is to work around a bug in nvlink.
@@ -138,6 +155,7 @@ jobs:
                   -DBLA_VENDOR="OpenBLAS" \
                   ${{ matrix.cuda-cmake-flags }} \
                   ${{ matrix.openmp-cmake-flags }} \
+                  ${{ matrix.link-cmake-flags }} \
                   ..
             echo "::endgroup::"
             echo "::group::Build $lib"
@@ -186,16 +204,19 @@ jobs:
             -DCMAKE_PREFIX_PATH="${GITHUB_WORKSPACE}/lib/cmake" \
             -DBLA_VENDOR="OpenBLAS" \
             ${{ matrix.cuda-cmake-flags }} \
+            ${{ matrix.link-cmake-flags }} \
             ..
           echo "::endgroup::"
           printf "::group::\033[0;32m==>\033[0m Building example\n"
           cmake --build .
           echo "::endgroup::"
           printf "::group::\033[0;32m==>\033[0m Executing example\n"
-          printf "\033[1;35m  C binary with shared libraries\033[0m\n"
-          LD_LIBRARY_PATH=${GITHUB_WORKSPACE}/lib ./my_demo
-          printf "\033[1;35m  C++ binary with shared libraries\033[0m\n"
-          LD_LIBRARY_PATH=${GITHUB_WORKSPACE}/lib ./my_cxx_demo
+          if [ -f ./my_demo -a -f ./my_cxx_demo ]; then
+            printf "\033[1;35m  C binary with shared libraries\033[0m\n"
+            LD_LIBRARY_PATH=${GITHUB_WORKSPACE}/lib ./my_demo
+            printf "\033[1;35m  C++ binary with shared libraries\033[0m\n"
+            LD_LIBRARY_PATH=${GITHUB_WORKSPACE}/lib ./my_cxx_demo
+          fi
           printf "\033[1;35m  C binary with statically linked libraries\033[0m\n"
           ./my_demo_static
           printf "\033[1;35m  C++ binary with statically linked libraries\033[0m\n"

.github/workflows/root-cmakelists.yaml

@@ -19,7 +19,7 @@ jobs:
     # https://docs.github.com/en/actions/using-github-hosted-runners/about-github-hosted-runners
     runs-on: ubuntu-latest
 
-    name: ubuntu (${{ matrix.compiler }} ${{ matrix.cuda }} CUDA)
+    name: ubuntu (${{ matrix.compiler }} ${{ matrix.cuda }} CUDA, ${{ matrix.link }})
 
     strategy:
       # Allow other runners in the matrix to continue if some fail
@@ -28,6 +28,7 @@ jobs:
       matrix:
         compiler: [gcc, clang]
         cuda: [with, without]
+        link: [both]
         include:
           - compiler: gcc
             compiler-pkgs: "g++ gcc"
@@ -48,6 +49,21 @@ jobs:
               -DENABLE_CUDA=ON
               -DCUDAToolkit_INCLUDE_DIR="/usr/include"
               -DCMAKE_CUDA_COMPILER_LAUNCHER="ccache"
+          - compiler: gcc
+            compiler-pkgs: "g++ gcc"
+            cc: "gcc"
+            cxx: "g++"
+            ccache-max: 600M
+            cuda: with
+            cuda-pkgs: "nvidia-cuda-dev nvidia-cuda-toolkit"
+            cuda-cmake-flags:
+              -DENABLE_CUDA=ON
+              -DCUDAToolkit_INCLUDE_DIR="/usr/include"
+              -DCMAKE_CUDA_COMPILER_LAUNCHER="ccache"
+            link: static
+            link-cmake-flags:
+              -DBUILD_SHARED_LIBS=OFF
+              -DBUILD_STATIC_LIBS=ON
 
     env:
       CC: ${{ matrix.cc }}
@@ -72,7 +88,7 @@ jobs:
         # used in action/cache/restore and action/cache/save steps
         id: ccache-prepare
         run: |
-          echo "key=ccache:ubuntu:root:${{ matrix.compiler }}:${{ matrix.cuda }}:${{ github.ref }}:$(date +"%Y-%m-%d_%H-%M-%S"):${{ github.sha }}" >> $GITHUB_OUTPUT
+          echo "key=ccache:ubuntu:root:${{ matrix.compiler }}:${{ matrix.cuda }}:${{ matrix.link }}:${{ github.ref }}:$(date +"%Y-%m-%d_%H-%M-%S"):${{ github.sha }}" >> $GITHUB_OUTPUT
 
       - name: restore ccache
         # setup the GitHub cache used to maintain the ccache from one job to the next
@@ -82,8 +98,8 @@ jobs:
           key: ${{ steps.ccache-prepare.outputs.key }}
           # Prefer caches from the same branch. Fall back to caches from the dev branch.
           restore-keys: |
-            ccache:ubuntu:root:${{ matrix.compiler }}:${{ matrix.cuda }}:${{ github.ref }}
-            ccache:ubuntu:root:${{ matrix.compiler }}:${{ matrix.cuda }}
+            ccache:ubuntu:root:${{ matrix.compiler }}:${{ matrix.cuda }}:${{ matrix.link }}:${{ github.ref }}
+            ccache:ubuntu:root:${{ matrix.compiler }}:${{ matrix.cuda }}:${{ matrix.link }}
 
       - name: create empty libraries
         # This is to work around a bug in nvlink.
@@ -120,6 +136,7 @@ jobs:
                 -DCMAKE_Fortran_COMPILER_LAUNCHER="ccache" \
                 -DBLA_VENDOR="OpenBLAS" \
                 ${{ matrix.cuda-cmake-flags }} \
+                ${{ matrix.link-cmake-flags }} \
                 ..
 
       - name: build libraries
@@ -170,16 +187,19 @@ jobs:
             -DCMAKE_PREFIX_PATH="${GITHUB_WORKSPACE}/lib/cmake" \
             -DBLA_VENDOR="OpenBLAS" \
             ${{ matrix.cuda-cmake-flags }} \
+            ${{ matrix.link-cmake-flags }} \
             ..
           echo "::endgroup::"
           printf "::group::\033[0;32m==>\033[0m Building example\n"
           cmake --build .
           echo "::endgroup::"
           printf "::group::\033[0;32m==>\033[0m Executing example\n"
-          printf "\033[1;35m  C binary with shared libraries\033[0m\n"
-          LD_LIBRARY_PATH=${GITHUB_WORKSPACE}/lib ./my_demo
-          printf "\033[1;35m  C++ binary with shared libraries\033[0m\n"
-          LD_LIBRARY_PATH=${GITHUB_WORKSPACE}/lib ./my_cxx_demo
+          if [ -f ./my_demo -a -f ./my_cxx_demo ]; then
+            printf "\033[1;35m  C binary with shared libraries\033[0m\n"
+            LD_LIBRARY_PATH=${GITHUB_WORKSPACE}/lib ./my_demo
+            printf "\033[1;35m  C++ binary with shared libraries\033[0m\n"
+            LD_LIBRARY_PATH=${GITHUB_WORKSPACE}/lib ./my_cxx_demo
+          fi
           printf "\033[1;35m  C binary with statically linked libraries\033[0m\n"
           ./my_demo_static
           printf "\033[1;35m  C++ binary with statically linked libraries\033[0m\n"

AMD/CMakeLists.txt

@@ -81,19 +81,21 @@ else ( )
     file ( GLOB AMD_SOURCES "Source/*.c" )
 endif ( )
 
-add_library ( AMD SHARED ${AMD_SOURCES} )
-set_target_properties ( AMD PROPERTIES
-    VERSION ${AMD_VERSION_MAJOR}.${AMD_VERSION_MINOR}.${AMD_VERSION_SUB}
-    C_STANDARD 11
-    C_STANDARD_REQUIRED ON
-    OUTPUT_NAME amd
-    SOVERSION ${AMD_VERSION_MAJOR}
-    PUBLIC_HEADER "Include/amd.h"
-    WINDOWS_EXPORT_ALL_SYMBOLS ON )
-
-target_include_directories ( AMD
-    INTERFACE $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/Include>
-              $<INSTALL_INTERFACE:${SUITESPARSE_INCLUDEDIR}> )
+if ( BUILD_SHARED_LIBS )
+    add_library ( AMD SHARED ${AMD_SOURCES} )
+    set_target_properties ( AMD PROPERTIES
+        VERSION ${AMD_VERSION_MAJOR}.${AMD_VERSION_MINOR}.${AMD_VERSION_SUB}
+        C_STANDARD 11
+        C_STANDARD_REQUIRED ON
+        OUTPUT_NAME amd
+        SOVERSION ${AMD_VERSION_MAJOR}
+        PUBLIC_HEADER "Include/amd.h"
+        WINDOWS_EXPORT_ALL_SYMBOLS ON )
+
+    target_include_directories ( AMD
+        INTERFACE $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/Include>
+                  $<INSTALL_INTERFACE:${SUITESPARSE_INCLUDEDIR}> )
+endif ( )
 
 #-------------------------------------------------------------------------------
 # static amd library properties
@@ -123,9 +125,11 @@ endif ( )
 #-------------------------------------------------------------------------------
 
 # SuiteSparseConfig:
-target_link_libraries ( AMD PRIVATE SuiteSparse::SuiteSparseConfig )
-target_include_directories ( AMD PUBLIC
-    "$<TARGET_PROPERTY:SuiteSparse::SuiteSparseConfig,INTERFACE_INCLUDE_DIRECTORIES>" )
+if ( BUILD_SHARED_LIBS )
+    target_link_libraries ( AMD PRIVATE SuiteSparse::SuiteSparseConfig )
+    target_include_directories ( AMD PUBLIC
+        "$<TARGET_PROPERTY:SuiteSparse::SuiteSparseConfig,INTERFACE_INCLUDE_DIRECTORIES>" )
+endif ( )
 if ( BUILD_STATIC_LIBS )
     if ( TARGET SuiteSparse::SuiteSparseConfig_static )
         target_link_libraries ( AMD_static PUBLIC SuiteSparse::SuiteSparseConfig_static )
@@ -136,7 +140,9 @@ endif ( )
 
 # libm:
 if ( NOT WIN32 )
-    target_link_libraries ( AMD PRIVATE m )
+    if ( BUILD_SHARED_LIBS )
+        target_link_libraries ( AMD PRIVATE m )
+    endif ( )
     if ( BUILD_STATIC_LIBS )
         set ( AMD_STATIC_LIBS "${AMD_STATIC_LIBS} -lm" )
         target_link_libraries ( AMD_static PUBLIC m )
@@ -149,12 +155,14 @@ endif ( )
 
 include ( CMakePackageConfigHelpers )
 
-install ( TARGETS AMD
-    EXPORT AMDTargets
-    LIBRARY DESTINATION ${SUITESPARSE_LIBDIR}
-    ARCHIVE DESTINATION ${SUITESPARSE_LIBDIR}
-    RUNTIME DESTINATION ${SUITESPARSE_BINDIR}
-    PUBLIC_HEADER DESTINATION ${SUITESPARSE_INCLUDEDIR} )
+if ( BUILD_SHARED_LIBS )
+    install ( TARGETS AMD
+        EXPORT AMDTargets
+        LIBRARY DESTINATION ${SUITESPARSE_LIBDIR}
+        ARCHIVE DESTINATION ${SUITESPARSE_LIBDIR}
+        RUNTIME DESTINATION ${SUITESPARSE_BINDIR}
+        PUBLIC_HEADER DESTINATION ${SUITESPARSE_INCLUDEDIR} )
+endif ( )
 if ( BUILD_STATIC_LIBS )
     install ( TARGETS AMD_static
         EXPORT AMDTargets
@@ -251,13 +259,24 @@ if ( DEMO )
     endif ( )
 
     # Libraries required for Demo programs
-    target_link_libraries ( amd_demo      PUBLIC AMD )
-    target_link_libraries ( amd_l_demo    PUBLIC AMD )
-    target_link_libraries ( amd_demo2     PUBLIC AMD )
-    target_link_libraries ( amd_simple    PUBLIC AMD )
-    if ( NOT NFORTRAN )
-        target_link_libraries ( amd_f77demo   PUBLIC AMD )
-        target_link_libraries ( amd_f77simple PUBLIC AMD )
+    if ( BUILD_SHARED_LIBS )
+        target_link_libraries ( amd_demo PUBLIC AMD )
+        target_link_libraries ( amd_l_demo PUBLIC AMD )
+        target_link_libraries ( amd_demo2 PUBLIC AMD )
+        target_link_libraries ( amd_simple PUBLIC AMD )
+        if ( NOT NFORTRAN )
+            target_link_libraries ( amd_f77demo PUBLIC AMD )
+            target_link_libraries ( amd_f77simple PUBLIC AMD )
+        endif ( )
+    else ( )
+        target_link_libraries ( amd_demo PUBLIC AMD_static )
+        target_link_libraries ( amd_l_demo PUBLIC AMD_static )
+        target_link_libraries ( amd_demo2 PUBLIC AMD_static )
+        target_link_libraries ( amd_simple PUBLIC AMD_static )
+        if ( NOT NFORTRAN )
+            target_link_libraries ( amd_f77demo PUBLIC AMD_static )
+            target_link_libraries ( amd_f77simple PUBLIC AMD_static )
+        endif ( )
     endif ( )
 
 else ( )

AMD/Config/AMDConfig.cmake.in

@@ -69,6 +69,11 @@ set ( _target_shared SuiteSparse::AMD )
 set ( _target_static SuiteSparse::AMD_static )
 set ( _var_prefix "AMD" )
 
+if ( NOT @BUILD_SHARED_LIBS@ AND NOT TARGET ${_target_shared} )
+    # make sure there is always an import target without suffix )
+    add_library ( ${_target_shared} ALIAS ${_target_static} )
+endif ( )
+
 get_target_property ( ${_var_prefix}_INCLUDE_DIR ${_target_shared} INTERFACE_INCLUDE_DIRECTORIES )
 if ( ${_var_prefix}_INCLUDE_DIR )
     # First item in SuiteSparse targets contains the "main" header directory.

BTF/CMakeLists.txt

@@ -70,20 +70,22 @@ include_directories ( Source Include )
 
 file ( GLOB BTF_SOURCES "Source/*.c" )
 
-add_library ( BTF SHARED ${BTF_SOURCES} )
+if ( BUILD_SHARED_LIBS )
+    add_library ( BTF SHARED ${BTF_SOURCES} )
 
-set_target_properties ( BTF PROPERTIES
-    VERSION ${BTF_VERSION_MAJOR}.${BTF_VERSION_MINOR}.${BTF_VERSION_SUB}
-    C_STANDARD 11
-    C_STANDARD_REQUIRED ON
-    OUTPUT_NAME btf
-    SOVERSION ${BTF_VERSION_MAJOR}
-    PUBLIC_HEADER "Include/btf.h"
-    WINDOWS_EXPORT_ALL_SYMBOLS ON)
+    set_target_properties ( BTF PROPERTIES
+        VERSION ${BTF_VERSION_MAJOR}.${BTF_VERSION_MINOR}.${BTF_VERSION_SUB}
+        C_STANDARD 11
+        C_STANDARD_REQUIRED ON
+        OUTPUT_NAME btf
+        SOVERSION ${BTF_VERSION_MAJOR}
+        PUBLIC_HEADER "Include/btf.h"
+        WINDOWS_EXPORT_ALL_SYMBOLS ON)
 
-target_include_directories ( BTF
-    INTERFACE $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/Include>
-              $<INSTALL_INTERFACE:${SUITESPARSE_INCLUDEDIR}> )
+    target_include_directories ( BTF
+        INTERFACE $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/Include>
+                  $<INSTALL_INTERFACE:${SUITESPARSE_INCLUDEDIR}> )
+endif ( )
 
 #-------------------------------------------------------------------------------
 # static btf library properties
@@ -106,24 +108,27 @@ if ( BUILD_STATIC_LIBS )
     target_include_directories ( BTF_static
         INTERFACE $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/Include>
                   $<INSTALL_INTERFACE:${SUITESPARSE_INCLUDEDIR}> )
-
 endif ( )
 
 #-------------------------------------------------------------------------------
 # add the library dependencies
 #-------------------------------------------------------------------------------
 
 # SuiteSparseConfig:
-target_include_directories ( BTF PUBLIC
-    "$<TARGET_PROPERTY:SuiteSparse::SuiteSparseConfig,INTERFACE_INCLUDE_DIRECTORIES>" )
+if ( BUILD_SHARED_LIBS )
+    target_include_directories ( BTF PUBLIC
+        "$<TARGET_PROPERTY:SuiteSparse::SuiteSparseConfig,INTERFACE_INCLUDE_DIRECTORIES>" )
+endif ( )
 if ( BUILD_STATIC_LIBS )
     target_include_directories ( BTF_static PUBLIC
         "$<TARGET_PROPERTY:SuiteSparse::SuiteSparseConfig,INTERFACE_INCLUDE_DIRECTORIES>" )
 endif ( )
 
 # libm:
 if ( NOT WIN32 )
-    target_link_libraries ( BTF PRIVATE m )
+    if ( BUILD_SHARED_LIBS )
+        target_link_libraries ( BTF PRIVATE m )
+    endif ( )
     if ( BUILD_STATIC_LIBS )
         set ( BTF_STATIC_LIBS "${BTF_STATIC_LIBS} -lm" )
         target_link_libraries ( BTF_static PUBLIC m )
@@ -136,12 +141,14 @@ endif ( )
 
 include ( CMakePackageConfigHelpers )
 
-install ( TARGETS BTF
-    EXPORT BTFTargets
-    LIBRARY DESTINATION ${SUITESPARSE_LIBDIR}
-    ARCHIVE DESTINATION ${SUITESPARSE_LIBDIR}
-    RUNTIME DESTINATION ${SUITESPARSE_BINDIR}
-    PUBLIC_HEADER DESTINATION ${SUITESPARSE_INCLUDEDIR} )
+if ( BUILD_SHARED_LIBS )
+    install ( TARGETS BTF
+        EXPORT BTFTargets
+        LIBRARY DESTINATION ${SUITESPARSE_LIBDIR}
+        ARCHIVE DESTINATION ${SUITESPARSE_LIBDIR}
+        RUNTIME DESTINATION ${SUITESPARSE_BINDIR}
+        PUBLIC_HEADER DESTINATION ${SUITESPARSE_INCLUDEDIR} )
+endif ( )
 if ( BUILD_STATIC_LIBS )
     install ( TARGETS BTF_static
         EXPORT BTFTargets