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.

How Do I…

• Configure and Build Boost with CMake?

• Test Boost with CMake?

• Add a Boost Library with CMake?

• Add a Compiled Library with CMake?

• Add Regression Tests with CMake?

• Tune the CMake build configuration (verbosity, tests, variants)

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 (note that this documentation is also compiled in to cmake itself. The command cmake --help-full will display it.)