Jetpack Compose 中 AndroidView 的生命周期管理与 WebView 实践

在 Jetpack Compose 体系中，AndroidView 是在声明式 UI 中嵌入传统原生 View 的唯一桥梁。由于 WebView 具有内存消耗大、生命周期复杂以及依赖配置变更（如旋转屏幕）等特性，理解 AndroidView 的回调机制是实现高性能混合页面的关键。

一、 AndroidView 核心回调解析

AndroidView 提供了三个关键回调：factory、update 和 onRelease。

1. factory (View 创建)

仅在 AndroidView 首次进入组合（Composition）时执行一次。此块用于执行 View 的初始化逻辑，如设置 WebViewClient 或开启 JavaScript。

2. update (数据同步)

当 Composable 发生重组且依赖的状态（State）改变时，此回调会反复触发。其职责是将 Compose 的状态同步给原生 View。

3. onRelease (资源清理)

当 AndroidView 从 UI 树中移除并彻底销毁时调用。这是执行 webView.destroy() 的核心时机，用于防止内存泄漏。

---

二、 场景实践：高性能 WebView 组件封装

下方案例展示了如何结合返回键处理、生命周期观察以及状态防抖来实现一个健壮的 WebView。

Kotlin

@Composable
fun RobustWebView(
    url: String,
    modifier: Modifier = Modifier
) {
    val context = LocalContext.current
    val lifecycleOwner = LocalLifecycleOwner.current

    // 提升 View 实例，以便在 AndroidView 外部（如 BackHandler）引用
    val webView = remember(context) {
        WebView(context).apply {
            settings.javaScriptEnabled = true
            webViewClient = WebViewClient()
        }
    }

    // 处理系统返回键：若网页可后退，则拦截物理返回键
    BackHandler(enabled = webView.canGoBack()) {
        webView.goBack()
    }

    // 绑定系统生命周期：App 切入后台时暂停 WebView 渲染以节省能耗
    DisposableEffect(lifecycleOwner) {
        val observer = LifecycleEventObserver { _, event ->
            when (event) {
                Lifecycle.Event.ON_RESUME -> webView.onResume()
                Lifecycle.Event.ON_PAUSE -> webView.onPause()
                else -> {}
            }
        }
        lifecycleOwner.lifecycle.addObserver(observer)
        onDispose {
            lifecycleOwner.lifecycle.removeObserver(observer)
        }
    }

    AndroidView(
        modifier = modifier,
        factory = { webView },
        update = { view ->
            // 防抖判断：避免重组导致网页重复加载
            if (view.url != url) {
                view.loadUrl(url)
            }
        },
        onRelease = { view ->
            // 彻底释放内存，停止后台音视频播放
            view.stopLoading()
            view.loadUrl("about:blank")
            view.destroy()
        }
    )
}

---

三、 配置变更与 onRelease 的深度关联

在 Android 系统中，屏幕旋转默认会触发 Activity 的销毁与重建。

1. 默认行为

若不进行特殊处理，屏幕旋转会导致 AndroidView 离开组合树并触发 onRelease。随后在新的 Activity 中，factory 会重新创建 WebView 实例。这将导致网页进度丢失、视频播放中断以及白屏重载。

2. 禁止重建方案

在 AndroidManifest.xml 中配置 android:configChanges="orientation|screenSize" 可阻止 Activity 重建。在此模式下，旋转屏幕仅触发布局重新测量，不会触发 onRelease，从而保持 WebView 的运行状态。

3. 条件布局中的 onRelease 陷阱

在复杂的"视频+列表"场景中，若采用如下逻辑切换布局：

• 竖屏：显示 WebView。
• 横屏：仅显示全屏视频。

当切换至横屏时，由于 WebView 在 if/else 分支中消失，即使 Activity 不重建，AndroidView 也会因为从 UI 树中被移除而触发 onRelease。

规避策略：

若需保留 WebView 状态，应避免使用 if/else 彻底移除组件。建议通过 Modifier.alpha(0f) 或 Modifier.offset 将其移出可视区域。只要组件仍在 UI 树中，onRelease 就不会执行。

