Qt 共享库(动态链接库)和静态链接库的创建及调用

前言: 编译器 Qt Creator, 系统环境 win7 64 位

 

1.创建共享库:

新建文件或项目->选择 Library 和 c++ 库->选择共享库->下一步(工程名为 sharedlib)

生成的目录结构如图:

修改 sharedlib.h 中的代码:

// sharedlib.h
#ifndef SHAREDLIB_H
#define SHAREDLIB_H

#include "sharedlib_global.h"

class SHAREDLIBSHARED_EXPORT Sharedlib// 导出类, 客户端可直接加载
{

public:
 Sharedlib();
 void test();
};

extern "C" Q_DECL_EXPORT int add(int a, int b);//导出函数, 客户端可用 QLibrary 加载

#endif // SHAREDLIB_H

 

修改 sharedlib.cpp 中的代码:

// sharedlib.cpp
#include "sharedlib.h"

#include <QMessageBox>


Sharedlib::Sharedlib()
{
}

void Sharedlib::test()
{
 QMessageBox::warning(0, "Sharedlib::test", "Sharedlib::test");
}

int add(int a, int b)
{
 return a+b;
}

 

2.调用共享库(方式一):

新建文件或项目->选择 Application, Qt Console Application->项目名为 app1->下一步

修改客户端程序 main.cpp 中的代码:

// main.cpp
#include <QCoreApplication>
#include <QLibrary>
#include <iostream>
using namespace std;

int main(int argc, char *argv[])
{
 QCoreApplication a(argc, argv);

 typedef int (*Add)(int a, int b);

 QLibrary mylib("sharedlib.dll");

 if(!mylib.load()){// 加载 dll 失败
 cout<<"加载 sharedlib.dll 失败!"<<endl;
 return -1;
 }
 Add add = (Add)mylib.resolve("add");
 if(0 == add){// 加载失败
 cout<<"加载函数 add 失败!"<<endl;
 return -1;
 }

 int sum = add(1,2);// 调用 add 函数

 cout<<sum<<endl;

 return 0;

 return a.exec();
}

 

编译 sharedlib 工程和 app1 工程-> 将生成的 sharedlib.dll 文件复制到 app1.exe 所在目录中->运行 app1.exe 输出 3

总结:这种调用方式需要在客户端程序编译时需要提供 .dll 的名字信息及其函数信息, 需要在客户端程序运行时提供 .dll 文件, 客户端中要写的代码较多.

3.调用共享库(方式二):

新建文件或项目->选择 Application, Qt QWidgets Application->项目名为 app2->下一步

在 app2.pro 文件最后添加如下代码, 用来说明 sharedlib.lib 的路径信息:

unix|win32: LIBS += -L$$PWD/../build-sharedlib-unknown-Debug/debug/ -lsharedlib

INCLUDEPATH += $$PWD/../build-sharedlib-unknown-Debug/debug
DEPENDPATH += $$PWD/../build-sharedlib-unknown-Debug/debug

 

将 sharedlib 工程源码目录下的 sharedlib.h 和 sharedlib_global.h 头文件复制到 app2 工程源码目录下, 将 sharedlib.dll 文件复制到 app2.exe 所在目录中

修改客户端程序 main.cpp 中的代码:

// main.cpp
#include "mainwindow.h"
#include <QApplication>
#include "sharedlib.h"

int main(int argc, char *argv[])
{
 QApplication a(argc, argv);
// MainWindow w;
// w.show();
 Sharedlib sb;
 sb.test();

 return a.exec();
}

 

编译 app2 工程, 运行 app2.exe, 弹出如图对话框, 表示程序正确执行:

总结: 这种调用方式需要在客户端程序编译时提供 .lib 和 .h 文件, 需要在客户端程序运行时提供 .dll 文件,  客户端中要写的代码较少.

4.方式一和方式二调用共享库的异同点:

客户端程序运行时都是只需要 .dll 文件; 编译时有些差别, 方式一代码较多, 但无需 .lib 和 .h 文件, 方式二代码简单(和调用普通类一样), 但是需要 .lib 和 .h 文件.

创建好三个项目后的文件结构如图:

5. 静态链接库的创建:

新建文件或项目->选择 Library 和 c++ 库->选择静态链接库->下一步(工程名为 staticdlib)

修改 staticlib.h 中的代码:

// staticlib.h
#ifndef STATICLIB_H
#define STATICLIB_H


class Staticlib
{

public:
 Staticlib();
 void test();
};

#endif // STATICLIB_H

 

修改 staticlib.cpp 中的代码:

// staticlib.cpp
#include "staticlib.h"
#include <iostream>
using namespace std;

Staticlib::Staticlib()
{
 cout<<"Staticlib::Staticlib"<<endl;
}

void Staticlib::test()
{
 cout<<"Staticlib::test"<<endl;
}

 

编译工程之后会生成 staticlib.lib 文件

6. 调用静态链接库:

新建文件或项目->选择 Application, Qt Console Application->项目名为 app->下一步

在 app.pro 文件最后添加如下代码, 用来说明 staticlib.lib 的路径信息:

unix|win32: LIBS += -L$$PWD/../build-staticlib-unknown-Debug/debug/ -lstaticlib

INCLUDEPATH += $$PWD/../build-staticlib-unknown-Debug/debug
DEPENDPATH += $$PWD/../build-staticlib-unknown-Debug/debug

 

将 staticlib 工程目录下的 staticlib.h 复制到 app 工程目录下

修改客户端程序 main.cpp 中的代码:

// main.cpp
#include <QCoreApplication>
#include "staticlib.h"

int main(int argc, char *argv[])
{
 QCoreApplication a(argc, argv);

 Staticlib sb;
 sb.test();

 return a.exec();
}

 

编译 app 工程, 生成 app.exe 文件, 运行 app.exe 文件, 输出如图:

总结: 客户端程序编译时需要 .h 和 .lib 文件, 运行时无需其它文件.

7. 共享库(动态链接库)和静态链接库的异同点:

异: 调用共享库的客户端运行时需要 .dll 文件, 静态链接库的不需要;

      库程序发生改变时, 共享库客户端只需更新 .dll 文件, 静态链接库客户端需要重新编译.

同: 都可用于多模块共同开发程序

 

 注: 本文是原创文章, 欢迎咨询或提出修改意见, 联系方式QQ:[e-mail]

源码地址:<a href="https://github.com/ZhangShuaiH/Qt-demos/tree/master">https://github.com/ZhangShuaiH/Qt-demos/tree/master</a>