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