574

In a GCC compiled project,

  • How do I run CMake for each target type (debug/release)?
  • How do I specify debug and release C/C++ flags using CMake?
  • How do I express that the main executable will be compiled with g++ and one nested library with gcc?
0

6 Answers 6

850

With CMake, it's generally recommended to do an "out of source" build. Create your CMakeLists.txt in the root of your project. Then from the root of your project:

mkdir Release
cd Release
cmake -DCMAKE_BUILD_TYPE=Release ..
make

And for Debug (again from the root of your project):

mkdir Debug
cd Debug
cmake -DCMAKE_BUILD_TYPE=Debug ..
make

Release / Debug will add the appropriate flags for your compiler. There are also RelWithDebInfo and MinSizeRel build configurations.


You can modify/add to the flags by specifying a toolchain file in which you can add CMAKE_<LANG>_FLAGS_<CONFIG>_INIT variables, e.g.:

set(CMAKE_CXX_FLAGS_DEBUG_INIT "-Wall")
set(CMAKE_CXX_FLAGS_RELEASE_INIT "-Wall")

See CMAKE_BUILD_TYPE for more details.


As for your third question, I'm not sure what you are asking exactly. CMake should automatically detect and use the compiler appropriate for your different source files.

11
  • 5
    You can also do a cmake -i .. instead, so cmake will run interactively, asking you which type of build you want (None, Release, Debug, MinSizeRel, RelWithDebInfo).
    – thiagowfx
    Dec 10, 2016 at 17:48
  • 8
    @thiagowfx -i option results in this error message: The "cmake -i" wizard mode is no longer supported.. I'm using cmake 3.7.1 Jan 4, 2017 at 21:01
  • 5
    Nice observation. It seems it was deprecated since version 3.0.0. Reference.
    – thiagowfx
    Jan 9, 2017 at 16:02
  • 9
    This is NOT an out of source build if you are creating a sub-directory! It is advised to create the build directory outside/above the source directory. Feb 19, 2017 at 10:50
  • 5
    I have to run cmake --build . --config Release to get release build. If you omit --config Release you always get debug build, regardless of cmake -DCMAKE_BUILD_TYPE=Release .. in the previous command. (cmake 3.21)
    – tedyyu
    Jul 16, 2021 at 6:08
68

A lot of the answers here are out of date/bad. So I'm going to attempt to answer it better. Granted I'm answering this question in 2020, so it's expected things would change.


How do I run CMake for each target type (debug/release)?

First off Debug/Release are called configurations in cmake (nitpick).

If you are using a single configuration generator (Ninja/Unix-Makefiles) you must specify the CMAKE_BUILD_TYPE.

Like this:

# Configure the build
cmake -S . -B build/ -D CMAKE_BUILD_TYPE=Debug

# Actually build the binaries
cmake --build build/

# Configure a release build
cmake -S . -B build/ -D CMAKE_BUILD_TYPE=Release

# Build release binaries
cmake --build build/

For multi-configuration generators it's slightly different (Ninja Multi-Config, Visual Studio)

# Configure the build
cmake -S . -B build

# Build debug binaries
cmake --build build --config Debug

# Build release binaries
cmake --build build --config Release

If you are wondering why this is necessary it's because cmake isn't a build system. It's a meta-build system (IE a build system that build's build systems). This is basically the result of handling build systems that support multiple-configurations in 1 build. If you'd like a deeper understanding I'd suggest reading a bit about cmake in Craig Scott's book "Professional CMake: A Practical Guide


How do I specify debug and release C/C++ flags using CMake?

The modern practice is to use target's and properties.

Here is an example:

add_library(foobar)

# Add this compile definition for debug builds, this same logic works for
# target_compile_options, target_link_options, etc.
target_compile_definitions(foobar PRIVATE
    $<$<CONFIG:Debug>:
        FOOBAR_DEBUG=1
    >
)

NOTE: How I'm using generator expressions to specify the configuration! Using CMAKE_BUILD_TYPE will result in bad builds for any multi-configuration generator!

Further more sometimes you need to set things globally and not just for one target. Use add_compile_definitions, add_compile_options, etc. Those functions support generator expressions. Don't use old style cmake unless you have to (that path is a land of nightmares)


How do I express that the main executable will be compiled with g++ and one nested library with gcc?

Your last question really doesn't make sense.

