【Qt】动态加载DLL之QLibrary类学习（内含完整Demo源码）

前言

本文代码测试环境：

一、QLibrary简介

QLibrary 类用于在运行时加载共享库。一个 QLibrary 对象实例操作一个单独的共享对象文件（也称为“库”或“DLL”）。

QLibrary 提供了一种平台独立的方式来访问库中的功能。你可以在构造函数中传递文件名，也可以通过 setFileName()显式设置文件名。

在加载库时，如果指定的不是绝对路径，QLibrary 会在系统默认的库路径中进行搜索（例如，Unix 系统上的 LD_LIBRARY_PATH）；反之如果在构造时指定了库的绝对路径，则会优先尝试该路径。

二、常用方法

2.1 构造函数

原型：

QLibrary(const QString &fileName, QObject *parent = Q_NULLPTR)

QObject *parent是可选参数，即可省略。

解释：
构造一个具有指定父对象的库对象，该对象将加载由fileName指定的库。Qt官方建议在fileName中省略文件的扩展名，因为Qlibrary会自动根据平台寻找带有适当后缀的文件，例如在Unix上为".so"，在macOS和iOS上为“.dylib”，在Windows上为“.dll”。

2.2 设置要访问的动态库——setFileName()

原型：

void setFileName(const QString &fileName)

解释：
fileName：要加载的共享库的文件名。它是一个QString类型的参数，可以是一个相对路径或绝对路径（个人建议使用绝对路径）。

2.3 加载动态库——load()

原型：

bool load()

解释：

load()方法用于加载由QLibrary对象当前设置的文件名指定的动态库。如果加载成功，该方法返回true，否则返回false。

2.4 获取动态库的名字——fileName()

原型：

QString fileName() const

解释：

fileName()方法用于获取Qlibrary对象当前所设置的动态库文件名。
这个文件名是在构造QLibrary对象时通过构造函数设置的，或者之后通过setFileName()方法设置的。

使用场景：
fileName() 方法通常用于调试或日志记录，以确认 QLibrary 对象当前所引用的库文件名是否正确。它也可以用于在动态加载库之前或之后检查文件名，以确保加载的是预期的文件。

2.5 解析共享库中的符号——resolve()

原型：

QFunctionPointer resolve(const char *symbol);

解释：

resolve()方法用于解析动态库中指定的符号，并返回一个指向该符号的函数指针。符号通常指的是库中的函数或全局变量名称。

参数：
symbol：要解析的符号的名称，以C字符串 (const char *) 的形式提供。
如果符号无法解析或库无法加载，则函数返回0。

注意事项：

1. 该方法有隐式加载的行为。即：如果动态库尚未被加载，调用resolve()方会隐式地尝试加载动态库。这是通过调用load()方法实现的，调用者不需要关心或处理这个加载过程的细节，QLibrary会在内部处理这些细节。
2. 解析的符号必须作为 C 函数从库中导出，这意味着如果使用C++编译器编译库，函数需要被封装在 extern C 块中。
3. 在Windows平台上，还需要使用 __declspec(dllexport) 宏来显示导出函数。

根据注意事项第2、第3条，给出以下示例代码 ↓ ↓ ↓：

  extern "C" 
  {
   
   
	  __declspec(dllexport) int avg(int a, int b)
	  {
   
   
	      return (a + b) / 2;
	  }
  }

三、示例（Demo）

看完以上内容，写个Demo练习巩固下。

Demo具体内容分为动态库部分和主程序部分：

1. 动态库：实现一个加法运算，将传递进来的数值相加，并将结果传回；
2. 主程序：使用QLibrary类加载、使用动态库。

这里粘贴部分主要源码（如.pro文件等，不在这里体现），整个项目见链接：可供学习Qt中QLibrary类的一个Demo，免费下载