EXCLUDE_FROM_ALL

Установите для этого свойства каталога истинное значение в подкаталоге, чтобы исключить его цели из цели «all» родительских каталогов. Если подкаталог исключен, запуск, например, make в родительском каталоге по умолчанию не будет собирать цели подкаталога. Это не влияет на цель «all» самого подкаталога. Запуск, например, make внутри подкаталога по-прежнему будет собирать его цели.

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

Если указан аргумент EXCLUDE_FROM_ALL, это приводит к следующим эффектам:

• Цели, определенные в подкаталоге или ниже, не будут включены в цель ALL родительского каталога. Пользователь должен собрать эти цели явно или они должны быть зависимостью другой собираемой цели.
• Цели, определенные в подкаталоге или ниже, будут исключены из файлов проектов IDE.
• Все правила установки, определенные в подкаталоге или ниже, будут проигнорированы при установке родительского каталога.

Обратите внимание, что эти эффекты отличаются от эффектов свойства цели EXCLUDE_FROM_ALL.