Skip to content
Non-intrusive CMake dependency management
CMake Assembly
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmake
CMakeLists.txt
LICENSE.txt
README.md

README.md

cmodule

Non-intrusive CMake dependency management.

Normally CMake's find_package() looks for packages installed on host system (and compiled for host system). When using cmodule, find_package() downloads packages and compiles them for each target independently, using current CMake toolchain. This, among other things, allows using C/C++ libraries (like boost) when cross-compiling for Android, iOS, WebAssembly (Emscripten), etc. Downloaded and unpacked sources are shared between targets, while binaries are compiled for each target independently.

CMake integration

After initializing cmodule, regular find_package() calls will work in top level CMake project and all subprojects:

include(FetchContent)
FetchContent_Declare(
  cmodule
  URL "https://github.com/scapix-com/cmodule/archive/v1.0.9.tar.gz"
  URL_HASH SHA256=62023822a0272fa1485a6e931d83a9153609da027993ba1942137e4448c30c7d
)
FetchContent_MakeAvailable(cmodule)

find_package(Boost REQUIRED COMPONENTS filesystem iostreams)
target_link_libraries(${target} PUBLIC Boost::filesystem Boost::iostreams)

find_package(ZLIB REQUIRED)
target_link_libraries(${target} PRIVATE ZLIB::ZLIB)

find_package(BZip2 REQUIRED)
target_link_libraries(${target} PRIVATE BZip2::BZip2)

How cmodule differs from other package managers?

Other package managers (like hunter), share binaries compiled for a particular target platform, but do not share download/unpack/store of library sources. This is designed to save build time and disk space for situations when you have multiple independently built projects which use a lot of the same libraries.

cmodule does the opposite: it shares download/unpack/store of library sources, but does not share binaries compiled for a particular platform (they are still shared between different targets in the same CMake build, but not between independently built CMake projects). If your projects are built together (as part of the same CMake build), and you cross-compile for multiple platforms (just building all Android ABIs is 4 different platforms), cmodule is a better choice: it shares download/unpack/store of library sources, while building libraries with EXACTLY the same CMake platform toolchain as the rest of the project.

More info

Documentation
Example

You can’t perform that action at this time.