如何在Python的Kivy窗口中实现可用的内嵌URL浏览WebView组件？

方案1：手动安装Kivy Garden WebView #

由于该模块已不在PyPI源中，可通过garden工具或直接克隆仓库安装：

1. 安装garden工具：

   pip install kivy-garden
   

2. 安装webview模块：

   garden install --app webview
   

   若上述命令失败，直接克隆仓库到项目目录或Python site-packages：

   git clone https://github.com/kivy-garden/garden.webview.git
   

   之后在代码中导入使用：

   from garden.webview import WebView
   
   # 示例用法
   webview = WebView(url="https://example.com")
   

方案2：结合PyQtWebEngine嵌入 #

利用PyQt的WebEngine组件实现Kivy窗口内的WebView：

1. 安装依赖：

   pip install PyQt5 PyQtWebEngine kivy
   

2. 示例代码：

   from kivy.app import App
   from kivy.core.window import Window
   from PyQt5.QtWidgets import QWidget
   from PyQt5.QtWebEngineWidgets import QWebEngineView
   from PyQt5.QtCore import QUrl
   import sys
   
   class KivyWebViewApp(App):
       def build(self):
           # 初始化Qt应用
           qapp = sys.modules.get('PyQt5.QtWidgets.QApplication') or QApplication(sys.argv)
           # 创建WebEngine视图
           web_view = QWebEngineView()
           web_view.load(QUrl("https://example.com"))
           # 绑定到Kivy窗口句柄
           window_handle = Window.get_window_info().window.handle
           container = QWidget.createWindowContainer(web_view, window_handle)
           web_view.showMaximized()
           return None  # 直接使用嵌入式控件
   
   if __name__ == "__main__":
       KivyWebViewApp().run()
   

方案3：使用cefpython3（基于Chromium） #

这是跨平台稳定的嵌入式WebView选项：

1. 安装依赖：

   pip install cefpython3
   

2. 示例代码：

   from kivy.app import App
   from kivy.core.window import Window
   import cefpython3 as cef
   import sys
   
   class CEFWebViewApp(App):
       def build(self):
           cef.Initialize()
           # 获取Kivy窗口句柄
           window_handle = Window.get_window_info().window.handle
           # 创建浏览器实例
           self.browser = cef.CreateBrowserSync(url="https://example.com", parent_window=window_handle)
           Window.bind(size=self.resize_browser)
           return None
   
       def resize_browser(self, instance, size):
           self.browser.SetBounds(0, 0, size[0], size[1])
   
       def on_stop(self):
           cef.Shutdown()
   
   if __name__ == "__main__":
       app = CEFWebViewApp()
       app.run()
   

针对你遇到的问题的修复提示 #

• webview构建wheel失败：Windows需安装Visual Studio构建工具，Linux需安装libgtk-3-dev、libwebkit2gtk-4.0-dev等系统依赖后重试安装。
• webengine模块无法识别：检查导入语句是否正确（应为import webengine），若仍无效，卸载后确认模块名称是否正确，避免同名模块冲突。

内容的提问来源于stack exchange，提问作者Programman