UNITY_BUILD_BATCH_SIZE

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

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

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

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