Qt之QPluginLoader使用插件子项目及插件间通信（简易框架）（含部分源码+注释）

2024-03-05 08:04
文章标签 源码 使用 qt 间通信 框架 插件 注释 部分 简易 子项目 qpluginloader

本文主要是介绍Qt之QPluginLoader使用插件子项目及插件间通信（简易框架）（含部分源码+注释），希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

文章目录

  • 一、项目示例
    • 1.导航栏操作页面操作示例图
    • 2.打开所有页面操作示例图
    • 3.打开指定界面操作示例图
    • 3.插件重载操作演示
  • 二、插件逻辑个人理解
    • 1.QPluginLoader的简单使用
    • 2.子插件的基本要素
  • 三、项目结构（思路）简述
    • 1.定义插件接口类
    • 2.定义插件类别
      • 一个主项目
      • 若干子插件
    • 3.主项目及子插件的关联
  • 四、源码（此处列举主项目和一个子插件源码为例）
    • 1.主项目相关文件
      • iplugindatabusinterface.h
      • commondefins
      • mainwindow
      • main.cpp
    • 2.子插件（页面1）相关文件
      • pagefirstplugin
  • 总结

一、项目示例

1.导航栏操作页面操作示例图

下图演示了通过导航栏打开和关闭页面并在主页插件显示的操作。
在这里插入图片描述

2.打开所有页面操作示例图

下图演示了一键打开所有界面并同事更新导航来页面状态的操作。

在这里插入图片描述

3.打开指定界面操作示例图

下图演示了根据不同项按钮打开指定界面的操作，并且同时更新对应导航栏状态。
在这里插入图片描述

3.插件重载操作演示

下图演示了指定页面重载指定页面的逻辑演示。
注：本文代码此处重载并非同一插件的重载，而是将当前使用插件卸载，然后通过更新插件路径从而加载一个全新的插件逻辑。
在这里插入图片描述

二、插件逻辑个人理解

1.QPluginLoader的简单使用

使用步骤如下：

  1. **设置库文件：**创建一个QPluginLoader对象，可通过构造传参或setFileName函数设置库文件；
  2. **加载库文件：**使用QPluginLoader对象的load函数加载库文件；
  3. **获取插件指针：**通过QPluginLoader对象的instance函数获取一个QObject指针，然后通过转换获取，再使用插件指针获取控件对象等操作；
  4. 卸载插件：. 通过QPluginLoader对象的unload函数卸载插件，该函数会自动释放插件指针对象。

2.子插件的基本要素

  1. 继承自定义接口并根据功能实现对应的接口函数。
  2. 使用Q_DECLARE_INTERFACE：将接口对象声明给元对象，保证可使用Q_INTERFACES添加该接口。
  3. 使用Q_INTERFACES：添加后可使用qobject_cast转换为定义接口类（不添加该标识符，使用dynamic_cast强制转换也可使用，但不推荐）。
  4. 使用Q_PLUGIN_METADATA：添加后可使得QPluginLoader的instance函数获取到接口（类）指针。

三、项目结构（思路）简述

1.定义插件接口类

插件与插件之间无法直接通信，此时就需要一个接口作为中间类建立通信的桥梁（提供保障插件正常工作的函数，如收、发数据的函数），并且要求进行通信的子插件都需要继承接口类并实现对应的通信函数；以及在该类文件中定义唯一标识符（使得Qt能通过标识符识别该接口类），。

插件唯一标识符

// 通过宏定义插件标识符
#define InterfaceIdent "plugin.plugindatabusinterface"

插件相关必要函数

signals:// 数据通信信号void sigPluginCommTriggered(const StCommData &data);
public:// 数据接收处理函数virtual void recvPluginCommData(const StCommData &data) = 0;// 初始化函数virtual void initialize() = 0;// 初始化状态函数virtual bool isInitialized() const = 0;// 获取插件名称virtual QString name() const = 0;// 创建插件对象virtual QWidget *createWidget() = 0;
public slots:// 所有插件初始化完成函数virtual void slotInitialized() = 0;

2.定义插件类别

一个主项目

管理子插件集合以及负责各个子插件的互相通信数据转发；主项目负责加载、管理、卸载子插件并处理各个插件间的消息转发，并且主项目包含main.cpp，使得程序从该入口运行。

