QWebEngineExtensionManager Class
QWebEngineExtensionManager 类允许应用程序从文件系统安装和加载 Chrome 浏览器扩展。更多
| Header： | #include <QWebEngineExtensionManager> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake： | QT += webenginecore |
| 自 | Qt 6.10 |
| 继承： | QObject |
属性
- extensions : const QList<QWebEngineExtensionInfo>
- installPath : const QString
公共函数
| QList<QWebEngineExtensionInfo> | extensions() const |
| void | installExtension(const QString &path) |
| QString | installPath() const |
| void | loadExtension(const QString &path) |
| void | setExtensionEnabled(const QWebEngineExtensionInfo &extension, bool enabled) |
| void | uninstallExtension(const QWebEngineExtensionInfo &extension) |
| void | unloadExtension(const QWebEngineExtensionInfo &extension) |
重新实现的受保护函数
| virtual bool | event(QEvent *e) override |
详细说明
QWebEngineExtensionManager 可加载或安装 Chrome 浏览器扩展。扩展可以通过loadExtension 加载。以这种方式加载的扩展不会被相关配置文件记住，必须在每次新的浏览会话中手动加载。为了在浏览会话之间保留扩展程序，应用程序可以通过installExtension 安装压缩或未打包的扩展程序。在这种情况下，管理器会将扩展解压缩到配置文件的目录中，然后从那里加载。已安装的扩展总是在启动时、配置文件初始化后加载。
您可以使用extensions() 访问已加载的扩展，它提供了一个QWebEngineExtensionInfo 的列表，或者连接到管理器的信号，以获取加载或安装进程的状态通知。
每个QWebEngineProfile 都有自己的QWebEngineExtensionManager ，因此共享相同配置文件的每个页面也将共享相同的扩展。扩展无法加载到非记录配置文件中。
注意： 仅支持 ManifestV3 扩展，其他版本将无法加载或安装。
另请参阅 QWebEngineProfile::extensionManager 和QWebEngineExtensionInfo 。
属性文档
[read-only] extensions : const QList<QWebEngineExtensionInfo>
返回已加载扩展程序的列表。
访问功能：
| QList<QWebEngineExtensionInfo> | extensions() const |
另请参阅 QWebEngineExtensionInfo 。
[read-only] installPath : const QString
返回安装扩展的目录路径。
访问功能：
| QString | installPath() const |
另请参阅 installExtension() 和QWebEngineExtensionInfo::isInstalled()。
成员函数文档
[override virtual protected] bool QWebEngineExtensionManager::event(QEvent *e)
重实现：QObject::event(QEvent *e)。
[invokable] void QWebEngineExtensionManager::installExtension(const QString &path)
将扩展从path 安装到配置文件目录并加载它。
QWebEngineExtensionManager::installFinished 信号会在扩展安装完成或安装失败后发出。如果安装成功，QWebEngineExtensionInfo::isInstalled() 将返回 true，否则QWebEngineExtensionInfo::error() 将包含安装过程失败的信息。
安装成功后，扩展会以禁用状态加载。每次启动时，已安装的扩展会在禁用状态下自动加载。可以使用installPath() 查询安装路径。
安装程序可以安装压缩或未压缩的扩展。path 参数应指向包含扩展清单文件的目录或压缩文件。如果顶层目录中缺少清单文件，安装过程将中止。
从同一路径安装已加载或已安装的扩展将安装一个新扩展。
注： 可通过元对象系统和 QML 调用此函数。参见Q_INVOKABLE 。
另请参阅 QWebEngineExtensionInfo::isInstalled()、QWebEngineExtensionInfo::error() 和installPath()。
[invokable] void QWebEngineExtensionManager::loadExtension(const QString &path)
从path
QWebEngineExtensionManager::loadFinished 信号会在扩展加载完成或加载失败时发出。如果加载成功，QWebEngineExtensionInfo::isLoaded() 将返回 true，否则QWebEngineExtensionInfo::error() 将包含加载过程失败的信息。
扩展总是在禁用状态下加载的，用户必须手动启用它们。从同一路径加载已加载的扩展将重新加载扩展。
注： 可通过元对象系统和 QML 调用该函数。参见Q_INVOKABLE 。
另请参见 QWebEngineExtensionInfo::isLoaded() 和QWebEngineExtensionInfo::error()。
[invokable] void QWebEngineExtensionManager::setExtensionEnabled(const QWebEngineExtensionInfo &extension, bool enabled)
允许在运行时打开/关闭extension
enabled 参数决定是否启用或禁用扩展。
注： 也可禁用 Hangouts 和 PDF 等内部扩展。
注： 可通过元对象系统和 QML 调用该函数。请参见Q_INVOKABLE 。
另请参阅 QWebEngineExtensionInfo::isEnabled() 。
[invokable] void QWebEngineExtensionManager::uninstallExtension(const QWebEngineExtensionInfo &extension)
卸载扩展extension
从安装路径中移除扩展文件并卸载扩展。过程结束后，将发出 QWebEngineExtensionManager::uninstallFinished 信号。
注： 该函数可通过元对象系统或 QML 调用。请参见Q_INVOKABLE 。
另请参阅 QWebEngineExtensionManager::installPath()、QWebEngineExtensionInfo::isInstalled() 和QWebEngineExtensionInfo::error()。
[invokable] void QWebEngineExtensionManager::unloadExtension(const QWebEngineExtensionInfo &extension)
卸载extension
从内存中删除扩展的所有数据。
卸载过程结束后，会发出 QWebEngineExtensionManager::unloadFinished 信号。
注： 也可以卸载内部扩展（如 Hangouts 和 PDF），但它们会像其他已安装的扩展一样在下次启动时加载。
注： 可通过元对象系统和 QML 调用此函数。请参见Q_INVOKABLE 。
另请参阅 QWebEngineExtensionInfo::isLoaded() 。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
