Qt动态链接库/静态链接库建立与使用，QLibrary动态加载库

时间 2019-12-15

原文原文链接

版权声明：若无来源注明， Techie亮博客文章均为原创。转载请以连接形式标明本文标题和地址：
本文标题：Qt动态链接库/静态链接库建立与使用，QLibrary动态加载库本文地址： https://www.techieliang.com/2017/12/680/

文章目录

1. 动态链接库建立与使用

1.1. 项目建立

注意选择成shared libraryhtml

此时新建的项目pro文件：linux

QT -= gui
TARGET = library
TEMPLATE = lib
DEFINES += LIBRARY_LIBRARY
DEFINES += QT_DEPRECATED_WARNINGS
SOURCES += \
library.cpp
HEADERS += \
library.h
unix {
target.path = /usr/lib
INSTALLS += target
}

注意其Template为lib，且声明了一个LIBRARY_LIBRARYc++

对于global.h文件建议直接拷贝到library.h，这样发布的时候只须要给别人一个.h文件windows

library.happ

#ifndef LIBRARY_H
#define LIBRARY_H
#include <QtCore/qglobal.h>
#if defined(LIBRARY_LIBRARY)
# define LIBRARYSHARED_EXPORT Q_DECL_EXPORT
#else
# define LIBRARYSHARED_EXPORT Q_DECL_IMPORT
#endif
class LIBRARYSHARED_EXPORT Library {
public:
Library();
int sum(int a, int b);
};
int LIBRARYSHARED_EXPORT sum(int a, int b);
#endif // LIBRARY_H

pro声明的宏在这里用上了，作了一个判断，若是有定义则LIBRARYSHARED_EXPORT=Q_DECL_EXPORT，不然等于Q_DECL_IMPORT，也就是说在这个lib项目里是导出的意思，在其余项目由于给别人的只有.h文件并无LIBRARY_LIBRARY的定义，因此是导入。从而实现不作任何修改便可发布.h文件。函数

将global.h拷贝到library.h也是为了只提供一个文件，不然若忘记了提供global.h调用方会提示缺乏文件。工具

library.cpp测试

Library::Library() {
}
int Library::sum(int a, int b) {
return a+b;
}
int sum(int a, int b) {
return a+b;
}

此时直接Ctrl+B构建便可liblibrary.a、library.dll、library.o三个文件(MinGW版，VS的会有lib文件)，提供给调用方*.h和*.dll文件便可(windows，linux共享库是*.so)ui

注意生成库也区分debug和release，debug的库内带有调试代码，通常debug的库文件名最后是d也就是spa

1.2. 调用-使用.h文件

创建一个Qt Console Application项目，将library.dll和library.h文件拷贝到项目目录下(和新项目的main.cpp在一块儿便可)

默认pro文件：

QT -= gui
CONFIG += c++11 console
CONFIG -= app_bundle
DEFINES += QT_DEPRECATED_WARNINGS
SOURCES += main.cpp

