Qt之创建并使用共享库

简述

在 Windows 中,有动态链接库(DLL - Dynamic Link Library);在 Linux 中,有共享库(Shared Library),它们是相同的!

由于平台和编译器的差异,输出的库文件也不同:

  • 在 Windows 中,MinGW 将输出 .a.dll;MSVC 将输出 .lib.dll
  • 在 Linux 中,MinGW 将输出 .so.so.1.so.1.0.so.1.0.0 - .lib

.a.so 是导入库,它们有助于将我们的代码链接到库中,并且在构建文件时需要。

版权所有:一去丶二三里,转载请注明出处:http://blog.csdn.net/liang19890820

创建共享库

要创建一个共享库,需要执行以下几个步骤:

  • 文件 -> 新建文件或项目,选择:Library -> C++ 库:

Qt之创建并使用共享库

  • 选择“共享库”,然后输入“名称”(这里以 SharedLib 为例),并选择“创建路径”:

注意: “类型”下拉列表中有三个选项,分别是:共享库、静态链接库、Qt Plugin(Qt 插件)。

Qt之创建并使用共享库

  • 选择一个适当的“构建套件”
  • 选择需要的模块(默认勾选“QtCore”,如果需要其他模块,请自行勾选。例如:界面需要依赖 QtWidgets)。
  • 执行要创建的源码文件的基本信息(默认即可)
  • 完成向导

项目文件

在项目创建完成之后,Qt Creator 会帮我们生成一系列相关文件,目录结构如下:

Qt之创建并使用共享库

查看 .pro,并对其稍作修改:

TARGET = SharedLib

# 新增部分
CONFIG += debug_and_release
CONFIG(debug, debug|release) {
    unix: TARGET = $$join(TARGET,,,_debug)
    else: TARGET = $$join(TARGET,,,d)
}

TEMPLATE = lib
DEFINES += SHAREDLIB_LIBRARY
  • TARGET:指定库的名称
  • TEMPLATE:模板的意思,将其指定为 lib,是要告诉 qmake 我们需要生成的是一个库文件(app 为可执行程序)。
  • DEFINES:用于定义编译选项
  • CONFIG(新增部分):用于编译控制,区分 DebugRelease 版本的库名称(DebugdRelease 不带)。

这里,同时出现了一个非常重要的文件 - {projectName}_global.h,这是 Qt Creator 帮我们创建的,内容如下:

#ifndef SHAREDLIB_GLOBAL_H
#define SHAREDLIB_GLOBAL_H

#include <QtCore/qglobal.h>

#if defined(SHAREDLIB_LIBRARY)
#  define SHAREDLIBSHARED_EXPORT Q_DECL_EXPORT
#else
#  define SHAREDLIBSHARED_EXPORT Q_DECL_IMPORT
#endif

#endif // SHAREDLIB_GLOBAL_H

为什么要自动创建这么一个文件呢?为了明确这一点,先来了解一些基本概念:

符号 - 函数、变量或类 - 包含在供客户端(例如:应用程序或其他库)使用的共享库中,必须以一种特殊的方式标记。这些符号被称为公共符号,它们被导出或公开可见。

在编译共享库时,必须将其标记为导出。为了在客户端使用共享库,一些平台可能需要一个特殊的导入声明。

为此,Qt 提供了两个特殊的宏:

  • Q_DECL_EXPORT:当编译共享库时,必须将其添加到使用的符号声明。
  • Q_DECL_IMPORT:当编译一个(使用了该共享库)客户端时,必须将其添加到使用的符号声明。

所以,要确保正确的宏能够被调用(无论是编译共享库本身,还是在客户端使用共享库),通常通过添加一个特殊的头文件({projectName}_global.h)来解决,这就是 sharedlib_global.h 存在的原因。

生成共享库

可以看到,生成的库中只有一个简单的类定义。为了便于使用,为其添加一些简单的函数:

sharedlib.h 内容如下:

#ifndef SHAREDLIB_H
#define SHAREDLIB_H

#include "sharedlib_global.h"

SHAREDLIBSHARED_EXPORT int subtract(int x, int y);

class SHAREDLIBSHARED_EXPORT SharedLib
{
public:
    SharedLib();
    int add(int x, int y);
};

#endif // SHAREDLIB_H

sharedlib.cpp 内容如下:

#include "sharedlib.h"

int subtract(int x, int y)
{
    return x - y;
}

SharedLib::SharedLib()
{
}

int SharedLib::add(int x, int y)
{
    return x + y;
}

构建(不运行)项目,会生成相应的 .lib.dll 文件。

注意: Debug 版本(带 d)为 SharedLibd.libSharedLibd.dllRelease 版本(不带 d)为 SharedLib.libSharedLib.dll

将应用程序与共享库链接

为了使用共享库,创建一个简单的客户端 - Qt Console Application,然后调用库中导出的符号,效果如下:

Qt之创建并使用共享库

项目创建成功后,将刚才生成的共享库组织成以下结构:

  • SharedLibClient/
    • SharedLibClient.pro
    • main.cpp
    • 3rdparty/
      • SharedLib/
        • include/
          • sharedlib_global.h
          • sharedlib.h
        • lib/
          • SharedLibd.lib
          • SharedLib.lib

一切准备就绪,到了最关键的时刻 - 添加和使用库:

  • 右键项目 -> 添加库:

Qt之创建并使用共享库

  • 选择链接到的库类型,这里选“外部库”:

Qt之创建并使用共享库

  • 指定链接库和包含目录、平台等选项:

Qt之创建并使用共享库

这时,.pro 中会自动添加以下代码:

win32:CONFIG(release, debug|release): LIBS += -L$$PWD/3rdparty/SharedLib/lib/ -lSharedLib
else:win32:CONFIG(debug, debug|release): LIBS += -L$$PWD/3rdparty/SharedLib/lib/ -lSharedLibd

INCLUDEPATH += $$PWD/3rdparty/SharedLib/include
DEPENDPATH += $$PWD/3rdparty/SharedLib/include
  • $$PWD 用于指定包含 .pro 文件的目录的完整路径
  • INCLUDEPATH - 指定编译项目时应该被搜索的 #include 目录
  • LIBS - 指定链接到项目中的库列表

开始测试,main.cpp 内容如下:

#include <QCoreApplication>
#include <qDebug>
#include "sharedlib.h"

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

    // 测试库
    SharedLib lib;
    qDebug() << lib.add(2, 3);

    qDebug() << subtract(5, 2);

    return a.exec();
}

OK,运行程序,效果如上所示。

注意: 在运行程序时,需要将对应的 dllDebugSharedLibd.dllReleaseSharedLib.dll) 拷贝到和可执行程序同一级目录下,否则会出错。

更多参考

上一篇:【JAVA秒会技术之秒杀面试官】JavaEE常见面试题(五)


下一篇:三星新技术使WiFi提速5倍:每秒传输575MB数据