CMake 教程跟做与翻译 2

目录

STEP 1(Extra A)：指定C++的版本

STEP1(Extra B): 为我们的项目添加版本信息与配置的头文件

Reference

---

STEP 1(Extra A)：指定C++的版本

有的时候，我们会是对一个比较年老的项目进行构建。这个时候，我们可能就需要限制一下使用的C/C++的版本（比如说使用的是C++98）来进行编译；或者，我们的项目很潮，使用的是C++17以上的版本，这个时候限制就显得更为必要了（一些新的特性需要新版本支持）。我们就需要作出限制。

在这里，我们需要使用到的就是：

CMAKE_CXX_STANDARD              # CMake里的C++标准变量
CMAKE_CXX_STANDARD_REQUIRED     # CMake里的一个BOOL变量，用于指示是否强迫版本
set()                           # 设置这些变量使用到的CMake函数

当然，我们只需要在CMakeLists.txt中，在project的下方和add_executable函数的上方加入

set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED True)

这就表达了我们需要强制使用C++11编译本项目的意思！

STEP1(Extra B): 为我们的项目添加版本信息与配置的头文件

有时，让 CMakelists.txt 文件中定义的变量在源代码中可用可能会很有用。在这种情况下，我们想打印项目版本。实现此目的的一种方法是使用已配置的头文件。我们创建一个包含一个或多个要替换的变量的输入文件。这些变量具有特殊的语法，看起来像 @VAR@。然后，我们使用 configure_file() 命令将输入文件复制到给定的输出文件，并用 CMakelists.txt 文件中 VAR 的当前值替换这些变量。

虽然我们可以直接在源代码中编辑版本，但最好使用此功能，因为它可以创建单一事实来源并避免重复。

项目的版本信息很容易添加，我在上一篇就说到了：

project(CharliesDemo VERSION 1.0)

下面，我们可以在源代码文件中使用了。使用的bridge在哪里呢？那就是使用CMake里的configure_file指令。

他的作用很简单：将input文件复制到output文件，并在输入文件内容中的变量，替换引用为@VAR@或${VAR}的变量值。每个变量引用将替换为该变量的当前值，如果未定义该变量，则为空字符串。

实际上就是做拷贝替换的工作

• COPYONLY：只拷贝文件，不进行任何的变量替换。这个选项在指定了NEWLINE_STYLE选项时不能使用（无效）。

• ESCAPE_QUOTES：躲过任何的反斜杠(C风格)转义。

• @ONLY：限制变量替换，让其只替换被@VAR@引用的变量(那么${VAR}格式的变量将不会被替换)。这在配置${VAR}语法的脚本时是非常有用的。

• NEWLINE_STYLE style：指定输出文件中的新行格式。UNIX和LF的新行是\n，DOS和WIN32和CRLF的新行格式是\r\n。这个选项在指定了COPYONLY选项时不能使用(无效)。

通常情况下，输入文件以.h.in为后缀，输出文件以.h为后缀。

我们下面来试试看：

#define VERSION_MAJOR @CharliesDemo_VERSION_MAJOR@
#define VERSION_MINOR @CharliesDemo_VERSION_MINOR@

引用工程的属性名称正式：工程名称+工程属性。我们的CMake在构建的时候就会替换我们的@VAR@为我们CMake的值。下面在CMake中配置：

configure_file(Config.h.in Config.h)

我们可以看看生成的Config.h文件

#define VERSION_MAJOR 1
#define VERSION_MINOR 0

使用一下，你会发现一个问题：

#include <stdio.h>
#include "Config.h"
#include "lib.h"
​
int main()
{
    printf("VERISON_MAJOR: %d", VERSION_MAJOR);
    printf("%d + %d = %d", 1, 2, my_add(1, 2));
}

gcc找不到我们的Config.h。这里需要超前的提供一个这样的命令：

target_include_directories(CharliesDemo PUBLIC "${PROJECT_BINARY_DIR}")

这句话的含义是：对于目标CharliesDemo提供要索引的目录为我们的build路径。这里正有Config.h!

下面我们来看看我们的CMakeLists.txt脚本：

cmake_minimum_required(VERSION 3.30)
​
project(CharliesDemo
        VERSION 1.0)
​
configure_file(Config.h.in Config.h)
​
add_executable(CharliesDemo lib.c main.c)
target_include_directories(CharliesDemo PUBLIC "${PROJECT_BINARY_DIR}")

看官自行回忆每一句话的含义。

Reference

_VERSION_MAJOR

_VERSION_MINOR

configure_file()

target_include_directories()

CMAKE_CXX_STANDARD

CMAKE_CXX_STANDARD_REQUIRED

set()