CMAKE_PROJECT_TOP_LEVEL_INCLUDES

Список, разделенный точкой с запятой файлов CMake языка, которые необходимо включить в качестве части самого первого вызова project(). Файлы будут включены сразу после того, как был прочитан файл конфигурации (если он указан) и были установлены платформенные переменные, но до включения каких-либо языков. Следовательно, языкоспецифичные переменные, включая такие как CMAKE_<LANG>_COMPILER, могут быть не установлены. См. Вставка кода для более подробного обсуждения файлов, которые могут быть включены во время вызова project().

Эта переменная предназначена для указания файлов, которые выполняют однократную настройку для сборки. Она предоставляет точку вставки для таких задач, как настройка менеджеров пакетов, добавление логики, которую пользователь разделяет между проектами (например, определение собственных типов сборки), и так далее. Она в первую очередь предназначена для пользователей для добавления вещей, специфичных для их среды, но не для указания деталей конфигурации инструментария (для этого используйте CMAKE_TOOLCHAIN_FILE).

По умолчанию эта переменная пустая. Она предназначена для установки пользователем.

См. также переменные CMAKE_PROJECT_INCLUDE, CMAKE_PROJECT_INCLUDE_BEFORE, CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE и CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE_BEFORE.