UNITY_BUILD_BATCH_SIZE

在 3.16 版本中新增。

指定當 unity 建置透過 UNITY_BUILD 目標屬性啟用時，可以合併到任何一個 unity 原始檔中的原始檔最大數量。原始原始檔將根據需要分佈在盡可能多的 unity 原始檔中，以符合此限制。

此屬性的初始值取自建立目標時的 CMAKE_UNITY_BUILD_BATCH_SIZE 變數。如果未設定該變數，則初始值將為 8。

批次大小需要仔細選擇。如果設定得太高，合併後原始檔的大小可能會導致編譯器使用過多的記憶體或達到其他類似的限制。在極端情況下，這甚至可能導致建置失敗。另一方面，如果批次大小太低，則建置效能的提升將微乎其微。

雖然強烈建議不要這樣做，但批次大小可以設定為值 0，以將目標的所有原始檔合併到單個 unity 檔案中，無論涉及多少原始檔。這會帶來建立過大的 unity 原始檔並對建置效能產生負面影響的風險，因此通常不建議使用值 0。