SuperAPI AI 工具集

webview-footguns

编程与开发

查看项目

更新于 10-17 16:16

技能介绍

WebView footguns 是一个面向 Kotlin 与 Compose Multiplatform 应用开发的技能资料集,内容来自生产环境中实际遇到的 WebView 问题,共收录 3 个陷阱,每个陷阱单独放在 references/ 目录下的一个短文件中,长度不超过 150 行。

用途与组织方式

每个陷阱文件都包含三部分:可用的实现模式、Trap(该问题在实践中的具体失败方式及原因)、以及 Verifying it 部分(一组可针对用户自己的代码树运行的命令)。使用该技能时,应把即将编写的代码或正在排查的症状与条目进行匹配;每个条目都标明了主题以及应当查阅它的症状。在提出代码或修复建议之前,应先用 Read 工具阅读所有可能适用的文件。如果 Verifying 命令中出现的是源项目路径,需要替换为用户代码树中的等价路径。如果文件中出现了一个未在此处列出的、用反引号标注的陷阱名称,则该陷阱位于同级的其他领域技能中,可以通过 glob ../*/references/<name>.md 打开。

低内存手机上的启动问题

webview-startup-off-the-main-thread 条目针对这样一个问题:进程中的第一个 WebView,或者对几乎任何 android.webkit API 的首次调用,都会在调用线程上承担 WebView 的启动开销;即使是 cookie store,在返回之前也会加载 provider 及其原生库。在已经内存紧张的 3–4 GB 手机上,这会导致 UI 阻塞数秒,最终引发 ANR 或者被系统杀死。该条目涵盖:如何用占位符配合后台执行器来启动 WebView;库本身未做防护的那个执行器;在启动控制生效之前发出的 cookie 调用;以及在上述处理完成之后,仍然会在主线程上运行的内容。该陷阱仅适用于 Android。如果某个承载 WebView 的界面在低端手机上打开时卡住数秒、ANR 堆栈在 WebView 构造函数内结束,或者应用在进入网页登录界面时死掉而开发手机无法复现,就应查阅该条目。

渲染进程被杀导致应用崩溃

webview-renderer-gone-takes-the-app 针对这样一种情况:系统为了回收内存而杀死 WebView 的渲染进程时,如果 WebView 的客户端没有处理 renderer-gone 回调,整个应用也会随之被杀死或崩溃。由于崩溃来自原生代码,所以不会抛出 Kotlin 异常;如果崩溃报告器只挂接 JVM,就不会记录到这类崩溃;在低内存场景下更是什么都不会记录,用户只会看到应用消失。该条目涵盖:为应用创建的每个客户端都从回调返回 true;为什么应当替换已经失效的实例,而不是重新加载它;用 Retry 构建一个新实例;以及如何故意杀死渲染进程来进行测试。该陷阱仅适用于 Android。如果低内存手机上的用户报告应用从某个网页界面消失、而崩溃面板为空,系统把该应用与其他应用一起强制关闭,或者应用从后台返回后网页界面变空白,就应查阅该条目。

在 Compose 中承载 WebView

webview-in-androidview-lifecycle 指出,把 WebView 承载在 Compose 的 AndroidView 中时,仅靠一个简单的工厂函数无法提供以下四项内容:在设备没有可用 WebView provider、构造函数抛出异常时的回退方案;在离开组合时显式调用 destroy;对自身 setup 抛出异常的 WebView 也调用 destroy;以及将副作用绑定到“这次访问”,而不是绑定到视图,因为视图可能会被重建。该条目还涉及 cookie store 的阻塞式 flush,以及即使 store 中有 cookie 其 getter 仍返回 null 的情况。该陷阱仅适用于 Android。如果在手表或 WebView provider 加载失败的手机上打开网页界面会导致应用崩溃;离开网页界面后内存仍然很高;Retry 后用户被登出;ANR 堆栈在 cookie store 的 flush 中结束;或者读取 cookie 时因空指针错误而崩溃,即调试构建中 getCookie(...) 不应为 null,而压缩后的发布构建中会出现对 null 对象引用调用 Object.getClass() 的错误,就应查阅该条目。