当前位置：首页 > news >正文

Qt--动态链接库的创建和使用

news 2025/8/22 18:53:09

写在前面

在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();
}