cmake-cxxmodules - Man Page

Name

cmake-cxxmodules — CMake C++ Modules Support Reference

New in version 3.28.

C++ 20 introduced the concept of "modules" to the language.  The design requires build systems to order compilations among each other to satisfy import statements reliably.  CMake's implementation asks the compiler to scan source files for module dependencies during the build, collates scanning results to infer ordering constraints, and tells the build tool how to dynamically update the build graph.

Scanning Control

Whether or not sources get scanned for C++ module usage is dependent on the following queries. The first query that provides a yes/no answer is used.

Note that any scanned source will be excluded from any unity build (see UNITY_BUILD) because module-related statements can only happen at one place within a C++ translation unit.

Compiler Support

Compilers which CMake natively supports module dependency scanning include:

Generator Support

The list of generators which support scanning sources for C++ modules include:

Limitations

There are a number of known limitations of the current C++ module support in CMake.  This does not document known limitations or bugs in compilers as these can change over time.

For all generators:

  • Header units are not supported.
  • No builtin support for import std; or other compiler-provided modules.

For the Ninja Generators:

  • ninja 1.11 or newer is required.

For the Visual Studio Generators:

  • Only Visual Studio 2022 and MSVC toolsets 14.34 (Visual Studio 17.4) and newer.
  • No support for exporting or installing BMI or module information.
  • No support for compiling BMIs from IMPORTED targets with C++ modules.
  • No diagnosis of using modules provided by PRIVATE sources from PUBLIC module sources.

Referenced By

cmake-policies(7), cmake-properties(7).

Feb 01, 2024 3.28.2 CMake