PROJECT_IS_TOP_LEVEL

Логическая переменная, указывающая, была ли последняя вызываемая команда project() в текущем или вышестоящем контексте в верхнем уровне CMakeLists.txt файла.

Некоторые модули следует включать только в составе верхнего уровня CMakeLists.txt файла, чтобы не создавать непредвиденных побочных эффектов в дереве сборки, и эту переменную можно использовать для условного выполнения такого кода. Например, рассмотрите модуль CTest, который создаёт цели и параметры:

project(MyProject)
...
if(PROJECT_IS_TOP_LEVEL)
  include(CTest)
endif()

Значение переменной будет истинным в:

• корневой директории проекта
• корневой директории внешнего проекта, добавленного с помощью ExternalProject

Значение переменной будет ложным в:

• директории, добавленной с помощью add_subdirectory()
• директории, добавленной с помощью FetchContent