Using Ninja Multi‐Config

Introduction

CMake offers a special build system generator for ninja named Ninja Multi-Config capable of generating build scripts for all its default build types.

Helpful Resources

• Ninja Multi-Config
• CMAKE_CONFIGURATION_TYPES

Description

• When configuring a CMake project, use the Ninja Multi-Config generator:

cmake -Bbuild -G "Ninja Multi-Config" --toolchain /path/to/your-iar-toolchain-file.cmake

• Build each build configuration

cmake --build build --config Debug
cmake --build build --config Release
cmake --build build --config RelWithDebInfo

Minimal Size Release (MinSizeRel)

By default, CMake does not include MinSizeRel in CMAKE_CONFIGURATION_TYPES for the "Ninja Multi-Config" generator.

If you are interested in obtaining the binary with the minimal size generated by the IAR compiler:

• Append MinSizeRel to the CMAKE_CONFIGURATION_TYPES right before you define your project()

list(APPEND CMAKE_CONFIGURATION_TYPES MinSizeRel) 

• Configure the build system as described earlier

cmake -Bbuild -G "Ninja Multi-Config" --toolchain /path/to/your-iar-toolchain-file.cmake

• Build for minimal binary size

cmake --build build --config MinSizeRel