build_command ------------- Get a command line to build the current project. This is mainly intended for internal use by the :module:`CTest` module. .. code-block:: cmake build_command( [CONFIGURATION ] [PARALLEL_LEVEL ] [TARGET ] [PROJECT_NAME ] # legacy, causes warning ) Sets the given ```` to a command-line string of the form:: --build . [--config ] [--parallel ] [--target ...] [-- -i] where ```` is the location of the :manual:`cmake(1)` command-line tool, and ````, ```` and ```` are the values provided to the ``CONFIGURATION``, ``PARALLEL_LEVEL`` and ``TARGET`` options, if any. The trailing ``-- -i`` option is added for :ref:`Makefile Generators` if policy :policy:`CMP0061` is not set to ``NEW``. When invoked, this :option:`cmake --build` command line will launch the underlying build system tool. .. versionadded:: 3.21 The ``PARALLEL_LEVEL`` argument can be used to set the :option:`--parallel ` flag. .. code-block:: cmake build_command( ) This second signature is deprecated, but still available for backwards compatibility. Use the first signature instead. It sets the given ```` to a command-line string as above but without the :option:`--target ` option. The ```` is ignored but should be the full path to devenv, nmake, make or one of the end user build tools for legacy invocations. .. note:: In CMake versions prior to 3.0 this command returned a command line that directly invokes the native build tool for the current generator. Their implementation of the ``PROJECT_NAME`` option had no useful effects, so CMake now warns on use of the option.