C++系列2：CMakeLists步步为营

Posted 2021-05-15 IE06

1 生成可执行文件

1.1 基础: add_executable

cmakelists的核心只有一个add_executable

主函数代码如下：

1.2 生成目录: set(ececutable_output_path)

注意变化，多了一个bin目录

1.3 添加头文件: include “”

注意变化，添加了新的cpp和h文件，并且在main中include了h文件。cmakelists文件没有变化。

1.4 h文件挪到include文件夹：add_subdirectory

在src文件夹下新增加了一个cmakelists，使用add_subdirectory添加子文件夹的cmakelists。

2 生成库文件

2.1 将库函数分开：add_library

这里将函数myAdd放入到新的math文件夹中，主要变化是cmakelists目录结构，这里有了3个cmakelists（math文件夹下也有个）
生成库和引用库，两处都需注意：

• 生成部分，核心是add_library，此外一般需要include_directories指明头文件
• 引用部分，除了要用link_directories指明目录，还要使用target_link_libraries将库文件强行加载到主程序中。

此外注意，如果引用的是share库（.so结尾），那么so文件所依赖的库文件也不能缺（否则将所有缺失的文件放到编译的目录下）。

2.3 不指定库文件的位置也行

注意最下面两个cmakelists，我将set LIBRARY_OUTPUT_PATH和link_directories去除掉，仍旧能正常编译，因为有默认编译的文件夹，在项目文件夹下：

3 install

install的目的是将源码和生成的文件分开，在上面的例子中，我们要把两个cpp文件生成的主程序和库文件导出来，注意最外面cmakelists的变化，添加了4个install：

4 find_package引入第三方库

这里据个引入gflags的例子，这个库用来解析输入参数：

• main函数中：添加include头文件。主程序中有三个地方用到：对DEFINE_string(auth,"??",“chen”)初始化，gflags::ParseCommandLineFlags赋值，使用FLAGS_auth
• src/cmakelists中：find_package自动link_directories找到库函数位置，然后target_link_libraries进行加载

5 变量option和宏add_definition

option是编译时的变量，add_definition是程序中也可以使用的宏变量，主要格式是-D。

1. 使用option声明cmakelists的变量，并在cmakelists里面赋默认值，避免编译通不过
2. 使用add_definitions(-DENABLE_SWITCH)声明程序中可以使用的宏变量
3. 使用的时候，既可以在option里面修改为on，也可以在外面赋值为on。
   
   在上面这张图中，默认值设置为了off。