主项目的目录结构
在这里插入图片描述

若干子插件

某一功能的集合，负责该功能的消息发送及消息处理；要求继承接口类并个性化实现接口类虚函数，且子插件中的插件类中需添加指定的插件宏。

子插件接口宏使用

    // 添加后可使用qobject_cast转换为定义接口类（不添加该标识符，使用dynamic_cast强制转换也可使用，但不推荐）Q_INTERFACES(IPluginDataBusInterface)
#if QT_VERSION >= 0x050000// 添加后可使得QPluginLoader的instance函数获取到接口（类）指针Q_PLUGIN_METADATA(IID InterfaceIdent)
#endif // QT_VERSION >= 0x050000

子插件目录结构
在这里插入图片描述
其他子插件
除开初始化显示的导航栏插件和主页插件固定外，子页插件是通过导航栏插件解析配置文件获取，因此导航栏插件目录下添加其他插件信息配置文件。
如下图：
在这里插入图片描述

3.主项目及子插件的关联

以本文项目举例（详情请看源码）
在主项目头文件中添加插件信息容器集合处理。
在这里插入图片描述
插件初始化时将对应插件存储至相关容器，并关联数据信号处理消息。
在这里插入图片描述

四、源码（此处列举主项目和一个子插件源码为例）

1.主项目相关文件

iplugindatabusinterface.h

#ifndef IPLUGINDATABUSINTERFACE_H
#define IPLUGINDATABUSINTERFACE_H#include <QObject>
#include "commondefins.h"// 通过宏定义插件标识符
#define InterfaceIdent "plugin.plugindatabusinterface"class IPluginDataBusInterface : public QObject
{Q_OBJECT
public:IPluginDataBusInterface(QObject *parent = Q_NULLPTR):QObject(parent){}signals:/*** @brief sigPluginCommTriggered 插件通信信号触发* @param data 插件数据*/void sigPluginCommTriggered(const StCommData &data);public:/*** @brief recvPluginCommData 接收插件数据信息* @param data 插件数据*/virtual void recvPluginCommData(const StCommData &data) = 0;/*** @brief initialize 初始化函数*/virtual void initialize() = 0;/*** @brief isInitialized 是否初始化* @return 初始化状态*/virtual bool isInitialized() const = 0;/*** @brief name 获取插件名* @return 插件名*/virtual QString name() const = 0;/*** @brief createWidget 创建插件控件* @param parent 插件控件父对象* @return 插件控件指针*/virtual QWidget *createWidget() = 0;public slots:/*** @brief slotInitialized 初始化完成槽函数*/virtual void slotInitialized() = 0;protected:bool m_initialized; // 是否初始化变量
};// 将接口对象声明给元对象
Q_DECLARE_INTERFACE(IPluginDataBusInterface, InterfaceIdent)#endif // IPLUGINDATABUSINTERFACE_H

commondefins

commondefins.h

