UNITY_BUILD_MODE

CMake предоставляет различные алгоритмы для выбора источников, которые объединяются в пакет. Выбор определяется этой настройкой, которая имеет следующие допустимые значения:

BATCH

В этом режиме CMake определяет, какие файлы объединяются вместе. Свойство UNITY_BUILD_BATCH_SIZE контролирует максимальное количество источников, которые могут быть объединены в один файл единого источника.

Пример использования:

add_library(example_library
            source1.cxx
            source2.cxx
            source3.cxx
            source4.cxx)

set_target_properties(example_library PROPERTIES
                      UNITY_BUILD_MODE BATCH
                      UNITY_BUILD_BATCH_SIZE 2
                      )

GROUP

В этом режиме каждый целевой объект явно указывает, как сгруппировать исходные файлы. Каждый исходный файл, имеющий одинаковое значение свойства UNITY_GROUP, будет сгруппирован вместе. Любые источники, у которых нет этого свойства, будут компилироваться индивидуально. Свойство UNITY_BUILD_BATCH_SIZE игнорируется при использовании этого режима.

Пример использования:

add_library(example_library
            source1.cxx
            source2.cxx
            source3.cxx
            source4.cxx)

set_target_properties(example_library PROPERTIES
                      UNITY_BUILD_MODE GROUP
                      )

set_source_files_properties(source1.cxx source2.cxx source3.cxx
                            PROPERTIES UNITY_GROUP "bucket1"
                            )
set_source_files_properties(source4.cxx
                            PROPERTIES UNITY_GROUP "bucket2"
                            )

Если явное значение UNITY_BUILD_MODE не указано, CMake будет использовать значение по умолчанию BATCH.