7-2.【WebView】WebView 在 Stage 模型下的生命周期如何管理？onBackground 时 WebView 会暂停吗？多窗口场景如何处理？

在 HarmonyOS 的 Stage 模型下，Web 组件的生命周期管理与 UIAbility 以及页面（Page）的生命周期紧密耦合。理解这一关系对于优化应用能耗和性能至关重要。

1. WebView 在 Stage 模型下的生命周期管理

Web 组件的生命周期主要受两个层面的约束：页面生命周期（Page Lifecycle）和 Ability 生命周期（Ability Lifecycle）。

• 创建与初始化：通常在页面的 aboutToAppear 或 onPageShow 中，通过 WebviewController 进行控制器的绑定。建议在 onPageShow 确保 UI 结构已稳定后再加载复杂 URL。
• 销毁：当页面被销毁（aboutToDisappear）或应用退出时，系统会自动回收渲染进程（Render Process）。但为了保险，建议在 aboutToDisappear 中调用 this.controller.loadUrl('about:blank') 以快速释放当前页面的内存。

2. onBackground 时 WebView 会暂停吗？

结论：默认不会完全“杀掉”进程，但系统会对其进行“资源冻结”优化。

当 UIAbility 进入 onBackground（例如用户切回桌面或切换到其他应用）时：

• 渲染挂起：为了省电，WebView 的 GPU 渲染 会立即停止。

• JS 引擎行为：默认情况下，JavaScript 可能会继续运行一小段时间（如处理未完成的 Promise），但 HarmonyOS 的内核调度器会显著降低后台渲染进程的 CPU 优先级。

• 主动暂停建议：为了极致的性能和电池寿命，开发者应主动干预：

  • 在 Ability 的 onBackground 或页面的 onPageHide 中调用：this.controller.onInactive()。这会通知 Web 引擎暂停定时器、动画和音视频播放。
  • 在回前台（onForeground / onPageShow）时调用：this.controller.onActive() 恢复运行。

3. 多窗口场景（分屏/悬浮窗）如何处理？

HarmonyOS 支持多窗口模式，这对 WebView 提出了动态适配的要求：

• Viewport 自动重绘：当用户拖动分屏窗口改变大小时，WebView 会收到 resize 事件。由于渲染进程与主进程分离，WebView 会自动调整内部的 viewport 并触发 CSS 媒体查询（Media Queries）重新布局。
• 焦点管理：在多窗口下，只有获得焦点的窗口（Active Window）中的 WebView 会保持高频率刷新。失去焦点但仍可见的窗口，其 Web 内容可能被降频渲染以节省系统资源。
• 状态保存：如果系统因为内存极度紧张而销毁了某个分屏窗口的进程，当用户切回该窗口时，系统会尝试触发 onWindowStageRestore。开发者应利用 WebviewController.storeWebArchive 或保存当前 URL，在恢复时重新加载。

4. 最佳实践清单

场景	推荐操作	目的
应用切后台	controller.onInactive()	停止 JS 定时器、动画，极度节能。
应用回前台	controller.onActive()	恢复页面交互。
窗口大小改变	无需手动处理（内核自适配）	确保 H5 响应式布局生效。
多实例启动	预热 prepareRenderContext()	缩短第二个窗口 Web 加载的白屏时间。
音频播放	监听 onBackground 停止 Media	防止应用在后台“偷跑”声音（除非是音乐类网页）。

架构师提示：

在多窗口场景下，要注意 LocalStorage 和 Cookie 的同步。由于不同窗口可能运行在不同的渲染进程中，但共享同一套磁盘缓存，确保在更新敏感状态后触发同步，避免数据不一致。