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

1,270 阅读4分钟

一、前言

在上一篇文章中(使用 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】内联汇编很可怕吗?看完这篇文章,终结它!