【Qt QML】QLibrary加载共享库中的类

news2024/10/7 2:24:47

QLibrary是一个用于加载动态链接库（或称为共享库）的类。它提供了一种独立于平台的方式来访问库中的功能。

在QLibrary中，可以通过构造函数或setFileName()方法设置要加载的库文件名。当加载库文件时，QLibrary会搜索所有平台特定的库位置，除非传入的文件名具有绝对路径。如果传入的文件名具有绝对路径，那么会首先尝试加载该目录。如果该文件找不到，QLibrary会使用不同的平台特定的文件前缀或后缀再次尝试。例如，在Unix和Mac平台上使用"lib"前缀，在Unix平台上使用".so"后缀，在Mac平台上使用".dylib"，在Windows平台上使用".dll"。

使用QLibrary可以在程序运行时加载动态链接库，一个QLibrary的实例作用于一个单一的共享库上。QLibrary提供了一种平台无关的方式访问库中的函数。此外，通过调用load()函数加载链接库，使用isLoad()函数判断加载是否成功，使用resolve()与load()差不多，但是当如果load失败，将会尝试再次加载。当经过一次加载后，链接库将会存储到内存中直到应用程序退出。使用unload()函数解除，如果有多个QLibrary使用了同一个动态链接库unload()将返回false。

下面的例子用来演示如何运行时加载共享库中的类

一、创建一个共享库

1、打开Qt Creator，创建共享库，新建类TestPlugin
TestPlugin.h

#ifndef TESTPLUGIN_H
#define TESTPLUGIN_H

#include "testPlugin_global.h"

class TESTPLUGIN_EXPORT TestPlugin
{
public:
    virtual ~TestPlugin();
    virtual int TestAddFunc(int a, int b) = 0;
};

class TESTPLUGIN_EXPORT TestPluginLib : public TestPlugin
{
public:
    virtual ~TestPluginLib();
    int TestAddFunc(int a, int b) override;
};

extern "C"{
TESTPLUGIN_EXPORT void* createTestPlugin();
}

#endif // TESTPLUGIN_H

TestPlugin.cpp

#include "testplugin.h"

TestPlugin::~TestPlugin()
{

}

void *createTestPlugin()
{
    return new TestPluginLib();
}

TestPluginLib::~TestPluginLib()
{

}

int TestPluginLib::TestAddFunc(int a, int b)
{
    return a+b;
}

2、导出宏定义

#ifndef TESTPLUGIN_GLOBAL_H
#define TESTPLUGIN_GLOBAL_H

#include <QtCore/qglobal.h>

#if defined(TESTPLUGIN_LIBRARY)
#define TESTPLUGIN_EXPORT Q_DECL_EXPORT
#else
#define TESTPLUGIN_EXPORT Q_DECL_IMPORT
#endif

#endif // TESTPLUGIN_GLOBAL_H

二、新建动态库加载demo，加载方式如下：

	using pluginFunc = void*(*)();

    QLibrary lib("testPlugin");
    if(!lib.load()){
        qCritical() <<__FUNCTION__<<" load error!";
        return -1;
    }

    auto func = (pluginFunc)lib.resolve("createTestPlugin");

    TestPlugin* cppLibObj = static_cast<TestPlugin*>(func());
    if(!cppLibObj)
    {
        qCritical() <<__FUNCTION__<<" cppLibObj is nullptr!";
        return -1;
    }

    qInfo() <<__FUNCTION__<< "cppLibObj->TestAddFunc(1, 2)="<< cppLibObj->TestAddFunc(1, 2);