CMAKE_PROJECT_TOP_LEVEL_INCLUDES

Добавлено в версии 3.24.

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

Добавлено в версии 3.29: Теперь эта переменная также может ссылаться на имена модулей, которые можно найти в CMAKE_MODULE_PATH или которые встроены в CMake.

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

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

См. также:

© 2000–2026 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/latest/variable/CMAKE_PROJECT_TOP_LEVEL_INCLUDES.html