UNITY_BUILD_BATCH_SIZE

Определяет максимальное количество исходных файлов, которые могут быть объединены в один файл unity-источника при включении сборки unity с помощью свойства целевого объекта UNITY_BUILD. Исходные файлы будут распределены по нескольким файлам unity-источника по мере необходимости для соблюдения этого ограничения.

Начальное значение этого свойства взято из переменной CMAKE_UNITY_BUILD_BATCH_SIZE при создании целевого объекта. Если эта переменная не установлена, начальное значение будет 8.

Размер пакета необходимо тщательно выбирать. Если он установлен слишком высоким, размер объединенных исходных файлов может привести к тому, что компилятор будет использовать чрезмерное количество памяти или столкнется с другими подобными ограничениями. В крайних случаях это может даже привести к сбоям сборки. С другой стороны, если размер пакета слишком низкий, выгода для производительности сборки будет небольшой.

Несмотря на настоятельно не рекомендуемую практику, размер пакета может быть установлен в значение 0, чтобы объединить все источники для целевого объекта в один файл unity, независимо от количества источников. Это рискует создать чрезмерно большой файл unity-источника и негативно повлиять на производительность сборки, поэтому значение 0 обычно не рекомендуется.