UNITY_BUILD_BATCH_SIZE

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

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

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

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