add_subdirectory

Добавить подкаталог в сборку.

add_subdirectory(source_dir [binary_dir] [EXCLUDE_FROM_ALL])

Добавляет подкаталог в сборку. Параметр source_dir указывает каталог, в котором расположены исходный файл CMakeLists.txt и файлы кода. Если это относительный путь, он будет интерпретирован относительно текущего каталога (обычное использование), но также может быть абсолютным путём. Параметр binary_dir указывает каталог, в котором следует разместить выходные файлы. Если это относительный путь, он будет интерпретирован относительно текущего каталога вывода, но также может быть абсолютным путём. Если binary_dir не указан, будет использовано значение source_dir, перед расширением любого относительного пути (обычное использование). Файл CMakeLists.txt в указанном каталоге исходников будет обработано CMake сразу же перед продолжением обработки текущего входного файла после этой команды.

Если предоставлен аргумент EXCLUDE_FROM_ALL, тогда цели в подкаталоге по умолчанию не будут включены в цель ALL родительского каталога и будут исключены из файлов проектов IDE. Пользователи должны явно собирать цели в подкаталоге. Это предназначено для использования в тех случаях, когда подкаталог содержит отдельную часть проекта, которая полезна, но не необходима, например, набор примеров. Обычно подкаталог должен содержать вызов команды project() для генерации полной системы сборки в подкаталоге (например, файл решения VS IDE). Обратите внимание, что межцелевые зависимости имеют приоритет над этим исключением. Если цель, собранная родительским проектом, зависит от цели в подкаталоге, цель-зависимость будет включена в систему сборки родительского проекта для удовлетворения зависимости.