CMake——cmake_minimum_required

命令简介

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)