include

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

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

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

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

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