UNITY_BUILD_BATCH_SIZE

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

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

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

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