在打开的pro项目右键，选择添加库(Add library），能够把dll文件包含到项目里，若是不包含此处选择外部库(External Library)

在pro文件最后添加

LIBS += library.dll

简单的写法是上面的样子，建议使用完整的写法：

LIBS += -LD:/my_program_design/dll_test/test_library_by_header/ -llibrary

+=先后容许有空格? -L和路径名不可有空格?? -l前面有空格后面不可有空格要紧跟文件名?? 文件名不须要后缀，系统会自动识别是dll仍是lib

文件名是library，前面加了个-l变成了-llibrary，别忘了-l

main.cpp

#include <QCoreApplication>
#include <library.h>
#include <QDebug>
int main(int argc, char *argv[]) {
QCoreApplication a(argc, argv);
qDebug()<<sum(1,2);//测试c函数
Library t;
qDebug()<<t.sum(1,2);//测试类函数
return 0;
}

此时运行，能够生成成功，可是会报错，由于dll文件还须要拷贝到生成的exe文件目录，拷贝后再运行便可

2. 静态库建立及使用

2.1. 建立

见动态库第二图，建立时不要选择shared，选择静态链接库Statically Linked Library。

建立项目之后没有什么特点，不会有global.h文件也不会有一个export、import的定义，由于静态库不须要导入导出，生成库提供给使用者，使用者在编译时会将代码须要的代码编译到本身的项目中，不须要附带dll/lib等文件。

先看pro文件：

QT -= gui
TARGET = static_library
TEMPLATE = lib
CONFIG += staticlib
SOURCES += \
static_library.cpp
HEADERS += \
static_library.h
unix {
target.path = /usr/lib
INSTALLS += target
}

相比于动态连接库差别是增长了CONFIG += staticlib 删掉了DEFINES

.h和.cpp文件和动态库同样，只不过没有了LIBRARYSHARED_EXPORT

而后运行就会生成文件libstatic_library.a和static_library.o文件(MinGW，VS是lib文件)

2.2. 使用

和动态库同样新建个项目，把libstatic_library.a或者lib文件以及static_library.h考到项目

在pro文件增长：

LIBS += -LD:/my_program_design/dll_test/test_static_library/ -llibstatic_library

main.cpp文件：

#include <QCoreApplication>
#include <static_library.h>
#include <QDebug>
int main(int argc, char *argv[]) {
QCoreApplication a(argc, argv);
qDebug()<<sum(1,2);
Static_library l;
qDebug()<<l.sum(1,2);
return 0;
}

运行便可，这里就不须要吧.a文件复制到程序目录了，由于静态库编译的时候已经把须要的内容编译到exe程序了。

3. QLibrary动态加载动态库

3.1. 介绍

在动态库使用那里，直接编译运行会没法打开，把dll文件拷贝到运行目录才能打开程序，不然会提示缺乏文件，而后就没有而后了。。。

不知道是否注意到有些程序是主动提示缺乏文件错误的？会在程序运行到须要库文件时提示缺乏此库，而且能够自定义提示内容，而不是用系统默认的错误提示，若想实现此功能须要动态加载。固然在库供应方只给了dll文件没给.h的时候也能使用，换句话说动态加载方式在编写项目时不须要.h文件，也不须要在pro文件增长“libs+=”

先看帮助文档：http://doc.qt.io/qt-5/qlibrary.html

接口很简单：

QLibrary(QObject *parent = Q_NULLPTR)
QLibrary(const QString &fileName, QObject *parent = Q_NULLPTR)
QLibrary(const QString &fileName, int verNum, QObject *parent = Q_NULLPTR)
QLibrary(const QString &fileName, const QString &version, QObject *parent = Q_NULLPTR)
~QLibrary()
QString errorString() const
QString fileName() const
bool isLoaded() const
bool load()
LoadHints loadHints() const
QFunctionPointer resolve(const char *symbol)
void setFileName(const QString &fileName)
void setFileNameAndVersion(const QString &fileName, int versionNumber)
void setFileNameAndVersion(const QString &fileName, const QString &version)
void setLoadHints(LoadHints hints)
bool unload()

注意load用完了记着unload，还能够作version版本判断，其余的不说了，直接看简单范例。

3.2. 范例

不须要吧dll文件放到工程目录就行，由于编译的时候不会访问它，只须要放到运行目录便可

#include <QCoreApplication>
#include <QString>
#include <QDebug>
#include <QLibrary>
typedef int (*myfun)(int, int);//定义函数格式
int main(int argc, char *argv[]) {
QCoreApplication a(argc, argv);
QLibrary test_dll("library.dll");//加载dll
if(test_dll.load()) {//判断是否加载成功
myfun fun1 = (myfun)test_dll.resolve("sum");//获取dll的函数
if (fun1) {//判断是否获取到此函数
double result;
result=fun1(1,2);//和正常调用函数同样了
qDebug()<<QString(QStringLiteral("load ok, result:"))+
QString::number(result);
}
else {
//函数解析失败
qDebug()<<QStringLiteral("dll function load error");
}
}
else {
qDebug()<<QStringLiteral("dll load error");//dll文件加载失败
}
return 0;
}

范例很简单，而后运行就会发现给出的结果是：dll function load error

此时不要盲目的去找检查typedef 的错误，其实这个程序没错，错的是以前的dll项目。

由于c++为了适应函数重载，对于函数名称在编译过程当中会作必定的修改，因此此时找sum确定找不到，应该修改动态库的项目文件，把头文件改为：

#ifndef LIBRARY_H
#define LIBRARY_H
#include <QtCore/qglobal.h>
#if defined(LIBRARY_LIBRARY)
# define LIBRARYSHARED_EXPORT Q_DECL_EXPORT
#else
# define LIBRARYSHARED_EXPORT Q_DECL_IMPORT
#endif
class LIBRARYSHARED_EXPORT Library {
public:
Library();
int sum(int a, int b);
};
extern "C" int LIBRARYSHARED_EXPORT sum(int a, int b);
#endif // LIBRARY_H

extern “C” 包含双重含义，从字面上便可获得：首先，被它修饰的目标是“extern”的；其次，被它修饰的目标是“C”的。让咱们来详细解读这两重含义。
被extern “C”限定的函数或变量是extern类型的：extern是C/C++语言中代表函数和全局变量做用范围（可见性）的关键字，该关键字告诉编译器，其声明的函数和变量能够在本模块或其它模块中使用。同时”C”又告诉编译器以C语言方式编译和链接。

把新生成的文件拷贝到运行目录便可获得”load ok, result:3″

3.3. 比较extern”C”的dll与原始dll的差异

用depends工具查看dll文件，我把新的命名为library.dll旧的命名为library2.dll看图对比便可：

转载请以连接形式标明本文标题和地址：Techie亮博客 » Qt动态链接库/静态链接库建立与使用，QLibrary动态加载库