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). Обратите внимание, что зависимости между целевыми объектами имеют приоритет перед этим исключением. Если целевой объект, созданный родительским проектом, зависит от целевого объекта в подкаталоге, целевой объект-зависимость будет включен в систему сборки родительского проекта, чтобы удовлетворить зависимости.