CMake 入门2 —— 一个链接动态库的简单工程

这一章我们将从一个通用常规工程的角度来看一个 CMake 工程的常用阻止结构。先来看看工程目录结构:

.
├── CMakeLists.txt
├── build
├── include
│   └── mylib.h
├── lib
│   ├── libmylib.a
└── src
    └── main.cpp

我们有 4 个文件夹,1 个 CMakeLists.txt 文件。

  • build 是用来存放使用 CMake 编译时所产生的中间文件。
  • include 存放我们源码所需要依赖的头文件。
  • lib 存放我们工程所需依赖的外部动态库。
  • src 存放我们的源码文件。

本章节的目的是,通过编写 CMakeLists.txt 来组织编译流程:编译 map.cpp,其中使用了 mylib.h 中声明的方法,方法定义在 libmylib.a 中,因此还需要链接 libmylib.a

准备工作

我们需要先编译出 libmylib.a
mylib.h 文件内容如下:

int myadd(int a, int b);
void myprint(int s);

mylib.cpp 文件内容如下:

#include 
#include "mylib.h"

int myadd(int a, int b) {
    return a + b;
}

void myprint(int s) {
    std::cout << s << std::endl;
}

将它们两个放在同一个目录下,使用命令 gcc -c mylib.cpp -o mylib.o 编译出目标文件(只是编译,没有链接,也就是引用的外部头文件中的方法将没有实现),然后用命令 ar rcv libmylib.a mylib.o 将目标文件 mylib.o 打包成动态库 libmylib.a

libmylib.a 放在 lib 目录下,这样我们就完成了准备工作。

编写 CMakeLists.txt

先看下最后的 CMakeLists.txt

cmake_minimum_required(VERSION 3.0)
project(hello)
include_directories(${CMAKE_CURRENT_LIST_DIR}/include)
aux_source_directory(${CMAKE_CURRENT_LIST_DIR}/src hello_src)
link_directories(${CMAKE_CURRENT_LIST_DIR}/lib)
add_executable(${PROJECT_NAME} ${hello_src})
target_link_libraries(${PROJECT_NAME} libmylib.a)

set(CMAKE_CXX_COMPILER "clang++")   # 显式指定所使用的 C++ 编译器
set(CMAKE_CXX_FLAGS "-std=c++11")   # c++11
set(CMAKE_CXX_FLAGS "-g")   # 调试信息
set(CMAKE_CXX_FLAGS "-Wall")    # 开启所有警告

set(CMAKE_CXX_FLAGS_DEBUG "-O0")    # 调试包不优化
set(CMAKE_CXX_FLAGS_RELEASE "-O2 -DNDEBUG") # release 包优化
最低版本要求

cmake_minimum_required(VERSION 3.0),通过这条代码指定该 CMakeLists.txt 中所使用的语法向下兼容到 3.0 版本。

给工程起个名字

project(hello),将工程名字设置为 hello。该方法将同时设置 CMake 的全局变量 ${PROJECT_NAME}

让 CMake 找到工程所需头文件

include_directories(${CMAKE_CURRENT_LIST_DIR}/include)。其中 ${CMAKE_CURRENT_LIST_DIR}CMake 自带变量,表示正在执行的 CMake 文件所在目录。

  • 注意这个命令所接受的参数是目录路径,该目录下的所有头文件都将被搜索到。因此,如果工程是一个对外发布的库,那么比较好的实践是 将其对外接口的头文件都放在统一的 include 文件夹中。这样,使用者只用 include 该头文件目录即可。
  • 该命令所添加的头文件搜索路径同样将向下传递到子 CMakeLists.txt 的头文件搜索路径中。
  • 该命令不递归搜索文件。
让 CMake 找到工程所需源文件

aux_source_directory(${CMAKE_CURRENT_LIST_DIR}/src hello_src)。第一个参数代表包含源文件的目录,不会递归搜索目录。将搜索到的源码文件(*.h, *.hpp 等结尾的头文件不会被搜索在内)路径会保存到变量 ${hello_src} 中。

官方文档上说,像这种自动搜索的命令(包括 file(GLOB_RECURSE ...) 等)会有一个问题:搜索的结果只会在运行 cmake 时被更新。因此,如果在源码文件路径下新增了一个源码文件的话,make 并不会编译这个新增的源码文件。需要再次调用 cmake 进行搜索。

让 CMake 找到库文件

link_directories(${CMAKE_CURRENT_LIST_DIR}/lib)。和 include_directories 一样,cmake 将在该目录下搜索需要链接的动态库。

告诉 CMake 我的构建目标

add_executable(${PROJECT_NAME} ${hello_src})。第一个参数是构建出来的可执行文件的名字,第二个参数是一个所有需要编译的源码文件 List,这里我们使用了 aux_source_directory 中所设置的变量 ${hello_src}。这条函数会生成名为 ${hello_src} 的可执行文件。

告诉 CMake 我要链接的库文件

target_link_libraries(${PROJECT_NAME} libmylib.a)。如果写了上面的 link_directories,那么这条函数就只用写库名就可以了。这里的库名可以使用 libmylib.a 这样的全名,也可以是 mylib 这样的只用按规则指定文件名。如果使用 mylib,那么会优先搜索 libmylib.a,其次搜索 libmylib.so

传递 FLAGS 给 C++ 编译器

如果 main.cpp 中用到了 C++11,那么就需要在生成的 Makefile 中告诉编译器启动 C++11

set(CMAKE_CXX_COMPILER "clang++")   # 显式指定所使用的 C++ 编译器
set(CMAKE_CXX_FLAGS "-std=c++11")   # c++11
set(CMAKE_CXX_FLAGS "-g")   # 调试信息
set(CMAKE_CXX_FLAGS "-Wall")    # 开启所有警告

set(CMAKE_CXX_FLAGS_DEBUG "-O0")    # 调试包不优化
set(CMAKE_CXX_FLAGS_RELEASE "-O2 -DNDEBUG") # release 包优化

开始构建

同 CMake 入门1 —— CMake Hello World 中一样,我们在 build 文件夹中执行 cmake ..,生成 Makefile 后执行 make,即可得到可执行文件 hello

hello 会生成在 build 文件夹下,如果想该自定义一个生成路径,那么可以使用 set(EXECUTABLE_OUTPUT_PATH ${CMAKE_CURRENT_LIST_DIR}/bin),该命令会在 CMakeLists.txt 所在目录下自动创建一个 bin 文件夹。make 所生成的可执行文件将放在 bin 目录下。

你可能感兴趣的:(CMake 入门2 —— 一个链接动态库的简单工程)