UNITY_BUILD_BATCH_SIZE

在 3.16 版本中新增。

指定當透過 UNITY_BUILD 目標屬性啟用合併建置時，可以組合到任何一個合併原始碼檔案中的原始碼檔案最大數量。原始的原始碼檔案將被分配到盡可能多的合併原始碼檔案中，以符合此限制。

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

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

儘管強烈不建議，批次大小可以設定為值 0，將目標的所有原始碼合併到單一的合併檔案中，無論涉及多少個原始碼。這會冒著創建過大的合併原始碼檔案的風險，並對建置效能產生負面影響，因此通常不建議使用值 0。