使用QLibrary加载动态库

最新推荐文章于 2024-09-20 17:16:50 发布

亭台六七座

最新推荐文章于 2024-09-20 17:16:50 发布

阅读量5.6k

点赞数 1

分类专栏： Qt-配置文章标签： QLibrary

Qt-配置专栏收录该内容

21 篇文章 3 订阅

订阅专栏

使用QLibrary可以在程序运行时加载动态链接库。一个QLibrary的实例作用于一个单一的共享库上。QLibrary提供了一种平台无关的方式访问库中的函数。可以在构建QLibrary的实例时将要加载的库文件传入，也可以在创建实例后使用setFileName()显式的设置要加载的文件名。当加载库文件时，QLibrary会搜索所有平台特定的库位置，除非传入的文件名具有绝对路径。

如果传入的文件名具有绝对路径，那么会首先尝试加载该目录。如果该文件找不到，QLibrary会使用不同的平台特定的文件前缀或后缀再次尝试，比如Unix和Mac平台的"lib"前缀，Unix平台的".so"后缀，Mac平台的".dylib"，Windows平台的".dll"。如果文件名不是绝对路径，QLibrary会修改搜索顺序，首先尝试系统特定的前缀和后缀，紧接着是指定的文件路径。

所以，基于QLibrary对库文件的搜索机制，我们推荐在传入库文件时只传入该库文件的基名，不写前缀或后缀。这样一来，同一份代码可以在不同的操作系统上工作，并且该机制会保证进行最小次数的搜索。

该类中最重要的函数是load()，该函数动态的加载库文件，isLoaded()可以用来检查库文件是否成功加载，而resolve()函数则用来解析库中的符号地址，主要是函数地址。并且，resolve()函数在库文件未被加载时会隐式的尝试加载它。多个QLibrary实例可以可以访问同一个库文件。因为，库文件一旦被加载，就会驻留在内存中直到应用程序终止。当然，我们可以使用unload()函数来尝试卸载一个库文件，但是如果有其他的QLibrary实例正在引用同一个库文件，unload（）会调用失败，并且该库文件会在所以实例都调用了unload（）后才被卸载。

QLibrary库的典型用法是去解析一个库中的导出符号，并调用该符号表示的C函数。这被称为“显式链接”，而相对的“隐式链接”是在编译过程的链接阶段完成的。如下面的代码显示的那样，改代码先加载一个库，解析其中的"mysymbol"符号，并在成功的情况下，调用该函数。如果由于某种原因出错了，例如库文件不存在或该符号未被定义，那么相应的函数指针将被设为空，不会发生实际的调用：

[cpp]view plain copy 
   
 QLibrary myLib("mylib");  
 typedef void (*MyPrototype)();  
 MyPrototype myFunction = (MyPrototype) myLib.resolve("mysymbol");  
 if (myFunction)  
     myFunction();  

但该符号必须被导出为C函数。也就是说，如果该库是由C++编译器编译的，那么该函数必须被包在extern "C"块中。并且在Windows平台上，还需要使用dllexport宏来修饰该函数。

出于方便，该类还提供了一个静态的resolve()函数，我们可以使用该函数来解析并调用一个库中的方法，而不需要先加载该库。如下代码所示：

[cpp]view plain copy 
   
 typedef void (*MyPrototype)();  
 MyPrototype myFunction =  
         (MyPrototype) QLibrary::resolve("mylib", "mysymbol");  
 if (myFunction)  
     myFunction();  

其实，除了静态的resolve（）函数，该类还提供了一个静态的isLibrary()函数，该函数可以根据特定平台来判断一个文件是否是可被加载的库。其所使用的规则如下：

平台	有效后缀
Windows	.dll，.DLL
Unix/Linux	.so
AIX	.a
HP-UX	.sl，.so(HP-UXi)
OS X and iOS	.dylib，.bundle，.so

下面，我们通过一个实例来简单使用一下该类。

我们先使用QtCreator来写一个dll工程，工程名为Add，在该dll中提供一个函数，完成两个数字的加法。代码如下：

在add.h中声明函数，如下：

[cpp]view plain copy 
   
 #ifndef ADD_H  
 #define ADD_H  
   
 #include "add_global.h"  
   
 extern "C" ADDSHARED_EXPORT int MyAdd(int a, int b);  
   
 #endif // ADD_H  

在add.cpp中实现该函数，如下：

[cpp]view plain copy 
   
 #include "add.h"  
   
 int MyAdd(int a, int b)  
 {  
     return a + b;  
 }  

编译，生成dll即可。

我们接下来在建一个Qt控制台测试工程TestAdd。代码如下：

#include <QCoreApplication>  

#include <QLibrary>  
#include <QDebug>  
  
int main(int argc, char *argv[])  
{  
QCoreApplication a(argc, argv);  
  
QLibrary lib("Add");  
if(!lib.load())  
{  
    qDebug() << "load library failed";  
    qDebug() << lib.errorString();  
    return 0;  
}  
  
typedef int (*MyAdd)(int,int);  
MyAdd myAdd = (MyAdd)lib.resolve("MyAdd");  
if(myAdd)  
{  
    qDebug() << "1 + 1 = " << myAdd(1, 1);  
}  
else  
{  
    qDebug() << lib.errorString();  
}  
  
return a.exec();  
}  
  
将上面生成的Add.dll文件拷贝到该测试工程的编译目录下即可。