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

ops/2024/9/23 10:48:52/

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);