UNITY_BUILD_BATCH_SIZE

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

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

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

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