cmake_minimum_required

Требуется минимальная версия cmake.

cmake_minimum_required(VERSION <min>[...<max>] [FATAL_ERROR])

Устанавливает минимально необходимую версию cmake для проекта. Также обновляет параметры политики, как описано ниже.

<min> и необязательная <max> являются версиями CMake в формате major.minor[.patch[.tweak]], а ... — литеральная строка.

Если текущая версия CMake ниже требуемой <min>, обработка проекта будет остановлена, и будет выведено сообщение об ошибке. Необязательная версия <max>, если указана, должна быть не ниже версии <min> и влияет на настройки политики, как описано ниже. Если текущая версия CMake старше 3.12, дополнительные точки ... будут восприняты как разделители компонентов версии, что приведёт к игнорированию части ...<max> и сохранению поведения до версии 3.12, где политики базировались на <min>.

Вариант FATAL_ERROR принимается, но игнорируется CMake 2.6 и выше. Он должен быть указан, чтобы версии CMake 2.4 и ниже завершались с ошибкой, а не просто предупреждением.

Примечание

Вызовите команду cmake_minimum_required() в начале файла верхнего уровня CMakeLists.txt даже перед вызовом команды project(). Важно установить настройки версий и политики перед вызовом других команд, поведение которых они могут повлиять. Смотрите также политику CMP0000.

Вызов cmake_minimum_required() внутри function() ограничивает некоторые эффекты областью действия функции при вызове. Такие вызовы не должны использоваться с целью достижения глобальных эффектов.

Настройки политики

Команда cmake_minimum_required(VERSION) неявно вызывает команду cmake_policy(VERSION) для указания, что текущий проект написан для заданного диапазона версий CMake. Все политики, известные текущей версии CMake и введённые в версии <min> (или <max>, если указано) или ранее, будут установлены для использования поведения NEW. Все политики, введённые в более поздних версиях, будут сняты. Это фактически запрашивает поведение, предпочтительное с определённой версии CMake, и сообщает более новым версиям CMake о предупреждении об их новых политиках.

Когда версия <min> выше 2.4, команда неявно вызывает

cmake_policy(VERSION <min>[...<max>])

что устанавливает политики CMake на основе указанного диапазона версий. Когда версия <min> 2.4 или ниже, команда неявно вызывает

cmake_policy(VERSION 2.4[...<max>])

что включает функции совместимости для CMake 2.4 и ниже.

© 2000–2020 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.16/command/cmake_minimum_required.html