Qt 高阶 08｜Qt 插件开发 接口设计、插件编写、动态加载插件

一、插件原理

基于抽象接口 + 动态库（dll/so/dylib）实现解耦扩展，主程序只依赖接口，不依赖具体实现。

二、步骤 1：定义统一抽象接口（头文件）

cpp

运行

// plugininterface.h #ifndef PLUGININTERFACE_H #define PLUGININTERFACE_H #include <QObject> class PluginInterface { public: virtual ~PluginInterface() = default; virtual QString getPluginName() = 0; virtual void exec() = 0; }; // Qt插件宏标记 #define PluginInterface_iid "com.example.PluginInterface" Q_DECLARE_INTERFACE(PluginInterface, PluginInterface_iid) #endif

三、步骤 2：编写插件工程（动态库）

1. 新建Library -> Qt Plugin项目；
2. 实现接口类，并添加插件导出宏：

cpp

运行

#include "plugininterface.h" class DemoPlugin : public QObject, public PluginInterface { Q_OBJECT Q_PLUGIN_METADATA(IID PluginInterface_iid FILE "plugin.json") Q_INTERFACES(PluginInterface) public: QString getPluginName() override { return "演示插件"; } void exec() override { qDebug() << "插件执行"; } };

3.编译生成对应平台插件库文件。

四、步骤 3：主程序动态加载插件

cpp

运行

#include <QPluginLoader> QPluginLoader loader("demoplugin.dll"); // Windows dll Linux so macOS dylib QObject* obj = loader.instance(); if(obj) { PluginInterface* plugin = qobject_cast<PluginInterface*>(obj); if(plugin) { qDebug() << plugin->getPluginName(); plugin->exec(); } }

小结

插件架构实现功能热插拔、模块解耦，大型软件、模块化系统必备；核心是抽象接口 +Q_PLUGIN_METADATA宏。