写在前面
在Qt的实际开发中,免不了使用和创建动态链接库,因此熟悉Qt中动态链接库的创建和使用对后续的库开发或使用是非常用必要的。
在之前的文章https://blog.csdn.net/SNAKEpc12138/article/details/126189926?spm=1001.2014.3001.5501中已经对导入导出的声明有过详细介绍了,通过Qt向导创建的动态库项目也会带上这些声明,因此这里不再赘述。
开发环境;
Qt:5.15.2
Qt Creator:10.0.2
动态链接库的创建
打开Qt Creator,创建项目 -> 选择 库 -> C++ Library
自定义项目名称和存放路径:
默认使用qmake构建:
库类型默认:
无需翻译文件:
选择构建套件,这里使用Qt 5.15.2 MSVC2019_64bit
最后的总览;
生成后可以看到向导自动生成了如下文件:
.pro文件内容如下;
qtdlltest.h头文件中定义了导出类信息,内容如下;
QtDllTest_global.h头文件主要通过上面.pro文件中定义的QTDLLTEST_LIBRARY宏,来区别导入和导出声明:
最后是导出类的实现:
编译运行可以在生成路径下生成了一个dll:
这里添加一个成员函数,以便后面使用:
重新生成,同样可以使用dumpbin工具查看导出信息:
如何配置使用VS提供的dumpbin工具可参考:https://blog.csdn.net/SNAKEpc12138/article/details/126109249?spm=1001.2014.3001.5501
虽然发生了名字改编,也不影响我们在Qt项目中使用,可参考:https://blog.csdn.net/SNAKEpc12138/article/details/126235303?spm=1001.2014.3001.5501
动态链接库的使用
在其他项目中使用Qt动态链接库,需用到以下文件:
①导入/导出声明全局文件。例上面的:QtDllTest_global.h,若未使用全局文件,则无需。
②导出声明头文件。例上面的:qtdlltest.h
③lib 和 dll。例生成目录下的:QtDllTest.lib 和 QtDllTest.dll
下面再创建一个新的项目来使用上面生成dll, 这里使用一个简单Qt控制台程序示例。
首先将需要的文件拷贝到使用项目的目录下,头文件和.lib文件可需防止.pro文件所在目录下(因为要在代码中引用),.dll文件放在生成目录下。
这里习惯将头文件放在.pro目录下的include文件夹中,将.lib文件放在.pro目录下的lib文件夹中:
将.dll文件放在项目的生成目录下,不知道项目的生成目录,可在Qt Creator左侧的项目界面中查看:
文件放置妥当后,即可开始使用动态链接库了,这里也可分为静态加载和动态加载两种方式。
静态加载
在使用项目的.pro文件中添加附加库目录和导入.lib :
补充:$$PWD为.pro文件所在目录。
在代码中使用:
注意:上面.pro文件中的LIBS += $$PWD/lib/QtDllTest,有的版本无需加上.lib后缀,而有些版本则需要加上.lib后缀。
当出现以下报错(**LNK1181: 无法打开输入文件: ***\库名称.obj)时,则需要加上.lib后缀:
动态加载
因为动态加载只能调用动态库的导出函数,而且必须是extern"C"的,调用不了类,因此这里需要重新在dll项目中添加一个全局函数:
重新生成后更新qtdlltest.h、QtDllTest.lib、QtDllTest.dll到使用项目中!
然后即可在使用项目中动态加载:
#include <QCoreApplication>
//#include "qtdlltest.h"
#include <QLibrary>
#include <QDebug>
int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);
// QtDllTest dll;
// dll.printFromDll();
QLibrary lib("QtDllTest.dll");
if (!lib.load())
{
qDebug() << "Failed to Load Library!";
qDebug() << lib.errorString();
return 0;
}
typedef void (*pFunc)();
pFunc f = lib.resolve("globalPrint");
if (f)
{
f();
}
else
{
qDebug() << "Failed to get function!";
}
return a.exec();
}
输出如下:
总结
综上,简单介绍了Qt动态链接库的创建和使用,使用时也分别示例的静态加载和动态加载的区别。
需要注意的是:
①静态加载添加.lib文件时,因Qt版本不同,可能需要加上.lib后缀。
②动态加载时,只能加载extern"C"的全局函数,不能加载类,因此在Qt中,一般不会使用这种加载方式。
若想使用动态加载,且用到导出类时,Qt中提供了QPluginLoader插件类来实现,这个会在之后的文章中详细介绍。