Skip to content

CMakePreset.json

Programming / cpp / cmake

CMake presets by creating a file named CMakePresets.json in your project root directory. The basic format for this file is:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
  "version": 3,
  "cmakeMinimumRequired": {
    "major": 3,
    "minor": 23,
    "patch": 0
  },
  "configurePresets": [
    {
      // ...
    }
  ],
  "buildPresets": [
    {
      // ...
    }
  ],
  "testPresets": [
    {
      // ...
    }
  ]
}

Preset types

Section Used by Purpose
"configurePresets" cmake --preset How to generate build files
"buildPresets" cmake --build --preset How to compile
"testPresets" ctest --preset How to run tests
"packagePresets" (optional) cpack --preset How to create installers (support cmake>3.24)

version field

version: 2 → CMake ≥ 3.20 version: 3 → CMake ≥ 3.21 version: 4 → CMake ≥ 3.23 version: 5 → CMake ≥ 3.24 version: 6 → CMake ≥ 3.25

1
2
ubuntu 22.04 default cmake : 3.22.1
ubuntu 24.04 default cmake : 3.28.3

Preset definition

Field Description
"name" Unique identifier (used in commands)
"displayName" Friendly label shown in IDE
"generator" Build tool (“Ninja”, “Unix Makefiles”, etc.)
"binaryDir" Output directory for this preset
"cacheVariables" Key-value pairs (like -D arguments)
"inherits" Reuse another preset’s settings
"environment" Environment variables set for this preset
"hidden" If true, not shown in IDE list but usable as a base preset 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
"configurePresets": [
        {
            "name": "default",
            "hidden": false,
            "generator": "Ninja",
            "description": "Default configure preset",
            "binaryDir": "${sourceDir}/build",
            "cacheVariables": {
                "CMAKE_BUILD_TYPE": "Release"
            }
        },
]

Using inheritance

Avoid repeating common options using inheritance

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
{
  "name": "base",
  "hidden": true,
  "generator": "Ninja",
  "cacheVariables": {
    "CMAKE_EXPORT_COMPILE_COMMANDS": "ON"
  }
},
{
  "name": "debug",
  "inherits": "base",
  "binaryDir": "${sourceDir}/build/debug",
  "cacheVariables": {
    "CMAKE_BUILD_TYPE": "Debug"
  }
}

TODO

check if multi inheritance work

Commands

1
cmake --list-presets

1
cmake --preset <name>

Demo

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
.
├── CMakeLists.txt
├── CMakePresets.json
├── include
│   └── demo
│       └── lib.hpp
├── src
│   ├── lib.cpp
│   └── main.cpp
└── test
   └── test_add.cpp
src/main.cpp
1
2
3
4
5
6
7
8
9
#include <iostream>
#include "demo/lib.hpp"

int main(int argc, char** argv) {
    std::string name = (argc > 1) ? argv[1] : "";
    std::cout << demo::greet(name) << "\n";
    std::cout << "2 + 3 = " << demo::add(2, 3) << "\n";
    return 0;
}
src/lib.cpp
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
#include "demo/lib.hpp"

namespace demo {

int add(int a, int b) {
    return a + b;
}

std::string greet(const std::string &name) {
    if (name.empty()) return "Hello, World!";
    return "Hello, " + name + "!";
}

} // namespace demo
include/demo/lib.hpp
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
#pragma once
#include <string>

namespace demo {

// Adds two integers and returns the sum.
int add(int a, int b);

// Returns a greeting message ("Hello, <name>!"). If name empty => "Hello, World!".
std::string greet(const std::string &name);

} // namespace demo
test/test_add.cpp
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
#include <gtest/gtest.h>
#include "demo/lib.hpp"

TEST(AddTests, BasicPositive) {
    EXPECT_EQ(demo::add(2,3), 5);
}

TEST(AddTests, NegativeAndPositive) {
    EXPECT_EQ(demo::add(-1,1), 0);
}

TEST(GreetTests, EmptyName) {
    EXPECT_EQ(demo::greet("") , "Hello, World!");
}

TEST(GreetTests, NonEmptyName) {
    EXPECT_EQ(demo::greet("Alice"), "Hello, Alice!");
}

// main provided by GTest::gtest_main
CMakePresets.json
1
--8<-- "docs/Programming/cpp/cmake/cmake_preset/code/CMakePresets.json">

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
cmake_minimum_required(VERSION 3.22)

# Project setup
project(DemoApp VERSION 0.1.0 LANGUAGES CXX)

# Options
option(DEMO_BUILD_TESTS "Build tests" ON)

# Library
add_library(demolib src/lib.cpp)
add_library(demo::demolib ALIAS demolib)

target_include_directories(demolib
    PUBLIC
        $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
        $<INSTALL_INTERFACE:include>
)

set_target_properties(demolib PROPERTIES
    CXX_STANDARD 17
    CXX_STANDARD_REQUIRED YES
    CXX_EXTENSIONS NO
)

# Executable
add_executable(demo_app src/main.cpp)

target_link_libraries(demo_app PRIVATE demo::demolib)
set_target_properties(demo_app PROPERTIES
    CXX_STANDARD 17
    CXX_STANDARD_REQUIRED YES
    CXX_EXTENSIONS NO
)

# Testing
include(CTest)
if (DEMO_BUILD_TESTS AND BUILD_TESTING)
    include(FetchContent)
    # Avoid overriding parent project's compiler/linker settings in gtest
    set(BUILD_GMOCK OFF CACHE BOOL "Disable gmock" FORCE)
    set(INSTALL_GTEST OFF CACHE BOOL "Disable gtest install" FORCE)
    FetchContent_Declare(
        googletest
        URL https://github.com/google/googletest/archive/refs/tags/v1.14.0.zip
    )
    FetchContent_MakeAvailable(googletest)
    enable_testing()
    add_executable(test_add test/test_add.cpp)
    target_link_libraries(test_add PRIVATE demo::demolib GTest::gtest_main)
    add_test(NAME test_add COMMAND test_add)
endif()

1
2
3
4
5
6
7
8
# configure
cmake --preset debug

# build
cmake --build --preset debug-build

# test
ctest --preset test-debug

Reference

cmake-preset