使用 cmake 来搭建跨平台的应用程序框架：C++版本

Posted 2021-07-21 IOT物联网小镇

文章目录

• • 一、前言
  • 二、示例代码说明
  • • • 1. 功能描述
      • 2. 文件结构
  • 三、Linux 系统下操作
  • • • 1. 通过 cmake 指令，生成 Makefile 文件
      • 2. 编译 libA
      • 3. 编译 libB
      • 4. 编译可执行程序 appC
  • 四、Windows 系统下操作
  • • • 1. 生成 VS 解决方案
      • 2. 编译 libA
      • 3. 编译 libB
      • 4. 编译 appC
  • 五、总结

一、前言

在上一篇文章中(使用 cmake 来搭建跨平台的应用程序框架：C语言版本)，我们以源代码的形式，演示了利用利用 cmake 这个构建工具，来编译跨平台的动态库、静态库和应用程序。

这篇文章描述的是同样的功能，只不过是用 C++ 来编码，另外，增加了一个小功能：如果在导出的库文件中，使用另一个第三方库。

在公众号后台留言【506】，可以收到示例代码。在 Linux/Windows 系统中可以直接编译、执行，拿来即用。

二、示例代码说明

1. 功能描述

示例代码的主要目的，是用来描述如何组织一个跨平台的应用程序结构。它的功能比较简单，如下图所示：

2. 文件结构

1. libA: 编译得到库文件 libA.so/libA.a;

2. libB: 编译得到库文件 libB.so/libB.a，它需要调用 libA 库中的函数;

3. appC：应用程序，它需要调用 libB 库中的函数；

三、Linux 系统下操作

1. 通过 cmake 指令，生成 Makefile 文件

为了不污染源代码，我们新建一个 build 目录，然后在其中编译：

$ make build
$ cd build
$ cmake ..

编译输出结果：

2. 编译 libA

$ cd libA/src
$ make

编译结果如下：

安装到源码下的 output 目录:

$ make install

此时，相关文件被安装到源码路径下 libA 的 output 目录下:

3. 编译 libB

由于 libB 调用了 libA 中的函数，因此需要手动把相关头文件和库文件复制到 libB 目录下，当然，这个步骤也可以写在 CMakeLists.txt 中。

然后进入 build/libB/src 目录，执行编译指令：

$ cd build/libB/src
$ make

同样的，把 libB 生成的库文件和头文件，复制到源码中的 libB/output 目录下：

4. 编译可执行程序 appC

由于 appC 调用了 libB 中的函数，因此需要手动把相关头文件和库文件复制到 appC 目录下的 include　和　lib/linux 目录下。

此外，由于我一直使用动态库，所以还需要把 libA 的头文件和库文件也复制到 appC 目录下。

然后进入 build/appC/src 目录，执行编译指令：

$ cd build/appC/src
$ make

执行输出结果：

四、Windows 系统下操作

1. 生成 VS 解决方案

在 build 目录下执行 cmake ..，得到 VS 解决方案：

打开工程文件 CppFrame.sln，右侧的解决方案如图：

2. 编译 libA

在 libA_shared 上单击右键，选择【生成】：

可以看到，在 build\\libA\\src\\Debug 目录下看到编译生成的文件：

这里有一个问题需要注意一下：在 libA/src/CMakeLists.txt 中，如果编译动态库，请如下设置：

如果编译静态库，请如下设置：

这几个宏定义，需要结合 ADll.h 中的定义来理解，主要是解决 Windows 平台下的动态库的导出与导入问题。

在下面编译 libB 库的时候，也需要同样的操作。

3. 编译 libB

由于 libB 调用了 libA 中的函数，因此，需要手动把 libA 库相关的头文件和库文件复制到 libB　目录下。

在 libB_shared 目标上，单击【生成】，编译输出如下:

此时，在 build/libB/src/Debug 目录下，看到生成的库文件：

我们把 libB 库文件和头文件，手动复制到 appC 目录下备用。

4. 编译 appC

在 VS 的 main 目标上，单击【生成】，编译输出如下：

此时，在 build\\appC\\src\\Debug 目录下即可看到可执行程序 main.exe。

为了执行这个程序，还需要把 libA.dll, libB.dll 复制到当前目录下才可以，如下所示：

五、总结

这篇文章的操作过程主要以动态库为主，如果编译、使用静态库，执行过程是一样一样的。

如果操作过程有什么问题，欢迎留言、讨论，谢谢！

在公众号后台留言【506】，可以收到示例代码。在 Linux/Windows 系统中可以直接编译、执行，拿来即用。

祝您好运！

---------- End ---------- Hi~你好，我是道哥，一枚嵌入式开发老兵。
推荐阅读

【1】C语言指针-从底层原理到花式技巧，用图文和代码帮你讲解透彻
【2】C指针的这些使用技巧，掌握后立刻提升一个Level
【3】提高代码逼格的利器：宏定义-从入门到放弃
【4】原来gdb的底层调试原理这么简单
【5】一步步分析-如何用C实现面向对象编程
【6】我最喜欢的进程之间通信方式-消息总线
【7】如何利用Google的protobuf，来思考、设计、实现自己的RPC框架
【8】都说软件架构要分层、分模块，具体应该怎么做(一)
【9】都说软件架构要分层、分模块，具体应该怎么做(二)
【10】内联汇编很可怕吗？看完这篇文章，终结它！