Qt中如何使用插件

Qt中如何使用插件

Qt提供了一个类QPluginLoader来加载静态库和动态库，在Qt中Qt把动态库和静态库都看成是一个插件，使用QPluginLoader来加载和卸载这些库。由于在开发项目的过程中，要开发一套插件系统，就使用了Qt的这套类库。

1. 编写插件

编写一个Qt的插件需要以下步骤:

1. 声明一个插件类；
2. 定义一个类，实现这个插件类定义的接口，定义的这个类必须从QObject集成下来；
3. 使用Q_INTERFACESQ_INTERFACES()告知Qt的元系统这个接口的存在；
4. 使用宏Q_EXPORT_PLUGIN2()来导出插件的接口；
5. 编写插件类的.pro文件。

下面是一个插件的例子：

class FilterInterface

{

public:

     virtual ~FilterInterface() {}

     virtual QStringList filters() const = 0;

     virtual QImage filterImage(const QString &filter, const QImage &image, QWidget *parent) = 0;

};

注意：接口类必须是一个纯虚函数。

Q_DECLARE_INTERFACE(FilterInterface,"com.trolltech.PlugAndPaint.BrushInterface/1.0") 

为了使得程序在运行时刻可以查询一个插件是否实现了给定的接口，必须使用宏Q_DECLARE_INTERFACE()。第一个参数是接口名字，第二个参数是一个确定接口的字符串。方便起见，使用了JAVA包的命名方法。如果后来我们改变接口，必须使用一个新的字符串来确认接口。否则，应用程序可能崩溃，所以包括一个版本号是一个不错的方法。

#include <QObject>

#include <QStringList>

#include <QImage>

#include <plugandpaint/interfaces.h>

class ExtraFiltersPlugin : public QObject, public FilterInterface

{

     Q_OBJECT

     Q_INTERFACES(FilterInterface)

 

public:

     QStringList filters() const;

     QImage filterImage(const QString &filter, const QImage &image, QWidget *parent);

};

实现这个接口类。实现接口的这个类必须从QObject派生下来，并且必须实现接口类里定义的虚函数。

Q_EXPORT_PLUGIN2(PlugExtraFilters,  ExtraFiltersPlugin )

由于应用函数使用main()函数作为入口点，插件必须使用宏Q_EXPORT_PLUGIN2()指定那个类提供插件。

这一行代码可以出现在实现接口类的.cpp文件的任何一行。其中第一个参数为插件的名称，第二个参数为插件类

2. 使用插件

QPluginLoader loader(pluginsDir.absoluteFilePath(fileName));

QObject *plugin = loader.instance();

if (plugin) {

     populateMenus(plugin);

     pluginFileNames += fileName;

}

QPluginLoader类提供了一个函数loader来加载插件的实例，如果动态链接库不是一个插件，或者编译的Qt的版本库不对，返回的QObject对象的指针为空。使用unload函数来卸载插件。

#ifndef CPLUGININTERFACE01_H_

#define CPLUGININTERFACE01_H_

 

class QWidget;

 

class CPluginInterface01

{

public:

       virtual ~CPluginInterface01(){};

       virtual QWidget* getWidget(QWidget *pParent) = 0;

};

 

QT_BEGIN_NAMESPACE

       Q_DECLARE_INTERFACE(CPluginInterface01,"CPluginInterface01/1.0");

QT_END_NAMESPACE

 

#endif //#define CPLUGININTERFACE01_H_

 

#ifndef Plugin01_H_

#define Plugin01_H_

 

#include <QObject>

#include "PluginInterface01.h"

 

class CPlugin01 : public QObject, public CPluginInterface01

{

 

       Q_OBJECT

       Q_INTERFACES(CPluginInterface01)

 

public:

       CPlugin01();

       ~CPlugin01();

       QWidget* getWidget(QWidget *pParent);

};

 

#endif //Plugin01_H_

 

#include <QWidget>

#include <QtPlugin>

#include <QPushButton>

#include "Plugin01.h"

 

CPlugin01::CPlugin01()

{

 

}

 

CPlugin01::~CPlugin01()

{

 

}

 

QWidget* CPlugin01::getWidget(QWidget *pParent)

{

       QWidget *p = new QWidget(pParent);

       QPushButton *btn = new QPushButton(p);

 

       return p;

}

 

Q_EXPORT_PLUGIN2("Plugin01", CPlugin01)

 

#include <QtGui/QApplication>

#include <QPluginLoader>

#include "PluginInterface01.h"

#include <QFile>

#include <QWidget>

 

int main(int argc, char *argv[])

{

       QApplication a(argc, argv);

 

       QString fileName = "D:\\projects\\vs2010_projects\\qt_plugin_test\\Win32\\Debug\\qt_plugin_interface01.dll";

 

       if (QFile().exists(fileName))

       {

              QPluginLoader loader(fileName);

              CPluginInterface01 *interface = qobject_cast<CPluginInterface01*>(loader.instance());

              if (interface)

              {

                     QWidget* ptr = interface->getWidget(NULL);

                     ptr->show();

              }

       }

       return a.exec();

}