---

四、onRelease 与 onDispose 的区别

特性	onRelease (AndroidView 参数)	onDispose (DisposableEffect 回调)
操作对象	直接操作原生 View 实例	管理副作用（如监听器、观察者）
触发点	View 被从视图结构中拆卸时	Composable 离开组合或 Key 变化时
核心用途	调用 view.destroy() 等物理销毁动作	调用 removeObserver() 等逻辑清理动作

在开发涉及视频、网页、地图等重资源组件时，应优先在 onRelease 中处理 View 本身的销毁，在 onDispose 中处理外部资源（如传感器、生命周期监听）的解绑。

---

五、 进阶：配置变更下的状态持久化

尽管通过 configChanges 禁止 Activity 重建是首选方案，但在某些系统强制回收内存或必须重建 Activity 的场景下，需要利用 saveState 和 restoreState 来保持用户的浏览进度。

1. 自动状态保持

WebView 提供了内置的序列化方法，可以将当前的浏览历史、缩放等级等信息保存至 Bundle 中。在 Compose 中，可以配合 rememberSaveable 实现跨 Activity 重建的状态管理。

Kotlin

@Composable
fun PersistentWebView(url: String) {
    // 使用 rememberSaveable 跨越 Activity 重建持久化 Bundle
    val webViewStateBundle = rememberSaveable { Bundle() }

    AndroidView(
        factory = { context ->
            WebView(context).apply {
                settings.javaScriptEnabled = true
                webViewClient = WebViewClient()
                
                // 若 Bundle 内存有数据，则恢复历史记录而非重新加载 URL
                if (!webViewStateBundle.isEmpty) {
                    this.restoreState(webViewStateBundle)
                }
            }
        },
        update = { view ->
            // 仅在初次加载且无缓存状态时执行 loadUrl
            if (view.url == null && webViewStateBundle.isEmpty) {
                view.loadUrl(url)
            }
        },
        onRelease = { view ->
            // 在 View 销毁前，将其当前状态存入 Bundle
            view.saveState(webViewStateBundle)
            view.destroy()
        }
    )
}

---

六、 复杂场景：视频与 WebView 的共存策略

在"上半部分视频、下半部分网页"的布局中，若横屏时需要将视频全屏并隐藏网页，必须精确控制 AndroidView 的存续状态。

1. 避免使用条件渲染 (if/else)

在 Compose 中，if (isLandscape) { FullScreenVideo() } else { VideoWithWeb() } 会导致 AndroidView 频繁触发 onRelease 和 factory。

优化方案：

• 共享 View 实例 ：将视频组件的 AndroidView 放在 if 语句之外，仅通过 Modifier 动态调整其宽高。
• 逻辑保留 WebView ：对于需要暂时隐藏的 WebView，应使用 Modifier.size(0.dp) 或 Modifier.graphicsLayer { alpha = 0f }。这种做法能确保 AndroidView 始终保持在 Composition 树中，从而规避 onRelease 的调用，实现瞬时切回的效果。

2. 内存与性能的权衡

虽然通过 Modifier 隐藏 View 可以保留状态，但 WebView 在后台仍可能消耗 CPU。建议在隐藏期间，配合 onPause() 方法停止 JS 运行，在重新显示时调用 onResume()。

---

七、 最佳实践清单

为确保 AndroidView 与 WebView 的集成达到生产环境标准，建议遵循以下清单：

1. 显式销毁 ：务必在 onRelease 中调用 destroy()，这是规避内存泄漏的最底层保障。
2. JS 安全性 ：除非必要，否则应审慎开启 javaScriptEnabled。若开启，需在 onRelease 时将其重置为 false。
3. URL 防抖 ：在 update 回调中，必须对比 view.url 与目标 url，严禁无条件调用 loadUrl()。
4. 返回键闭环 ：结合 BackHandler 提供符合用户直觉的网页后退体验。
5. 生命周期联动 ：使用 DisposableEffect 监听 LifecycleOwner，确保 WebView 的活跃状态与 App 前后台状态同步。