UNITY_BUILD_BATCH_SIZE
Добавлено в версии 3.16.
Задаёт максимальное количество исходных файлов, которые можно объединить в один unity-файл при включении unity-сборок с помощью свойства цели UNITY_BUILD. Исходные файлы будут распределены по необходимому количеству unity-файлов, чтобы соблюсти это ограничение.
Начальное значение этого свойства берётся из переменной CMAKE_UNITY_BUILD_BATCH_SIZE при создании цели. Если эта переменная не задана, начальное значение будет равно 8.
Размер пакета следует выбирать тщательно. Если задать слишком большое значение, размер объединённых исходных файлов может привести к чрезмерному потреблению памяти компилятором или к достижению других подобных ограничений. В крайних случаях это даже может привести к сбою сборки. С другой стороны, если размер пакета слишком мал, прирост производительности сборки будет незначительным.
Хотя это настоятельно не рекомендуется, размер пакета можно установить равным 0, чтобы объединить все исходные файлы цели в один unity-файл независимо от их количества. Это может привести к созданию чрезмерно большого unity-файла и снижению производительности сборки, поэтому значение 0 обычно не рекомендуется.
© 2000–2026 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/latest/prop_tgt/UNITY_BUILD_BATCH_SIZE.html