利用插件扩展Qt应用程序-阿里云开发者社区

开发者社区> 开发与运维> 正文

利用插件扩展Qt应用程序

简介: 简述 不仅 Qt 本身可以通过插件进行扩展,而且 Qt 应用程序也可以通过插件来扩展,这需要应用程序使用 QPluginLoader 检测和加载插件。

简述

不仅 Qt 本身可以通过插件进行扩展,而且 Qt 应用程序也可以通过插件来扩展,这需要应用程序使用 QPluginLoader 检测和加载插件。在这种情况下,插件可能提供任意功能,不限于数据库驱动程序、图像格式、文本编解码器、样式以及扩展 Qt 功能的其他类型的插件。

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

扩展 Qt 应用程序

编写扩展 Qt 应用程序的插件,涉及以下步骤:

  • 声明一个继承自 QObject 和插件想要提供的接口的插件类
  • 使用 Q_INTERFACES() 宏来告诉 Qt 元对象系统有关接口的情况
  • 使用 Q_PLUGIN_METADATA() 宏导出插件
  • 使用合适的 .pro 文件构建插件

通过插件使应用程序可扩展,涉及以下步骤:

  • 定义一组用于与插件通信的接口(只有纯虚函数的类)
  • 使用 Q_DECLARE_INTERFACE() 宏来告诉 Qt 元对象系统有关接口的情况
  • 在应用程序中使用 QPluginLoader 加载插件
  • 使用 qobject_cast() 来测试插件是否实现了指定的接口

一个简单的插件

为我们的职业感到自豪,程序员可以创造世界。。。以此为例吧!

这里写图片描述

编写插件

工程文件 - .pro

和前面一样,由于我们正在构建的是一个共享库,所以在 .pro 中,需要将 TEMPLATE 设置为 lib,同时还必须将 CONFIG 设置为 plugin。

plugin.pro 内容如下:

QT += core
QT -= gui

TEMPLATE = lib
CONFIG += plugin
TARGET = personPlugin

HEADERS += \
    person.h \
    programmer.h

SOURCES += programmer.cpp

OTHER_FILES += programmer.json

win32 {
    CONFIG(debug, release|debug):DESTDIR = ../debug/plugins/
    CONFIG(release, release|debug):DESTDIR = ../release/plugins/
} else {
    DESTDIR = ../plugins/
}

这里,将插件生成在 plugins 目录中,当然,目录名可以随便起。

接口类 - IPerson

声明了一个关于人的接口类 - IPerson,定义了插件将提供的功能。

注意: 接口是一个仅由纯虚函数组成的类,如果在类中存在非虚函数,那么在 moc 文件中会出现误导的编译错误。

person.h 内容如下:

#ifndef PERSON_H
#define PERSON_H

#include <QtPlugin>
#include <QString>

class IPerson
{
public:
    virtual ~IPerson() {}
    virtual QString name() = 0;  // 人有名字
    virtual void eat() = 0;  // 人需要吃东西
    virtual void sleep() = 0;  // 人需要睡觉
    virtual void doSomething() = 0;  // 人还需要干其他事
};

#define IPerson_iid "org.qt-project.Qt.Examples.IPerson"

Q_DECLARE_INTERFACE(IPerson, IPerson_iid)

#endif // PERSON_H

使用 Q_DECLARE_INTERFACE 宏,是为了让 Qt 元对象系统知道该接口,这样以来,在运行时便可以识别实现接口的插件。其中,第二个参数(IPerson_iid)是一个标识接口的字符串,必须唯一。

插件类 - Programmer

现在,是时候该程序员出场了。定义一个 Programmer 类,继承自 QObjectIPerson,使这个类成为一个插件。

programmer.h 内容如下:

#ifndef PROGRAMMER_H
#define PROGRAMMER_H

#include "person.h"
#include <QObject>

class Programmer : public QObject, IPerson
{
    Q_OBJECT
    Q_PLUGIN_METADATA(IID IPerson_iid FILE "programmer.json")
    Q_INTERFACES(IPerson)

public:
    virtual QString name() Q_DECL_OVERRIDE;
    virtual void eat() Q_DECL_OVERRIDE;
    virtual void sleep() Q_DECL_OVERRIDE;
    virtual void doSomething() Q_DECL_OVERRIDE;
};

#endif // PROGRAMMER_H

Q_INTERFACES 宏用于告诉 Qt 该类实现的接口。Q_PLUGIN_METADATA 宏包含插件的 IID,并指向一个包含插件元数据的 Json 文件。该 Json 文件会被编译到插件中,无需安装。

