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.17/command/cmake_minimum_required.html
