UNITY_BUILD_BATCH_SIZE

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

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

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

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