<<Modern CMake>> 翻译 2. CMake 基础

最低版本

这是每个 

CMakeLists.txt

CMakeLists.txt

cmake_minimum_required(VERSION 3.1)

我们来了解一点 CMake 语法。 命令名称 

cmake_minimum_required

这一行很特别！2 版本号也同时指明了 CMake 的行为变化。 因此，如果你设置 

minimum_required

VERSION 2.8

在 CMake 3.12 中，可以这样写来指定支持的 CMake 版本范围，例如 

VERSION 3.1...3.12

新项目应该这样写：

cmake_minimum_required(VERSION 3.1...3.15)

if(${CMAKE_VERSION} VERSION_LESS 3.12)
cmake_policy(VERSION ${CMAKE_MAJOR_VERSION}.${CMAKE_MINOR_VERSION})
endif()

如果 CMake 版本小于 3.12，则 if 块将为 true，并且策略将设置为当前 CMake 版本。 如果 CMake 为 3.12 或更高，if 块将为 false，此时新语法 

cmake_minimum_required

警告：MSVC 的 CMake 服务器模式最初在读取此格式时有一个 bug， 因此如果您需要支持旧版 MSVC 的非命令行 Windows 版本，则需要执行以下操作：

cmake_minimum_required(VERSION 3.1)
if(${CMAKE_VERSION} VERSION_LESS 3.15)
cmake_policy(VERSION ${CMAKE_MAJOR_VERSION}.${CMAKE_MINOR_VERSION})
else()
cmake_policy(VERSION 3.15)
endif()

如果您确实需要在此处设置较低的版本，则可以使用 

cmake_policy

设置项目

现在，每个顶级 CMake 文件(

CMakeLists.txt

project(MyProject VERSION 1.0
DESCRIPTION "非常出色的项目"
LANGUAGES CXX)

现在我们看到了更多的新语法。 字符串被引号包围起来，空格可多可少，项目名称是第一个参数（位置参数）。 这里的所有的关键字参数都是可选的。 通过 

VERSION

MyProject_VERSION

PROJECT_VERSION

LANGUAGE

project

你可以通过使用 

#

项目名称没什么特别之处。此时不添加任何目标。

生成可执行文件

虽然链接库更有趣，通常我们大部分时间都在生成链接库，但这里我们要从一个简单的可执行文件开始。

add_executable(one two.cpp three.h)

这里有几件要说明的事情。 

one

生成链接库

使用 

add_library

add_library(one STATIC two.cpp three.h)

您可以选择链接库类型：STATIC，SHARED 或 MODULE。 如果没有设置，CMake 会根据变量 

BUILD_SHARED_LIBS

正如您将在下一节中看到的那样，通常您需要创建一个伪目标，也就是一个不需要编译任何文件的目标，例如，对于仅包含头文件的库。这也可以称为 INTERFACE 库; 唯一的区别是接口库不能跟文件名。

您还可以用一个现有的链接库生成一个 

ALIAS

::

配置构建目标

现在我们已经指定了目标，然后我们怎么给它添加相关信息呢？例如，它可能需要一个 

include

target_include_directories(one PUBLIC include)

target_include_directories

include

PUBLIC

PRIVATE

INTERFACE

现在，我们可以把目标串联起来：

add_library(another STATIC another.cpp another.h)
target_link_libraries(another PUBLIC one)

target_link_libraries

one

one

PUBLIC

主要关注在任何地方使用目标和关键字，这就对了。

目标可以包含目录，链接库（或链接目标），编译选项，编译定义，编译特征（参见 C++11 章节）等。 正如您将在两个包括项目章节中看到的那样，您通常可以使用目标（并始终制作目标）来表示所有你使用的链接库。 即使那不是真正的链接库的，比如 OpenMP，也可以用目标来表示。 这就是现代 CMake 很棒的原因！

开始动手实践

看看您是否可以理解以下文件操作。 它创建了一个简单的 C++11 链接库和一个使用它的程序。 没有依赖。 我稍后将使用 CMake 3.8 系统讨论更多 C++ 标准选项。

cmake_minimum_required(VERSION 3.8)

project(Calculator LANGUAGES CXX)

add_library(calclib STATIC src/calclib.cpp include/calc/lib.hpp)
target_include_directories(calclib PUBLIC include)
target_compile_features(calclib PUBLIC cxx_std_11)

add_executable(calc apps/calc.cpp)
target_link_libraries(calc PUBLIC calclib)

FATAL_ERROR

::

INTERFACE IMPORTED

target_*

IMPORTED

IMPORTED

ALIAS