Easy Boost integration in CMake projects!
Install the submodule in your project structure:
git submodule add https://github.com/Orphis/boost-cmake.git
Use it! In your CMakeLists.txt file:
add_subdirectory(boost-cmake) ... target_link_libraries(lib_using_filesystem PUBLIC Boost::filesystem) target_link_libraries(lib_using_header_only PUBLIC Boost::boost)
Boost will automatically be downloaded from GitHub as a minified archive created with the
If that is not acceptable to you, you can use an alternate Boost version, apply custom patches or just mirror the current archive in your internal network like so:
set(BOOST_URL http://internal.mirror/boost.7z) set(BOOST_URL_SHA256 foobar) add_subdirectory(boost-cmake)
For more advanced configuration, you can override the way to download the sources using FetchContent_Declare:
FetchContent_Declare( Boost SVN_REPOSITORY "svn+ssh://svn.company.com/boost" )
If you have Boost sources already available and want to point to them, you can use the following:
set(FETCHCONTENT_SOURCE_DIR_BOOST /path/to/boost) add_subdirectory(boost-cmake)
Most people struggle building Boost for various platforms or using package managers to get the right version, so I figured I would open-source the solution similar to the one I developed while I worked at Spotify.
Using this, as long as your main project is configured properly, Boost will be built with the same compiler, same architectures (in case of universal macOS or iOS build), same compilation flags (think of Clang sanitizers for example) without any hassle.
The Boost sources will be automatically downloaded from CMake if they cannot be found. You can also fork the project and add the boost source package if you wish to do so, or use an alternative URL pointing for example to an HTTP cache internal to your network.
Not all libraries are currently built. Patches accepted to build the remaining ones!
BSD 3-clause license. See LICENSE.md file.