cmake_minimum_required

Задать минимально необходимую версию cmake для проекта и обновить Настройки политики в соответствии с указанной версией:

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

<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(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 и ниже.