QtCreator中使用链接库

说明

之前讨论的DLL的静态链接和动态连接都是基于 MSVC 编译器，但是 MinGW 似乎有另外一套类似但是不相同的机制。下文均在 windows 下使用 Qt Creator 中使用 MinGW 进行说明。

我们在新建库项目的时候有三种选项，如图所示：

三种类型分别是：共享库、静态链接库和Qt插件，之间区别以及和 MSVC 的库区别如下：

1. 项目会根据类型不同生成 .dll 和 .a文件，这里的 .a 即类似 .lib，但是又不完全相同；
2. 共享库 类似 msvc 的静态链接，构建最终生成 .a(类似.lib) 和 .dll，客户端编译时需要头文件和 .a，运行时需要 .dll；
3. 静态链接库 则是另外一种新的机制，构建最终只生成 .a 文件，客户端调用时需要 .a 文件，运行时则不需要任何库文件，类似于客户端在编译时将库包进了自己的exe中；
4. Qt插件不再多说，参考Qt插件系统文章，就是一种动态加载DLL的方法，但是又把加载的细节隐藏了；

综上所属，MingW 下的链接库相比于 MSVC，着实简单了很多，把内部的很多复杂的细节隐藏在Qt的内部系统中，对使用者来说，更加方便。

链接库的使用

下面就来简单介绍一下这些库的使用，Qt的插件不在讨论之列，请参考Qt插件系统文章。介绍中会忽略一些不重要的细节，我们认为你应该对C++和Qt有一个较深的认识，若没有，请自行去学习相关知识。同时，我们顺带简单介绍一些 .pro 文件的配置。

共享库

（1）创建共享库

共享库类似静态链接，生成.a文件和.dll文件。

按照正常流程新建库项目，类型选择 动态库，最终生成的项目列表中如下如所示：

可以看出，除了需要导出的类外，额外还有一个XXX_global.h的文件，文件代码如下：

#ifndef FIRECONTROL_GLOBAL_H
#define FIRECONTROL_GLOBAL_H

#include <QtCore/qglobal.h>

#if defined(FIRECONTROL_LIBRARY)
#  define FIRECONTROLSHARED_EXPORT Q_DECL_EXPORT
#else
#  define FIRECONTROLSHARED_EXPORT Q_DECL_IMPORT
#endif

#endif // FIRECONTROL_GLOBAL_H

了解 MSVC 的dll导出的都能了解，这里其实是对 __declspec(dllexport) 和 __declspec(dllimport) 进行一种巧妙的声明，因为导出需要使用export，导入需要使用import，为了避免在库和客户端中重复地进行export和import的声明，这里使用宏定义进行统一声明，详细说明可以参考DLL的导出和调用的文章。

在需要导出的类和方法前面使用 FIRECONTROLSHARED_EXPORT 声明即可，客户端调用时也需要将这个文件include进来。

当然，如果你对导出DLL的一个比较清晰的认识，也可以删除这个文件，自己定义。

（2）pro文件

QT       -= gui

TARGET = FireControl
TEMPLATE = lib	#表示这是一个库项目

DEFINES += FIRECONTROL_LIBRARY

SOURCES += FireControlManager.cpp

HEADERS += FireControlManager.h
        firecontrol_global.h

unix {
    target.path = /usr/lib
    INSTALLS += target
}
#上面为创建时自动生成，以下为新增
DESTDIR = $$PWD/../SystemWindow/lib	#最终编译文件的生成路径，包括.a和.dll
DLLDESTDIR = $$PWD/../../../Service	#dll文件的生成路径

（3）调用共享库

在调用端右击->添加库，选择生成 .a 文件，即可自动在 pro文件中添加加载设置。当然，也可以不适用GUI操作，直接修改pro文件以达到添加库的目的。

我们希望调用端和库项目分开构建，所以这里选择外部库

添加.a的库文件和头文件的包含目录，并配置一些链接方法

调用设置完成后，pro文件如下：

QT       += core gui

greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

TARGET = SystemWindow
TEMPLATE = app

SOURCES += main.cpp
        MainBench.cpp

HEADERS  += MainBench.h

FORMS    += MainBench.ui

#以下即为自动生成的加载库设置
win32:CONFIG(release, debug|release): LIBS += -L$$PWD/lib/ -lFireControl
else:win32:CONFIG(debug, debug|release): LIBS += -L$$PWD/lib/ -lFireControl
else:unix:!macx: LIBS += -L$$PWD/lib/ -lFireControl

INCLUDEPATH += $$PWD/../FireControl
DEPENDPATH += $$PWD/../FireControl
DESTDIR = $$PWD/../../../Service	#目标生成路径

最后，可以在客户端使用库导出的类了，当然不要忘了添加头文件。

静态库

（1）创建静态库

静态最终只会生成 .a 文件。

创建库项目时，选择静态库，完成之后，项目目录的内容和目录中，除了没有入口的main函数外，其他都和普通项目没有什么区别，而真正的区别在于pro文件的配置中。

（2）pro文件

QT       -= gui

TARGET = untitled
TEMPLATE = lib		#表示这是一个库项目
CONFIG += staticlib	#表示这是一个静态库

SOURCES += untitled.cpp

HEADERS += untitled.h
unix {
    target.path = /usr/lib
    INSTALLS += target
}
DESTDIR = $$PWD/../SystemWindow/lib #生成路径

（3）调用静态库

调用方法和调用共享库类似，这里不做赘述，最终实际运行时不需要dll文件

总结

共享库和静态库各有各的优势，从最简单的层面上来看：

使用静态库可以将大项目区分开，即分模块显示项目，便于维护；

使用共项目也是如此，而且可以在不修改客户端的情况下，修改库内容的实现，只要接口不变，最终替换dll即可完成内容的改变。

但是看起来静态库有些鸡肋，具体还有哪些好处，留待日后发现。