Spec-Zone.ru › CMake

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API