UNITY_BUILD

Когда данное свойство установлено в значение true, целевые исходные файлы будут объединены в пакеты для более быстрого компиляции. Это делается путем создания (набора) единых исходных файлов, #include исходных файлов, а затем компиляции этих единых исходных файлов вместо оригинальных. Это известно как Unity или Jumbo сборка. Свойство UNITY_BUILD_BATCH_SIZE контролирует верхний предел количества источников, которые могут быть объединены в один единый исходный файл.

Сборки Unity в настоящее время не поддерживаются для всех языков. CMake версии 3.17.5 поддерживает объединение C и CXX исходных файлов. Для целей, которые смешивают исходные файлы более чем одного языка, CMake будет разделять языки таким образом, чтобы каждый сгенерированный единый исходный файл содержал только источники одного языка.

Это свойство инициализируется значением переменной CMAKE_UNITY_BUILD при создании цели.

ODR (Правило одной дефиниции) ошибки

Когда несколько исходных файлов включаются в один исходный файл, как это делается для сборок Unity, это потенциально может привести к ошибкам ODR. CMake предоставляет ряд мер для решения таких проблем:

• Любой исходный файл, у которого свойство COMPILE_OPTIONS, COMPILE_DEFINITIONS, COMPILE_FLAGS или INCLUDE_DIRECTORIES исходного файла не пусто, не будет объединен в единый исходный файл.
• Проекты могут предотвратить объединение отдельного исходного файла в единый исходный файл, установив его свойство SKIP_UNITY_BUILD_INCLUSION в значение true. Это может быть более эффективным способом предотвращения проблем со специфическими файлами, чем отключение сборок Unity для всей цели.
• Свойства цели UNITY_BUILD_CODE_BEFORE_INCLUDE и UNITY_BUILD_CODE_AFTER_INCLUDE могут быть использованы для вставки кода в единые исходные файлы до и после каждого #include оператора.
• Порядок добавления исходных файлов в цель с помощью команд, таких как add_library(), add_executable() или target_sources(), будет сохранен в сгенерированных единых исходных файлах. Это можно использовать для ручного обеспечения конкретной группировки на основе свойства цели UNITY_BUILD_BATCH_SIZE.