Add support to consume library via CMake's FetchContentfix49

3 files changed, 32 insertions, 5 deletions

diff --git a/README.md b/README.md
index 35bf550..b0eb182 100644
--- a/README.md
+++ b/README.md
@@ -20,8 +20,11 @@ It follows the standard as described here:
 Using This Library

 ------------------

 

-### Using CMake 

-Once the library has been installed, add to your project `CMakeLists.txt` : 

+### Using CMake

+

+#### Use installed library

+

+Once the library has been installed (for example by compiling from source or installing it via a package manager), add to your project `CMakeLists.txt` : 

 ~~~cmake

 ...

 find_package(dlfcn-win32 REQUIRED)

@@ -45,6 +48,28 @@ target_link_libraries(<target> ${CMAKE_DL_LIBS})
 

 When cross-compiling you might want to set [`CMAKE_CROSSCOMPILING_EMULATOR`](https://cmake.org/cmake/help/latest/variable/CMAKE_CROSSCOMPILING_EMULATOR.html) to the path of wine to run tests.

 

+#### Download and build library as part of CMake build

+

+If you do not have installed and you do not want to install the library, you can also download and build it using [CMake's FetchContent module](https://cmake.org/cmake/help/latest/module/FetchContent.html). Just add in your CMake project:

+~~~cmake

+...

+if (WIN32)

+  include(FetchContent)

+  FetchContent_Declare(

+    dlfcn-win32

+    GIT_REPOSITORY "https://github.com/dlfcn-win32/dlfcn-win32.git"

+    GIT_TAG "v1.5.0"

+    SYSTEM

+  )

+  FetchContent_MakeAvailable(dlfcn-win32)

+  set(CMAKE_DL_LIBS dlfcn-win32::dl)

+endif ()

+...

+target_link_libraries(<target> ${CMAKE_DL_LIBS})

+...

+~~~

+

+

 Authors

 -------

 

diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt
index 9066e65..cdaf2a5 100644
--- a/src/CMakeLists.txt
+++ b/src/CMakeLists.txt
@@ -3,6 +3,8 @@ set(sources dlfcn.c)
 
 
 add_library(dl ${sources})
+# Support for FetchContent workflow
+add_library(dlfcn-win32::dl ALIAS dl)
 
 # Correctly export the location of installed includes in the target
 target_include_directories(dl
diff --git a/tests/CMakeLists.txt b/tests/CMakeLists.txt
index cd321f2..e9b3e85 100644
--- a/tests/CMakeLists.txt
+++ b/tests/CMakeLists.txt
@@ -7,19 +7,19 @@ if(WIN32)
 
     add_library(testdll2 SHARED testdll2.c)
     set_target_properties(testdll2 PROPERTIES PREFIX "")
-    target_link_libraries(testdll2 dl)
+    target_link_libraries(testdll2 dlfcn-win32::dl)
 
     add_library(testdll3 SHARED testdll3.c)
     set_target_properties(testdll3 PROPERTIES PREFIX "")
 
     add_executable(t_dlfcn test.c)
-    target_link_libraries(t_dlfcn dl)
+    target_link_libraries(t_dlfcn dlfcn-win32::dl)
 
     add_test(NAME t_dlfcn COMMAND t_dlfcn WORKING_DIRECTORY $<TARGET_FILE_DIR:t_dlfcn> )
 endif()
 
 add_executable(test-dladdr test-dladdr.c)
-target_link_libraries(test-dladdr dl)
+target_link_libraries(test-dladdr dlfcn-win32::dl)
 if(UNIX)
     set_target_properties(test-dladdr PROPERTIES COMPILE_FLAGS "-Wl,--export-dynamic -fpie")
 endif()