qt 为应用程序添加自定义插件

我有一个梦想，我写的代码，可以像诗一样优美。我有一个梦想，我做的设计，能恰到好处，既不过度，也无不足。

前因后果：项目交接中有个需求是用户后续能够在研究出新算法后，可以在没有源码的情况下，自己将算法加入系统，因为这个，所有把自定义插件看了下，网上这方面的东西没找到多少，而且已有的涉及到的描述的也并不清楚，故将此记录下来，以供其他同学参考。

既然是自定义插件，故会有两个工程

插件工程

新建工程，选择library,选中C++库（不要直接选择Qt crator 插件，因为这个后面我也没弄明白，也没想着去弄）
操作如图：
1.
2.
3.创建过程中，除了工程名称需要填写外，其他的默认下一步即可。
4.不要直接选中qt creator 插件

5.工程创建完毕
6.修改.pro工程文件
将DESTDIR = $$[QT_INSTALL_PLUGINS]/generic 修改为 DESTDIR = $$PWD/bin，非必须项，但是如果不改的话，你需要自己到qt定义的该路径下去找你生成的插件dll.

7.创建插件继承的抽象类，在后面的应用程序中，也是通过这个纯虚函数的指针来使用插件，知识点：C++ 三大特性：封装、继承、多态。

抽象类头文件如下：

#ifndef CSDNFACE_H
#define CSDNFACE_H

#include <QString>

class Csdnface
{
public:
    virtual ~Csdnface(){}
    virtual bool setString(QString test) = 0;
    virtual QString getString() = 0;
};

QT_BEGIN_NAMESPACE

#define face_iid "ta.face"

Q_DECLARE_INTERFACE(Csdnface, face_iid)

QT_END_NAMESPACE

#endif // CSDNFACE_H

代码解释
（1）QT_BEGIN_NAMESPACE QT_END_NAMESPACE qt 自定义命名空间，应该是防止与现有的类或者宏定义产生冲突。
（2）#define face_iid “ta.face” 定义一个宏
（3）Q_DECLARE_INTERFACE(face, face_iid) 将该插件的接口信息告知元对象系统，这是一个插件接口

8.修改代码（我用的并不是默认继承的QGenericPlugin，感兴趣的小伙伴可以自行了解该系列类）

生成的原代码如下：

#ifndef CSDNPLUGIN_H
#define CSDNPLUGIN_H

#include <QGenericPlugin>


class CSDNPlugin : public QGenericPlugin
{
    Q_OBJECT
#if QT_VERSION >= 0x050000
    Q_PLUGIN_METADATA(IID "org.qt-project.Qt.QGenericPluginFactoryInterface" FILE "pluginforcsdn.json")
#endif // QT_VERSION >= 0x050000

public:
    CSDNPlugin(QObject *parent = 0);
};

#endif // CSDNPLUGIN_H

9.修改后的代码

#ifndef CSDNPLUGIN_H
#define CSDNPLUGIN_H

#include <QObject>
#include <QtPlugin>
#include "csdnface.h"

class CSDNPlugin : public QObject, Csdnface
{
    Q_OBJECT

    Q_PLUGIN_METADATA(IID "ta.face" FILE "pluginforcsdn.json")
    Q_INTERFACES(Csdnface)//告知源对象系统该插件

public:
    CSDNPlugin(QObject *parent = 0);
    QString getString();

};

#endif // CSDNPLUGIN_H

源代码：

#include "csdnplugin.h"


CSDNPlugin::CSDNPlugin(QObject *parent)
{
}


QString CSDNPlugin::getString()
{
    return "this is a plugin test string for csdn";
}

编译运行：

成功生成该插件库

工程加载
创建一个项目工程，以下以一个控制台为例：
建立项目后，将抽象类头文件拷贝添加至工程，将生成的插件库放至控制台程序所在路径（路径可以自己设置，但需要在代码中指明）。

代码：

#include <QCoreApplication>
#include "csdnface.h"
#include <QDir>
#include <QtPlugin>
#include <QPluginLoader>
#include <QDebug>

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

    Csdnface * faceInstance = NULL;
    QDir pluginDir(qApp->applicationDirPath());

    foreach (QString fileName, pluginDir.entryList(QDir::Files))
    {
        QPluginLoader pluginLoader(pluginDir.absoluteFilePath(fileName));
        QObject * plugin = pluginLoader.instance();
        if(plugin)
        {
            faceInstance = qobject_cast<Csdnface*>(plugin);
            if(faceInstance)
            {
                break;
            }
        }

    }
    if(!faceInstance)
        return false;

    QString testStr = faceInstance->getString();

    qDebug()<<testStr;

    return a.exec();
}

运行结果：

本文只是简单的实现了为程序添加自定义插件的功能，旨在标明其工作流程以及实现逻辑，感兴趣的小伙伴可以自己动手实现一波。

码农之路长漫漫，自当抱团取暖