2
  • Kinda sucks that there aren't any warnings for multi-configuration generators when CMAKE_BUILD_TYPE is specified. I use Conan, which relies on it to figure out the build type. Because everything defaulted to the wrong values, my stuff got built with debug, while conan was (correctly) built with release, leading to a runtime library mismatch, and I assumed it was CMake setting it incorrectly. Spent far too many hours on that rabbit hole. I get that this is what CMake is supposed to do and all, but as a Linux main, this is utter pain. Real happy I don't do Windows regularly
    – Zoe is on strike
    Jan 25 at 0:17
  • You can use Ninja Multi-Config to test on linux.
    – jpr42
    Jun 9 at 23:10
30

For debug/release flags, see the CMAKE_BUILD_TYPE variable (you pass it as cmake -DCMAKE_BUILD_TYPE=value). It takes values like Release, Debug, etc.

https://gitlab.kitware.com/cmake/community/wikis/doc/cmake/Useful-Variables#compilers-and-tools

cmake uses the extension to choose the compiler, so just name your files .c.

You can override this with various settings:

For example:

set_source_files_properties(yourfile.c LANGUAGE CXX) 

Would compile .c files with g++. The link above also shows how to select a specific compiler for C/C++.

27

Instead of manipulating the CMAKE_CXX_FLAGS strings directly (which could be done more nicely using string(APPEND CMAKE_CXX_FLAGS_DEBUG " -g3") btw), you can use add_compile_options:

add_compile_options(
  "-Wall" "-Wpedantic" "-Wextra" "-fexceptions"
  "$<$<CONFIG:DEBUG>:-O0;-g3;-ggdb>"
)

This would add the specified warnings to all build types, but only the given debugging flags to the DEBUG build. Note that compile options are stored as a CMake list, which is just a string separating its elements by semicolons ;.

5
  • 2
    Won't list(APPEND CMAKE_CXX_FLAGS_DEBUG "-g3") add a semicolon before -g3 terminated the command and starting a new command -g3 which will surely fail?
    – cburn11
    Sep 14, 2018 at 13:46
  • You're right CMAKE_CXX_FLAGS is not a cmake list but a string of space-separated command line flags. I find that behavior inconsistent...
    – sebastian
    Sep 14, 2018 at 15:29
  • add_compile_options() is neat. It is complemented by add_link_options() for when you need to add options to the linker too such as -fsanitize=address. Dec 18, 2018 at 22:35
  • 6
    Is this still the appropriate way in 2020 / cmake 3.17? That last line looks nasty
    – Jay
    Apr 23, 2020 at 7:28
  • @Jay kinda. It is correct to use generator expressions. But the semi-colon thing isn't necessary and is honestly hard to read. See my answer. Also add_compile_options isn't always what you meant. It's a big hammer.
    – user12322620
    Nov 13, 2020 at 16:13
12

If you want to build a different configuration without regenerating if using you can also run cmake --build {$PWD} --config <cfg> For multi-configuration tools, choose <cfg> ex. Debug, Release, MinSizeRel, RelWithDebInfo

https://cmake.org/cmake/help/v2.8.11/cmake.html#opt%3a--builddir

3
  • I've tried to play with --config option without any result. It doesn't affect $<CONFIG> variable as -DCMAKE_BUILD_TYPE= does. Dec 28, 2019 at 22:44
  • You meant cmake --build $PWD --config <cfg>, BTW. Sep 8, 2020 at 16:51
  • CMake version 3.20.1: cmake --help does not show that --config is a valid argument. Perhaps it has been deprecated? When I use --config cmake returns CMake Error: Unknown argument --config
    – PfunnyGuy
    Oct 1, 2021 at 16:33
11

// CMakeLists.txt : release

set(CMAKE_CONFIGURATION_TYPES "Release" CACHE STRING "" FORCE)

// CMakeLists.txt : debug

set(CMAKE_CONFIGURATION_TYPES "Debug" CACHE STRING "" FORCE)
4
  • 18
    i don't understand why is this get down voted, it is real code which used in production, btw i don't care. Feb 2, 2018 at 0:26
  • 8
    Maybe because according to the CMake docs CMAKE_CONFIGURATION_TYPES contains the possible values for CMAKE_BUILD_TYPE. So you should set the latter as the other answers suggest. Maybe your solution works because it limits the possible choices to the one you'd like to have.
    – bjhend
    Feb 21, 2018 at 16:28
  • 5
    Upvote because this will work. I love me some CMake but there are quirks and sometimes you need to use big hammer to make things work. I have some projects that for one reason or another will reject the command line flag.
    – cory.todd
    May 16, 2018 at 17:30
  • 1
    Here's some additional information on why the setting may not work: stackoverflow.com/a/24470998/3196753
    – tresf
    Mar 26, 2019 at 1:49

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.