#ifndef COMMONDEFINS_H
#define COMMONDEFINS_H#include <QHash>
#include <QPair>
#include <QString>
#include <QJsonObject>
#include <QMessageBox>#define DefaultPluginLoadPath QString("./") // 默认插件路径enum EmDataCode{PAGE_COMM = 0,PAGE_OPEN,PAGE_CLOSE,PAGE_RELOAD,PAGE_RELOAD_FAILED,PAGE_OPEN_ALL,PAGE_INIT,PAGE_INIT_FAILED,
};typedef struct StCommData {EmDataCode  code;       // 数据码QString     pageName;   // 页面名称QJsonObject commData;   // 通信数据StCommData(){}StCommData(EmDataCode code, QString pageName, QJsonObject commData) {this->code = code;this->pageName = pageName;this->commData = commData;}
}StCommData;// 初始化加载插件信息
typedef struct StInitPluginLoaderInfo {// 当运行模式为Debug时使用的区分使用
#ifdef QT_DEBUGconst QString navigationBar = DefaultPluginLoadPath + "navigationbarplugind.dll";const QString homePage = DefaultPluginLoadPath + "homepageplugind.dll";
#elseconst QString navigationBar = DefaultPluginLoadPath + "navigationbarplugin.dll";const QString homePage = DefaultPluginLoadPath + "homepageplugin.dll";
#endif
//    const QString homePage = DefaultPluginLoadPath + "pagefirstplugin.dll";
}StInitPluginLoaderInfo;// 主页加载插件信息
typedef struct StPluginCommInfo {const QStringList listNavigationBarInfo = {"PageFirst", "PageSecond"};  // 导航栏列表信息}StHomePagePluginLoaderInfo;#endif // COMMONDEFINS_H

commondefins.cpp

#include "commondefins.h"// 创建变量，保证项目可以全局使用
StInitPluginLoaderInfo g_stInitPluginLoaderInfo;

mainwindow

mainwindow.h

#ifndef MAINWINDOW_H
#define MAINWINDOW_H#include <QMainWindow>
#include <QPluginLoader>
#include "iplugindatabusinterface.h"namespace Ui {
class MainWindow;
}class MainWindow : public QMainWindow
{Q_OBJECTpublic:explicit MainWindow(QWidget *parent = Q_NULLPTR);~MainWindow();/*** @brief initial 初始化函数*/void initial();signals:/*** @brief sigInitialized 初始化完成信号*/void sigInitialized();private slots:/*** @brief slotPluginCommTriggered 插件通信槽函数* @param data 通信数据*/void slotPluginCommTriggered(const StCommData &data);private:Ui::MainWindow *ui;QPair<QPluginLoader *, IPluginDataBusInterface *>                   m_pairNavigateInfo;         // 导航栏指针信息QPair<QPluginLoader *, IPluginDataBusInterface *>                   m_pairHomePageInfo;         // 主页指针信息QHash<QString, QPair<QPluginLoader *, IPluginDataBusInterface *>>   m_hashPageLoaderIPlugin;    // 子页指针信息};#endif // MAINWINDOW_H

mainwindow.cpp

#include "mainwindow.h"
#include "ui_mainwindow.h"#include "commondefins.h"
#include <QDebug>
#include <QDateTime>
#include <QFile>extern StInitPluginLoaderInfo g_stInitPluginLoaderInfo;MainWindow::MainWindow(QWidget *parent) :QMainWindow(parent),ui(new Ui::MainWindow)
{ui->setupUi(this);initial();
}MainWindow::~MainWindow()
{// 卸载所有库m_pairNavigateInfo.first->unload();m_pairHomePageInfo.first->unload();foreach(auto info,m_hashPageLoaderIPlugin) {info.first->unload();}delete ui;
}void MainWindow::initial()
{// 初始化导航栏插件m_pairNavigateInfo.first = new QPluginLoader(g_stInitPluginLoaderInfo.navigationBar, this);m_pairNavigateInfo.second = qobject_cast<IPluginDataBusInterface *>(m_pairNavigateInfo.first->instance());connect(m_pairNavigateInfo.second, &IPluginDataBusInterface::sigPluginCommTriggered, this, &MainWindow::slotPluginCommTriggered);connect(this, &MainWindow::sigInitialized, m_pairNavigateInfo.second, &IPluginDataBusInterface::slotInitialized);ui->layoutNavigation->addWidget(m_pairNavigateInfo.second->createWidget());// 初始化主页插件m_pairHomePageInfo.first = new QPluginLoader(g_stInitPluginLoaderInfo.homePage, this);m_pairHomePageInfo.second = qobject_cast<IPluginDataBusInterface *>(m_pairHomePageInfo.first->instance());connect(m_pairHomePageInfo.second, &IPluginDataBusInterface::sigPluginCommTriggered, this, &MainWindow::slotPluginCommTriggered);connect(this, &MainWindow::sigInitialized, m_pairHomePageInfo.second, &IPluginDataBusInterface::slotInitialized);ui->tabWidget->addTab(m_pairHomePageInfo.second->createWidget(), u8"主页");emit sigInitialized();
}void MainWindow::slotPluginCommTriggered(const StCommData &data)
{switch (data.code) {case PAGE_INIT: {// 不同运行模式使用的库名不一样
#ifdef QT_DEBUGQString pluginName = data.commData.value("pluginName").toString() + "d.dll";
#elseQString pluginName = data.commData.value("pluginName").toString() + ".dll";
#endif// 指定加载库路径QPluginLoader *pageLoader = new QPluginLoader(DefaultPluginLoadPath + pluginName, this);// 链接页面信号IPluginDataBusInterface *pageInteface = qobject_cast<IPluginDataBusInterface *>(pageLoader->instance());// 直接判断接口对象，加载失败时指针为0x00，相当于falseif(pageInteface) {// 判断页面是否存在if(m_hashPageLoaderIPlugin.contains(data.pageName)) {QMessageBox::information(this, u8"提示", data.pageName + u8"页面名称已存在");break;}connect(pageInteface, &IPluginDataBusInterface::sigPluginCommTriggered, this, &MainWindow::slotPluginCommTriggered);// 添加页面指针信息m_hashPageLoaderIPlugin[data.pageName] = QPair<QPluginLoader *, IPluginDataBusInterface *>(pageLoader, pageInteface);m_pairHomePageInfo.second->recvPluginCommData(data);}else {StCommData reply = data;reply.code = PAGE_INIT_FAILED;QMessageBox::information(this, u8"提示", data.pageName + u8"页面信息初始化失败" + pageLoader->errorString());m_pairNavigateInfo.second->recvPluginCommData(reply);}break;}case PAGE_OPEN: {// 判断页面是否存在if(!m_hashPageLoaderIPlugin.contains(data.pageName)) {QMessageBox::information(this, u8"提示", data.pageName + u8"页面不存在");}// 判断页面打开状态else if (-1 != ui->tabWidget->indexOf(m_hashPageLoaderIPlugin[data.pageName].second->createWidget())) {QMessageBox::information(this, u8"提示", data.pageName + u8"页面已打开");}// 获取页面指针并打开页面else {QWidget *page = m_hashPageLoaderIPlugin[data.pageName].second->createWidget();ui->tabWidget->addTab(page, data.pageName);ui->tabWidget->setCurrentWidget(page);// 页面打开回执（原信息返回）m_pairNavigateInfo.second->recvPluginCommData(data);}break;}case PAGE_OPEN_ALL: {// 遍历容器，打开所有页面foreach(auto pageInfo, m_hashPageLoaderIPlugin) {ui->tabWidget->addTab(pageInfo.second->createWidget(), m_hashPageLoaderIPlugin.key(pageInfo));}// 页面关闭回执（原信息返回）m_pairNavigateInfo.second->recvPluginCommData(data);break;}case PAGE_CLOSE: {// 判断页面是否存在if (!m_hashPageLoaderIPlugin.contains(data.pageName)) {QMessageBox::information(this, u8"提示", data.pageName + u8"页面不存在");}// 判断页面打开状态else if (-1 == ui->tabWidget->indexOf(m_hashPageLoaderIPlugin[data.pageName].second->createWidget())) {QMessageBox::information(this, u8"提示", data.pageName + u8"页面暂未打开/已关闭");}// 关闭页面else{ui->tabWidget->removeTab(ui->tabWidget->indexOf(m_hashPageLoaderIPlugin[data.pageName].second->createWidget()));// 页面关闭回执（原信息返回）m_pairNavigateInfo.second->recvPluginCommData(data);}break;}case PAGE_RELOAD: {// 判断页面是否存在if (!m_hashPageLoaderIPlugin.contains(data.pageName)) {QMessageBox::information(this, u8"提示", data.pageName + u8"重载页面不存在");}else if(m_hashPageLoaderIPlugin[data.pageName].first->unload()) {QString fileName =  m_hashPageLoaderIPlugin[data.pageName].first->fileName().replace(DefaultPluginLoadPath, DefaultPluginLoadPath + "backup/");// 判断新文件名是否存在，存在即更新库名if (QFile::exists(fileName)) {m_hashPageLoaderIPlugin[data.pageName].first->setFileName(fileName);}// 加载库if (m_hashPageLoaderIPlugin[data.pageName].first->load()) {m_hashPageLoaderIPlugin[data.pageName].second = qobject_cast<IPluginDataBusInterface *>(m_hashPageLoaderIPlugin[data.pageName].first->instance());m_pairNavigateInfo.second->recvPluginCommData(data);m_hashPageLoaderIPlugin[data.pageName].second->createWidget();}else {StCommData tmpData = data;tmpData.code = PAGE_RELOAD_FAILED;m_pairNavigateInfo.second->recvPluginCommData(tmpData);QMessageBox::information(this, u8"提示", data.pageName + u8"页面重载失败 " + m_hashPageLoaderIPlugin[data.pageName].first->errorString());}}else {QMessageBox::information(this, u8"提示", data.pageName + u8"页面重载失败 " + m_hashPageLoaderIPlugin[data.pageName].first->errorString());}break;}default:break;}
}

main.cpp

#include "mainwindow.h"
#include <QApplication>int main(int argc, char *argv[])
{QApplication a(argc, argv);MainWindow w;w.show();return a.exec();
}

2.子插件（页面1）相关文件

注:该插件控件仅ui添加标识label，故仅展示插件文件

pagefirstplugin

pagefirstplugin.h

#ifndef PAGEFIRSTPLUGIN_H
#define PAGEFIRSTPLUGIN_H#include "iplugindatabusinterface.h"#include <QDesignerCustomWidgetInterface>class FormPageFirst;
class PageFirstPlugin : public IPluginDataBusInterface
{Q_OBJECTQ_INTERFACES(IPluginDataBusInterface)
#if QT_VERSION >= 0x050000Q_PLUGIN_METADATA(IID InterfaceIdent)
#endif // QT_VERSION >= 0x050000public:PageFirstPlugin(QObject *parent = Q_NULLPTR);~PageFirstPlugin();// IPluginDataBusInterface interface
public:void initialize();bool isInitialized() const;QString name() const;QWidget *createWidget();void recvPluginCommData(const StCommData &data);// IPluginDataBusInterface interface
public slots:void slotInitialized();private:FormPageFirst *m_formPageFirst = Q_NULLPTR;
};#endif // PAGEFIRSTPLUGIN_H

pagefirstplugin.cpp

#include "formpagefirst.h"
#include "pagefirstplugin.h"#include <QtPlugin>PageFirstPlugin::PageFirstPlugin(QObject *parent): IPluginDataBusInterface(parent)
{m_initialized = false;
}PageFirstPlugin::~PageFirstPlugin()
{if(Q_NULLPTR != m_formPageFirst) {delete m_formPageFirst;m_formPageFirst = Q_NULLPTR;}
}void PageFirstPlugin::initialize()
{if (m_initialized)return;// Add extension registrations, etc. herem_initialized = true;
}void PageFirstPlugin::slotInitialized()
{}void PageFirstPlugin::recvPluginCommData(const StCommData &data)
{}bool PageFirstPlugin::isInitialized() const
{return m_initialized;
}QWidget *PageFirstPlugin::createWidget()
{if(Q_NULLPTR == m_formPageFirst) {m_formPageFirst = new FormPageFirst();}return m_formPageFirst;
}QString PageFirstPlugin::name() const
{return QLatin1String("PageFirstPlugin");
}#if QT_VERSION < 0x050000
Q_EXPORT_PLUGIN2(pagefirstplugin, PageFirstPlugin)
#endif // QT_VERSION < 0x050000

总结

本文简易介绍插件使用、部分通信逻辑及插件构建逻辑，下一篇出插件创建详细步骤。（有需要可私源码）

友情提示——哪里看不懂可私哦，让我们一起互相进步吧
（创作不易，请留下一个免费的赞叭 谢谢 ^o^/)

注：文章为作者编程过程中所遇到的问题和总结，内容仅供参考，若有错误欢迎指出。
注：如有侵权，请联系作者删除

这篇关于Qt之QPluginLoader使用插件子项目及插件间通信（简易框架）（含部分源码+注释）的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/775830。

相关文章

5分钟获取deepseek api并搭建简易问答应用

5分钟获取deepseek api并搭建简易问答应用

《5分钟获取deepseekapi并搭建简易问答应用》本文主要介绍了5分钟获取deepseekapi并搭建简易问答应用,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需... 目录1、获取api2、获取base_url和chat_model3、配置模型参数方法一：终端中临时将加
阅读更多...
使用DeepSeek API 结合VSCode提升开发效率

使用DeepSeek API 结合VSCode提升开发效率

《使用DeepSeekAPI结合VSCode提升开发效率》：本文主要介绍DeepSeekAPI与VisualStudioCode(VSCode)结合使用,以提升软件开发效率,具有一定的参考价值... 目录引言准备工作安装必要的 VSCode 扩展配置 DeepSeek API1. 创建 API 请求文件2.
阅读更多...
使用TomCat,service输出台出现乱码的解决

使用TomCat,service输出台出现乱码的解决

《使用TomCat,service输出台出现乱码的解决》本文介绍了解决Tomcat服务输出台中文乱码问题的两种方法,第一种方法是修改`logging.properties`文件中的`prefix`和`... 目录使用TomCat,service输出台出现乱码问题1解决方案问题2解决方案总结使用TomCat,
阅读更多...
解决IDEA使用springBoot创建项目,lombok标注实体类后编译无报错,但是运行时报错问题

解决IDEA使用springBoot创建项目,lombok标注实体类后编译无报错,但是运行时报错问题

《解决IDEA使用springBoot创建项目,lombok标注实体类后编译无报错,但是运行时报错问题》文章详细描述了在使用lombok的@Data注解标注实体类时遇到编译无误但运行时报错的问题,分析... 目录问题分析问题解决方案步骤一步骤二步骤三总结问题使用lombok注解@Data标注实体类，编译时
阅读更多...
Java中使用Java Mail实现邮件服务功能示例

Java中使用Java Mail实现邮件服务功能示例

《Java中使用JavaMail实现邮件服务功能示例》：本文主要介绍Java中使用JavaMail实现邮件服务功能的相关资料,文章还提供了一个发送邮件的示例代码,包括创建参数类、邮件类和执行结... 目录前言一、历史背景二编程、pom依赖三、API说明（一）Session （会话）（二）Message编程客
阅读更多...
C++中使用vector存储并遍历数据的基本步骤

C++中使用vector存储并遍历数据的基本步骤

《C++中使用vector存储并遍历数据的基本步骤》C++标准模板库（STL）提供了多种容器类型,包括顺序容器、关联容器、无序关联容器和容器适配器,每种容器都有其特定的用途和特性,：本文主要介绍C... 目录（1）容器及简要描述‌php顺序容器‌‌关联容器‌‌无序关联容器‌（基于哈希表）：‌容器适配器‌：（
阅读更多...
使用Python实现高效的端口扫描器

使用Python实现高效的端口扫描器

《使用Python实现高效的端口扫描器》在网络安全领域,端口扫描是一项基本而重要的技能,通过端口扫描,可以发现目标主机上开放的服务和端口,这对于安全评估、渗透测试等有着不可忽视的作用,本文将介绍如何使... 目录1. 端口扫描的基本原理2. 使用python实现端口扫描2.1 安装必要的库2.2 编写端口扫
阅读更多...
使用Python实现操作mongodb详解

使用Python实现操作mongodb详解

《使用Python实现操作mongodb详解》这篇文章主要为大家详细介绍了使用Python实现操作mongodb的相关知识,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录一、示例二、常用指令三、遇到的问题一、示例from pymongo import MongoClientf
阅读更多...
SQL Server使用SELECT INTO实现表备份的代码示例

SQL Server使用SELECT INTO实现表备份的代码示例

《SQLServer使用SELECTINTO实现表备份的代码示例》在数据库管理过程中,有时我们需要对表进行备份,以防数据丢失或修改错误,在SQLServer中,可以使用SELECTINT... 在数据库管理过程中，有时我们需要对表进行备份，以防数据丢失或修改错误。在 SQL Server 中，可以使用 SE
阅读更多...
使用Python合并 Excel单元格指定行列或单元格范围

使用Python合并 Excel单元格指定行列或单元格范围

《使用Python合并Excel单元格指定行列或单元格范围》合并Excel单元格是Excel数据处理和表格设计中的一项常用操作,本文将介绍如何通过Python合并Excel中的指定行列或单... 目录python Excel库安装Python合并Excel 中的指定行Python合并Excel 中的指定列P
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2