程序员日常:吃饭、睡觉、撸代码。。。(⊙o⊙)…

programmer.cpp 内容如下:

#include "programmer.h"
#include <QtDebug>

QString Programmer::name()
{
    return "Pony";
}

void Programmer::eat()
{
    qDebug() << "Pizza";
}

void Programmer::sleep()
{
    qDebug() << "6 hours";
}

void Programmer::doSomething()
{
    qDebug() << "Coding...";
}

插件的元数据 - Json 文件

插件已经基本完成,但貌似还缺些什么?没错,元数据!插件总需要提供一些相关的信息吧!

这时上面提到的 Json 文件就相当有用了!可以包含一些元数据,例如:作者、日期、插件名、版本号、依赖关系等。。。

programmer.json 内容如下:

{
    "author" : "Waleon",
    "date" : "2017/09/01",
    "name" : "personPlugin",
    "version" : "1.0.0",
    "dependencies" : []
}

由于现在只有一个插件,并没有对于其他插件的依赖,所以暂时没有列出依赖关系(要实现一个插件系统,依赖关系必不可少)。

注意: 如果不想为插件提供信息,当然不会有任何问题,只需保证 Json 文件为空就行。

加载插件

一切准备就绪,来实现一个简单的控制台应用程序,以动态加载插件。

工程文件 - .pro

由于这里需要的是一个简单的控制台应用程序,所以,除了将 TARGET 设置为 app 之外,还需要将 CONFIG 设置为 console。

app.pro 内容如下:

QT += core
QT -= gui

CONFIG += c++11

TARGET = app
CONFIG += console
TEMPLATE = app

INCLUDEPATH += $$PWD/..

SOURCES += main.cpp

win32 {
    debug:DESTDIR = ../debug/
    release:DESTDIR = ../release/
} else {
    DESTDIR = ../
}

为了能在程序中使用插件相关的接口,需要使用 INCLUDEPATH 将插件的相关路径包含进来。

main() 函数

注意: 对于使用插件的应用程序,Qt 插件只是一个 QObject,该 QObject 使用多重继承来实现插件接口。

main.cpp 内容如下:

#include <QCoreApplication>
#include <QPluginLoader>
#include <QDir>
#include <QtDebug>
#include <QJsonObject>
#include <QJsonArray>
#include <plugin/person.h>

void loadPlugin()
{
    // 进入插件目录
    QDir pluginsDir(qApp->applicationDirPath());
    pluginsDir.cd("plugins");
    // 查找目录中的所有插件
    foreach (QString fileName, pluginsDir.entryList(QDir::Files)) {
        QPluginLoader loader(pluginsDir.absoluteFilePath(fileName));
        // 返回插件的根组件对象
        QObject *pPlugin = loader.instance();
        if (pPlugin != Q_NULLPTR) {

            // 获取元数据(名称、版本、依赖)
            QJsonObject json = loader.metaData().value("MetaData").toObject();
            qDebug() << "********** MetaData **********";
            qDebug() << json.value("author").toVariant();
            qDebug() << json.value("date").toVariant();
            qDebug() << json.value("name").toVariant();
            qDebug() << json.value("version").toVariant();
            qDebug() << json.value("dependencies").toArray().toVariantList();

            // 访问感兴趣的接口
            IPerson *pPerson = qobject_cast<IPerson *>(pPlugin);
            if (pPerson != Q_NULLPTR) {
                qDebug() << "********** IPerson **********";
                qDebug() << pPerson->name();
                pPerson->eat();
                pPerson->sleep();
                pPerson->doSomething();
            } else {
                qWarning() << "qobject_cast falied";
            }
        }
    }
}

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

    loadPlugin();

    return a.exec();
}

初始化 pluginsDir 成员变量,以引用 plugins 子目录。然后,使用 QDir::entryList() 获取该目录中所有文件列表,并通过 foreach 迭代结果,尝试使用 QPluginLoader 加载插件。

插件提供的 QObject 可以通过 QPluginLoader::instance() 访问。如果动态库不是 Qt 插件,或者是由不兼容版本的 Qt 库进行编译,QPluginLoader::instance() 将返回一个空指针。

对于每个插件,可以根据 QPluginLoader::metaData() 来获取其元数据(定义在 Json 文件中)。要检查插件实现的接口,需要使用 qobject_cast(),从而进一步访问接口中的定义。

源码地址

GitHub 源码地址:PersonPlugin

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

分享:
开发与运维
使用钉钉扫一扫加入圈子
+ 订阅

集结各类场景实战经验,助你开发运维畅行无忧

其他文章