安装指南

pip install pywebview

上述命令将根据你所使用的平台，默认安装 pywebview 的依赖项。

在 Linux 系统中，你需要显式地选择 QT 或 GTK。

pip install pywebview[gtk]

或者

# 这将安装 PyQT6
pip install pywebview[qt]

与 QT 相关的其他选项包括 pywebview[qt5]、pywebview[pyside2] 和 pywebview[pyside6]。

其他可选依赖项为 pywebview[android]、pywebview[cef] 和 pywebview[ssl]。其中，CEF 仅适用于 Windows 系统。选择 ssl 选项将安装 cryptography 包，这是在本地 HTTP 服务器中使用 HTTPS 所必需的。

依赖项说明

Windows 平台

pythonnet（要求 .NET 大于 4.0 版本）

若希望与最新的 Chromium 浏览器兼容，需安装 WebView2 Runtime。如果你计划将软件进行分发，请参阅分发指南。

若想使用 CEF，则需要安装 cefpython。

在 Windows 系统中，你也可以选择 QT。

macOS 平台

pyobjc

PyObjC 通常已经预装在 macOS 自带的 Python 中。若是在独立安装的 Python 环境下使用，则需要单独安装 PyObjC 包。不过，你无需安装完整的 PyObjC 包，仅需以下组件即可：

pyobjc-core
pyobjc-framework-Cocoa
pyobjc-framework-Quartz
pyobjc_framework_WebKit
pyobjc_framework_security

在 macOS 系统中，你也可以选择 QT。

Linux 平台

执行 pip install pywebview[qt] 即可处理 QT 依赖项。如果安装失败或希望使用 GTK，可以尝试以下方法。

在基于 Debian 的系统上安装 QtWebChannel（推荐使用，因为更现代）

sudo apt install python3-pyqt5 python3-pyqt5.qtwebengine python3-pyqt5.qtwebchannel libqt5webkit5-dev

若希望安装 legacy 版本的 QtWebKit

sudo apt install python3-pyqt5 python3-pyqt5.qtwebkit python-pyqt5 python-pyqt5.qtwebkit libqt5webkit5-dev

使用 GTK 则需要 PyGObject。在 Ubuntu 系统上安装相关依赖项可执行以下命令：

sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-3.0 gir1.2-webkit2-4.1

对于其他发行版，请参阅PyGObject 文档。

注意，WebKit2 版本要求在 2.22 或更高版本。

::: 警告 从 Ubuntu Disco Dingo 开始，pywebview 可以通过 apt 在基于 Debian 的系统上安装为 python3-webview 或 python-pywebview。不过，Ubuntu 的软件源版本通常会滞后几个版本。如果你希望保持与最新版本同步，建议使用 pip 安装。 :::

Android 开发

若要在 Android 平台进行开发，请参考 Kivy 的Android 打包指南。