include

Загрузка и выполнение кода CMake из файла или модуля.

include(<file|module> [OPTIONAL] [RESULT_VARIABLE <var>]
                      [NO_POLICY_SCOPE])

Загружает и выполняет код CMake из указанного файла. Чтение и запись переменных осуществляются в области видимости вызывающего элемента (динамическое область видимости). Если OPTIONAL присутствует, то ошибка не возникает, если файла не существует. Если RESULT_VARIABLE задан, переменная <var> будет установлена в полное имя включённого файла или NOTFOUND в случае ошибки.

Если указан модуль вместо файла, то сначала ищется файл с именем <modulename>.cmake в CMAKE_MODULE_PATH, а затем в директории модулей CMake. Есть одно исключение: если файл, вызывающий include(), находится в директории встроенных модулей CMake, то сначала ищется директория встроенных модулей CMake, а затем CMAKE_MODULE_PATH. См. также политику CMP0017.

См. документацию команды cmake_policy() для обсуждения опции NO_POLICY_SCOPE.