QPluginLoader Class

成员函数文档

[explicit] QPluginLoader::QPluginLoader(QObject *parent = nullptr)

使用给定的parent 构建一个插件加载器。

[explicit] QPluginLoader::QPluginLoader(const QString &fileName, QObject *parent = nullptr)

根据给定的parent 构建一个插件加载器，该加载器将加载由fileName 指定的插件。

要使文件可加载，其后缀必须是符合平台规范的可加载库的有效后缀，例如：在 Unix 系统上为.so ，在 macOS 和 iOS 系统上为 -.dylib ，在 Windows 系统上为.dll 。可通过QLibrary::isLibrary() 验证后缀是否有效。

另请参阅 setFileName()。

[virtual noexcept] QPluginLoader::~QPluginLoader()

销毁QPluginLoader 对象。

除非显式调用了 `unload()`，否则该插件将一直驻留于内存中，直至应用程序终止。

另请参阅 isLoaded() 和unload()。

QString QPluginLoader::errorString() const

返回一个包含最后一次发生错误的描述的文本字符串。

QObject *QPluginLoader::instance()

返回插件的根组件对象。如有必要，会加载该插件。如果无法加载插件，或者无法实例化根组件对象，该函数将返回nullptr 。

如果根组件对象已被销毁，调用此函数将创建一个新实例。

当QPluginLoader 被销毁时，本函数返回的根组件不会被删除。若需确保根组件被删除，应在不再需要访问核心组件时立即调用unload()。当库最终被卸载时，根组件将自动被删除。

该组件对象是一个QObject 。请使用qobject_cast()来访问您感兴趣的接口。

另请参阅 load()。

bool QPluginLoader::isLoaded() const

如果插件已加载，则返回true ；否则返回false 。

另请参阅 load()。

bool QPluginLoader::load()

加载插件，如果加载成功则返回true ；否则返回false 。由于instance()在解析任何符号之前都会调用此函数，因此无需显式调用它。在某些情况下，您可能希望预先加载插件，此时应使用此函数。

另请参阅 unload()。

QJsonObject QPluginLoader::metaData() const

返回此插件的元数据。该元数据是在编译插件时，通过Q_PLUGIN_METADATA()宏以JSON格式指定的数据。

无需实际加载插件，即可快速且低开销地查询这些元数据。这使得可以将插件的功能权限等信息存储在元数据中，并根据这些元数据来决定是否加载该插件。

[static] QObjectList QPluginLoader::staticInstances()

返回插件加载器所持有的静态插件实例（根组件）的列表。

另请参阅 staticPlugins()。

[static] QList<QStaticPlugin> QPluginLoader::staticPlugins()

返回插件加载器所持有的 QStaticPlugins 列表。该函数与staticInstances() 类似，不同之处在于QStaticPlugin 还包含元数据信息。

另请参阅 staticInstances()。

bool QPluginLoader::unload()

卸载插件，如果插件能够被卸载，则返回true ；否则返回false 。

应用程序终止时会自动执行此操作，因此通常无需调用此函数。

如果其他 `QPluginLoader ` 实例正在使用同一个插件，则调用将失败；只有当所有实例都已调用 `unload()` 时，才会发生卸载。

请勿尝试删除根组件。应依赖 unload() 函数，它会在需要时自动将其删除。

另请参阅 instance() 和load()。