Kivy开发Android应用时如何关闭WebView、实现返回键退出切回原有布局

• 引用丢失：WebView()函数内部创建的webview是局部变量，函数执行完成后没有被全局持有，后续key_back_handler里调用的webview对象根本不存在，执行时会触发空引用错误，没有实际效果
• 原生返回键未绑定：自定义的key_back_handler方法从未和Android系统返回键事件建立关联，按下返回键时走的是系统默认逻辑，不会执行你写的处理代码
• 布局切换逻辑存在多处语法bug：quit_screen函数里存在button大小写错误、e.add_widget(e)自引用递归、运行时根布局没有switch_screen方法的问题，就算触发了也会直接崩溃
• 资源释放不完整：没有把WebView从Activity的视图层级移除，也没有调用destroy()方法完成原生资源回收，就算界面切走也会造成内存泄漏

1. 全局状态维护 #

把WebView实例、原始Kivy根布局存在全局作用域，避免局部变量销毁后引用丢失：

# 全局持有核心对象
webview = None
original_root_widget = None  # 保存切换WebView前的原Kivy布局
exit_trigger_urls = ["https://预设的自动退出触发链接"]  # 匹配到这些链接时自动退出WebView

2. 自定义WebViewClient实现自动退出逻辑 #

重写WebViewClient的页面加载回调，拿到当前加载的URL做匹配判断：

@run_thread
def get_custom_webview_client():
    WebViewClient = autoclass('android.webkit.WebViewClient')
    class CustomWebViewClient(WebViewClient):
        def onPageStarted(self, view, url, favicon):
            # 读取当前加载的页面链接
            current_url = url.toString()
            # 匹配预设的退出触发链接
            if current_url in exit_trigger_urls:
                # 延迟触发退出流程，避免阻塞WebView加载线程
                Clock.schedule_once(lambda dt: cleanup_and_exit_webview(), 0.5)
    return CustomWebViewClient()

3. 修正WebView创建、视图切换逻辑 #

替换原有WebView创建函数，补全全局引用、视图保存逻辑：

@run_thread
def show_webview(link):
    global webview, original_root_widget
    WebV = autoclass('android.webkit.WebView')
    activity = autoclass('org.kivy.android.PythonActivity').mActivity
    
    # 保存当前的Kivy根布局，后续退出时切回
    original_root_widget = activity.getContentView()
    # 创建WebView实例
    webview = WebV(activity)
    # 配置WebView基础设置
    settings = webview.getSettings()
    settings.setJavaScriptEnabled(True)
    settings.setUseWideViewPort(True) 
    settings.setLoadWithOverviewMode(True) 
    settings.setSupportZoom(True)
    settings.setBuiltInZoomControls(True)
    # 绑定自定义WebViewClient
    webview.setWebViewClient(get_custom_webview_client())
    # 把WebView设为当前Activity的展示内容
    activity.setContentView(webview)
    webview.loadUrl(link)

4. 绑定返回键事件与资源清理逻辑 #

接管系统返回键回调，实现按返回时WebView的回退与资源清理：

@mainthread
def switch_back_to_kivy_root():
    activity = autoclass('org.kivy.android.PythonActivity').mActivity
    # 把之前保存的Kivy原布局设回Activity展示内容
    activity.setContentView(original_root_widget)

@run_thread
def cleanup_and_exit_webview():
    global webview
    if not webview:
        return
    # 完整执行WebView资源清理
    webview.loadUrl("about:blank")
    webview.clearHistory()
    webview.clearCache(True)
    webview.clearFormData()
    # 从父视图层级移除WebView
    parent = webview.getParent()
    if parent:
        parent.removeView(webview)
    # 调用原生销毁方法回收资源
    webview.destroy()
    webview = None
    # 切回原Kivy布局
    switch_back_to_kivy_root()

@run_thread
def bind_back_pressed_callback():
    activity = autoclass('org.kivy.android.PythonActivity').mActivity
    # 重写返回键处理逻辑
    def on_back_pressed():
        global webview
        if webview:
            # WebView内部还有浏览历史时，先回退上一页，不直接退出
            if webview.canGoBack():
                webview.goBack()
            else:
                # 没有浏览历史时走完整清理退出流程
                cleanup_and_exit_webview()
        else:
            # 未展示WebView时，走默认Kivy返回逻辑
            activity.onBackPressed()
    # 把自定义回调绑定到Activity的返回事件
    activity.onBackPressed = on_back_pressed

# 应用启动时就完成返回键回调绑定
bind_back_pressed_callback()

5. 修正原有UI逻辑的语法bug #

# 启动界面逻辑修正
m = GridLayout(cols=1, rows=1)
d = GridLayout(cols=1, rows=1)
m.add_widget(d)
b = Button(text="打开WebView")
b.bind(on_press=lambda btn: show_webview("https://www.google.com"))
d.add_widget(b)

runTouchApp(m)

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