CMake C++ Modules

CMake module for C++ modules TS projects.

Warning

This is an experimental CMake module which uses current implementation of C++ Modules TS. There are a lot of issues and shouldn't be used in production code.

Supported compilers

• Clang 7
• MSVC
• [WIP] GCC

Usage

Download CXXModules.cmake file and include it into your CMake project.

The basic usage is put the file in same directory as CMakeLists.txt:

include(CXXModules.cmake)

Alternatively the file can stored in a path referenced in CMAKE_MODULE_PATH so you can only type:

include(CXXModules)

Now you have access to special functions which enable C++ modules support.

• target_enable_cxx_modules - enable C++ modules support for project. It just set compiler options for C++ modules.
• add_module_library - same as CMake's add_library but generate C++ module interface files from given source files and store that in CXX_MODULES_INTERFACE_FILES target property and set CXX_MODULES_INTERFACE_TARGETS which contains target names for creating interface files.
• add_module_executable - same as add_executable but enable C++ modules support.
• target_link_module_libraries - same as target_link_libraries but generate C++ modules interface files import flags for target.

Example

# Required CMake
cmake_minimum_required(VERSION 3.2.3)

# Include file with required functions
include(CXXModules.cmake)

# Use special function for creating C++ modules library.
# Same as add_library but also creates interface files
# and add required flags for current compiler
add_module_library(hello_world
    hello_world.cpp
)

# Create executable target
add_module_executable(main
    main.cpp
)

# Link C++ modules library to the executable
target_link_module_libraries(main hello_world)