命令简介
cmake_minimum_required用于设定cmake的最低版本。
cmake_minimum_required(VERSION <min>[...<policy_max>] [FATAL_ERROR])
<min>:cmake的最低版本;
可选参数...<policy_max>:与<min>配合表示版本区间;
FATAL_ERROR:在cmake2.6及更高版本可被接受单被忽略,如果使用cmake2.4及以下版本则显示错误,而不仅仅是警告。
用途
当我们通过SVN或Git拉取使用cmake进行安装(编译)的项目时,由于目标机器上安装的cmake版本不可控。而本地工具太旧,可能存在新语法无法兼容。或本地工具版本太高,可能一些旧语法被移除等。
因此,我们通常制定cmake的版本,避免问题。
用法
指定cmake最低版本:
cmake_minimum_required(VERSION 3.25)
笔者这边安装的cmake版本:
C:\Users\Admin>cmake --version
cmake version 3.17.20200511-g8787079
CMake suite maintained and supported by Kitware (kitware.com/cmake).
因为本地安装的版本3.17低于CMakeLists.txt中要求的3.25:
CMake Error at CMakeLists.txt:1 (cmake_minimum_required):
CMake 3.25 or higher is required. You are running version
3.17.20200511-g8787079
当然也可以指定cmake的版本区间:
cmake_minimum_required(VERSION 3.17...3.25)