Gecko [ www.finalhopeacademy.com ]

Name	Size	Permission
Borland Makefiles.rst	66 B	-rw-r--r--
CodeBlocks.rst	1022 B	-rw-r--r--
CodeLite.rst	841 B	-rw-r--r--
Eclipse CDT4.rst	777 B	-rw-r--r--
Green Hills MULTI.rst	2.21 KB	-rw-r--r--
Kate.rst	701 B	-rw-r--r--
MSYS Makefiles.rst	421 B	-rw-r--r--
MinGW Makefiles.rst	476 B	-rw-r--r--
NMake Makefiles JOM.rst	66 B	-rw-r--r--
NMake Makefiles.rst	60 B	-rw-r--r--
Ninja Multi-Config.rst	3.49 KB	-rw-r--r--
Ninja.rst	1.18 KB	-rw-r--r--
Sublime Text 2.rst	820 B	-rw-r--r--
Unix Makefiles.rst	925 B	-rw-r--r--
VS_TOOLSET_HOST_ARCH.txt	453 B	-rw-r--r--
Visual Studio 10 2010.rst	1.35 KB	-rw-r--r--
Visual Studio 11 2012.rst	1.56 KB	-rw-r--r--
Visual Studio 12 2013.rst	1.51 KB	-rw-r--r--
Visual Studio 14 2015.rst	1.37 KB	-rw-r--r--
Visual Studio 15 2017.rst	2.15 KB	-rw-r--r--
Visual Studio 16 2019.rst	1.97 KB	-rw-r--r--
Visual Studio 6.rst	243 B	-rw-r--r--
Visual Studio 7 .NET 2003.rst	273 B	-rw-r--r--
Visual Studio 7.rst	253 B	-rw-r--r--
Visual Studio 8 2005.rst	262 B	-rw-r--r--
Visual Studio 9 2008.rst	1023 B	-rw-r--r--
Watcom WMake.rst	61 B	-rw-r--r--
Xcode.rst	319 B	-rw-r--r--

Code Editor : Ninja Multi-Config.rst

Ninja Multi-Config
------------------

Generates multiple ``build-<Config>.ninja`` files.

This generator is very much like the :generator:`Ninja` generator, but with
some key differences. Only these differences will be discussed in this
document.

Unlike the :generator:`Ninja` generator, ``Ninja Multi-Config`` generates
multiple configurations at once with :variable:`CMAKE_CONFIGURATION_TYPES`
instead of only one configuration with :variable:`CMAKE_BUILD_TYPE`. One
``build-<Config>.ninja`` file will be generated for each of these
configurations (with ``<Config>`` being the configuration name.) These files
are intended to be run with ``ninja -f build-<Config>.ninja``. A
``build.ninja`` file is also generated, using the configuration from either
:variable:`CMAKE_DEFAULT_BUILD_TYPE` or the first item from
:variable:`CMAKE_CONFIGURATION_TYPES`.

``cmake --build . --config <Config>`` will always use ``build-<Config>.ninja``
to build. If no ``--config`` argument is specified, ``cmake --build .`` will
default to ``build-Debug.ninja``, unless a ``build.ninja`` is generated (see
below), in which case that will be used instead.

Each ``build-<Config>.ninja`` file contains ``<target>`` targets as well as
``<target>:<Config>`` targets, where ``<Config>`` is the same as the
configuration specified in ``build-<Config>.ninja`` Additionally, if
cross-config mode is enabled, ``build-<Config>.ninja`` may contain
``<target>:<OtherConfig>`` targets, where ``<OtherConfig>`` is a cross-config,
as well as ``<target>:all``, which builds the target in all cross-configs. See
below for how to enable cross-config mode.

The ``Ninja Multi-Config`` generator recognizes the following variables:

:variable:`CMAKE_CONFIGURATION_TYPES`
  Specifies the total set of configurations to build.

:variable:`CMAKE_CROSS_CONFIGS`
  Specifies a :ref:`semicolon-separated list <CMake Language Lists>` of
  configurations available from all ``build-<Config>.ninja`` files.

:variable:`CMAKE_DEFAULT_BUILD_TYPE`
  Specifies the configuration to use by default in a ``build.ninja`` file.

:variable:`CMAKE_DEFAULT_CONFIGS`
  Specifies a :ref:`semicolon-separated list <CMake Language Lists>` of
  configurations to build for a target in ``build.ninja``
  if no ``:<Config>`` suffix is specified.

Consider the following example:

.. code-block:: cmake

cmake_minimum_required(VERSION 3.16)
  project(MultiConfigNinja C)

add_executable(generator generator.c)
  add_custom_command(OUTPUT generated.c COMMAND generator generated.c)
  add_library(generated ${CMAKE_BINARY_DIR}/generated.c)

Now assume you configure the project with ``Ninja Multi-Config`` and run one of
the following commands:

.. code-block:: shell

ninja -f build-Debug.ninja generated
  # OR
  cmake --build . --config Debug --target generated

This would build the ``Debug`` configuration of ``generator``, which would be
used to generate ``generated.c``, which would be used to build the ``Debug``
configuration of ``generated``.

But if :variable:`CMAKE_CROSS_CONFIGS` is set to ``all``, and you run the
following instead:

.. code-block:: shell

ninja -f build-Release.ninja generated:Debug
  # OR
  cmake --build . --config Release --target generated:Debug

This would build the ``Release`` configuration of ``generator``, which would be
used to generate ``generated.c``, which would be used to build the ``Debug``
configuration of ``generated``. This is useful for running a release-optimized
version of a generator utility while still building the debug version of the
targets built with the generated code.

${this.title}

Code Editor : Ninja Multi-Config.rst