1CMAKE_UNITY_BUILD 2----------------- 3 4.. versionadded:: 3.16 5 6This variable is used to initialize the :prop_tgt:`UNITY_BUILD` 7property of targets when they are created. Setting it to true 8enables batch compilation of multiple sources within each target. 9This feature is known as a *Unity* or *Jumbo* build. 10 11Projects should not set this variable, it is intended as a developer 12control to be set on the :manual:`cmake(1)` command line or other 13equivalent methods. The developer must have the ability to enable or 14disable unity builds according to the capabilities of their own machine 15and compiler. 16 17By default, this variable is not set, which will result in unity builds 18being disabled. 19 20.. note:: 21 This option currently does not work well in combination with 22 the :variable:`CMAKE_EXPORT_COMPILE_COMMANDS` variable. 23