UNITY_BUILD_BATCH_SIZE

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

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

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

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