UNITY_BUILD_BATCH_SIZE

添加于 3.16 版本。

指定当通过 UNITY_BUILD 目标属性启用 unity 构建时，可以合并到任何一个 unity 源文件中的最大源文件数量。原始源文件将根据需要分布在尽可能多的 unity 源文件中，以遵守此限制。

此属性的初始值取自创建目标时的 CMAKE_UNITY_BUILD_BATCH_SIZE 变量。如果该变量未设置，则初始值将为 8。

批处理大小需要仔细选择。如果设置得太高，组合源文件的大小可能会导致编译器使用过多的内存或达到其他类似限制。在极端情况下，这甚至可能导致构建失败。另一方面，如果批处理大小太小，构建性能的提升将很小。

尽管强烈不建议，但批处理大小可以设置为值 0，以将目标的所有源文件合并到单个 unity 文件中，无论涉及多少源文件。这有创建过大的 unity 源文件并对构建性能产生负面影响的风险，因此通常不建议使用值 0。