CMake-Based Build System

We are developing an alternative build system for Boost based on ​CMake, a cross-platform, open-source make system. At this point, the CMake-based build system is still a work in progress, and it is unknown whether it will become a fully-supported build system within Boost. These pages document the CMake-based build system for Boost, and are focused primarily at Boost library developers. In the future, we will provide an alternative version of Boost's Getting Started guide for CMake users.

Task-Oriented Documentation

• Configuring and Building Boost with CMake

• Testing Boost with CMake

• Adding a Boost Library with CMake

• Adding a Compiled Library with CMake

• Adding Regression Tests with CMake

Reference Documentation

• Project macros
  • boost_library_project - Designate a new Boost library project

• Building library binaries
  • boost_add_library - Add a compiled Boost library

• Regression testing
  • boost_test_run - Compile and execute a test

• boost_test_run_fail - Compile and execute a test (which is expected to fail)

• boost_test_compile - Compile a test

• boost_test_compile_fail - Compile a test (which should fail to compile)

• Build features - Different library build features supported by the build system

• ​CMake Macro Reference