生成与调用C++动态链接库(so文件)


前言

动态链接库是代码重用和模块化的重要工具,它使得将功能封装为独立的库更加容易,同时还可以动态加载和升级这些库,提高了程序的灵活性和可维护性。
当我们希望将C++源码编译成动态链接库,并在其他应用程序中调用这个动态链接库,是这篇文章的应用场景。这篇文档将介绍如何创建、编译、链接和调用C++动态链接库。
PS:本文以下内容根据我实际工作项目编写,不采用demo的形式。


生成C++动态链接库

步骤1:编写C++源码

首先,编写C++源码文件,包括所需的类和函数。(看这篇文章的应该都有源码了吧!)
我实际的项目文件如下:
在这里插入图片描述
现在需要把ai_main.cpp编译成动态链接库。难点在于(完成后看来也不是什么难点):ai_main.cpp不仅调用了同级目录下的其他文件,还调用了其他路径的下源码文件(opencv等)

步骤2:生成共享库

使用C++编译器将源码编译成共享库,我这里采用的是aarch64-mix210-linux-g++编译工具链:

  1. 在同级目录下创建一个名为"build"的文件夹,该文件夹将用于构建目标文件和.so文件。打开命令行终端并进入到该目录下。
mkdir build && cd build
  1. 运行以下命令,将所有依赖的cpp文件编译为目标文件(.o文件):
aarch64-mix210-linux-g++ -c -fPIC -I/home/data/ai/opencv/include -I/home/data/ai/Ascend/ascend-toolkit/5.10.t20.0.b200/arm64-lmixlinux200/aarch64-linux/include ../*.cpp

-c选项告诉编译器只进行编译而不进行链接操作。
-fPIC选项表示生成位置无关代码,这是生成共享库所必需的。
-I选项指定头文件目录,如果有其他cpp文件中使用了头文件,则需要将其添加到该选项中。
修改于2023年9月20日:添加了优化参数,使得后续生成的so库调用时间降低

aarch64-mix210-linux-g++ -c -fPIC -I/home/data/ai/opencv/include -I/home/data/ai/Ascend/ascend-toolkit/5.10.t20.0.b200/arm64-lmixlinux200/aarch64-linux/include ../*.cpp -O3 -flto -funroll-loops  -finline-functions
  1. 运行以下命令将目标文件链接为共享库文件.so
aarch64-mix210-linux-g++ -shared -o libmy_main.so *.o

-shared选项表示生成共享库文件。
-o选项指定输出文件名。
修改于2023年9月20日:添加了优化参数,使得后续生成的so库调用时间降低

aarch64-mix210-linux-g++ -shared -o libmy_main.so *.o  -O3 -flto -funroll-loops  -finline-functions 

完成后,你将在"build"文件夹中找到生成的libmy_main.so文件,这是可以给别人用来动态链接的共享库。
在这里插入图片描述

在上述命令中可以换成自己的编译工具(例如g++),需要根据实际情况修改文件名和路径。另外,如果代码中有其他库的依赖,你需要确保这些库已经安装并在编译/链接时正确配置了相关选项。

步骤3:验证生成的SO文件

通过运行以下命令来验证生成的SO文件是否可用:

file libmy_main.so

这应该显示类似于以下内容:

libmy_main.so: ELF 64-bit LSB shared object, ARM aarch64, version 1 (GNU/Linux), dynamically linked, not stripped

so文件生成成功。

检查符号链接:
运行以下命令,并确保输出中包含后续所需调用函数的定义。

nm libmy_main.so | grep ai_track

输出类似于:

0000000000061218 T ai_track

出现以上结果,说明ai_track函数在生成的共享库libmy_main.so中是可见的。这意味着该函数的定义在共享库中是存在的。ai_track需要替换成自己对外的接口函数,也就是其他程序调用so的函数。

调用C++动态链接库

现在,我们将展示如何在另一个C++程序中调用生成的C++动态链接库。我这是是做的测试,把原来源码编译部分替换成调用生成的so

步骤1:修改原来makefile

# 注释掉原来调用原代码部分
# SMP_SRCSCPP += $(wildcard $(PWD)/../media/ai/src/*.cpp)
# 添加共享库的头文件和库路径
COMM_INC += -I/home/ai/src/build/include
CFLAGS += -L/home/src/build/lib

# 添加共享库的链接标志,例如 libmy_main.so
CFLAGS += -lmy_main

# 如果共享库是C++库,添加C++编译器标志
CFLAGS += -lstdc++

其中:
COMM_INC += -I/home/ai/src/build/include:目录下为so提供的函数接口的头文件,可以直接复用源码中对应的ai_main.h
CFLAGS += -L/home/src/build/lib:确保 -L 选项中指定的共享库路径是正确的,并且包含了包含所需共享库libmy_main.so的目录;
CFLAGS += -lmy_main:通常,共享库名称应该是去掉 lib 前缀和 .so 后缀的部分。在这种情况下,libmy_main.so应该是 -lmy_main

步骤2:编译调用程序

我这里直接在原来的基础上重新编译:

make clean && make -j4

运行完成后会生成可执行文件,我这里可执行文件暂为run_main

步骤3:运行调用程序

运行run_main文件时,需要指定so动态链接库的路径

export LD_LIBRARY_PATH=/path/to/your/library:$LD_LIBRARY_PATH

或者,可以在使用运行时链接:

run_main -rpath /path/to/your/library

这将在运行时为应用程序指定共享库的搜索路径。

无论您选择哪种方法,都确保共享库的路径设置正确,以便您的应用程序可以正确找到和加载所需的共享库。


总结

本文介绍了如何制作C++动态链接库(so文件)以及如何从另一个C++程序中加载和调用该库。本文主要从笔者自身项目出发,其中的过程不一定适用所有人。
如果阅读本文对你有用,欢迎一键三连呀!!!
2023年9月5日14:25:02
在这里插入图片描述

猜你喜欢

转载自blog.csdn.net/JulyLi2019/article/details/132686129