Help/generator/Ninja.rst
Generates a build.ninja file into the build tree.
Builtin Targets ^^^^^^^^^^^^^^^
all
Depends on all targets required by the project, except those with
:prop_tgt:EXCLUDE_FROM_ALL set to true.
install
Runs the install step.
install/strip
.. versionadded:: 3.7
Runs the install followed by a ``CMAKE_STRIP`` command, if any.
The ``CMAKE_STRIP`` variable will contain the platform's ``strip`` utility, which
removes symbols information from generated binaries.
install/parallel
.. versionadded:: 3.30
Created only if the :prop_gbl:`INSTALL_PARALLEL` global property is ``ON``.
Runs the install step for each subdirectory independently and in parallel.
For each subdirectory sub/dir of the project, additional targets
are generated:
sub/dir/all
.. versionadded:: 3.6
Depends on all targets required by the subdirectory.
sub/dir/install
.. versionadded:: 3.7
Runs the install step in the subdirectory, if any.
sub/dir/install/strip
.. versionadded:: 3.7
Runs the install step in the subdirectory followed by a ``CMAKE_STRIP`` command,
if any.
sub/dir/test
.. versionadded:: 3.7
Runs the test step in the subdirectory, if any.
sub/dir/package
.. versionadded:: 3.7
Runs the package step in the subdirectory, if any.
Fortran Support ^^^^^^^^^^^^^^^
.. versionadded:: 3.7
The Ninja generator conditionally supports Fortran when the ninja
tool is at least version 1.10 (which has the required features).
Swift Support ^^^^^^^^^^^^^
.. versionadded:: 3.15
The Swift support is experimental, not considered stable, and may change in future releases of CMake.
See Also ^^^^^^^^
.. versionadded:: 3.17
The :generator:Ninja Multi-Config generator is similar to the Ninja
generator, but generates multiple configurations at once.