DCloud_IOS_XTY
DCloud_IOS_XTY
  • 发布:2019-11-01 18:23
  • 更新:2024-11-14 15:08
  • 阅读:16319

iOS平台5+APP/WAP2APP使用WKWebview内核时由于内核崩溃引起白屏后自动恢复的方法

分类:HTML5+
h5+

HBuilderX 2.3.4+版本已将iOS上所有webview的默认内核由UIWebview调整为WKWebview请参考https://ask.dcloud.net.cn/article/36348,
当内存占用过大或者应用切换到后台内存被回收会导致WKWebview内核Crash引起应用白屏,为了提高体验App支持Crash后的恢复,开发者可以通过简单的配置支持该功能。

注意

目前该功能针对在前台的应用,如果应用在后台时会直接重新启动不适用该规则

注意uniapp在使用vue页面时,有自带的恢复逻辑,不适用本规则。如果是nvue页面则不涉及这个问题。

支持的恢复行为

  • "restart"
    重启应用,关闭所有页面重新打开应用首页,可通过(plus.runtime.isRecovery)来判断应用是否恢复重启
  • "reload"
    重新加载当前WKWebview(崩溃的WKWebview)页面,页面中JS上下文中所有数据丢失,在当前Webview中可通过plus.webview.isRecovery判断是否恢复重新加载,在其它Webview中可监听recovery事件来判断
  • "none"
    不做任何操作

全局配置

manifest.json中配置默认值

    "plus": {  //uni-app项目对应节点名称为"app-plus"  
        "kernel": {  
            "ios": "WKWebview",  
            "recovery": "restart|reload|none"  
        },  
        // ...  
    }

webview配置

webview style新增kernelRecovery属性
通过该项可以自定义单个webview的恢复行为,覆盖全局配置
引用文档

示例
var webview = plus.webview.create("[url]","[id]", {kernelRecovery:"restart|reload|none"});

API

plus.webview.isRecovery
用于判断当前Webview窗口是否由于内核崩溃自动恢复,当配置reload时生效
引用文档

plus.runtime.isRecovery
用于判断当前应用是否是Webview崩溃自动恢复导致的启动,当配置restart时生效
引用文档

事件

recovery
当恢复行为配置为reload时,webview重新创建完成后会触发该事件,可以监听该事件做具体处理
引用文档

评论区各位开发者吐槽较多,但这个不是DCloud不解决,是iOS不解决。
如果使用webview渲染,内存过高时,只能重启webview。

  1. 降低webview里的内存占用
  2. 改用nvue或uvue原生渲染。但nvue由于weex不维护了也有坑,使用uni-app x的uvue比较好。
  3. 接受重启webview,优化重启过程的体验
4 关注 分享
DCloud_iOS_XHY 3***@qq.com 穷鬼溪风 rysnone

要回复文章请先登录注册

DCloud_heavensoft

DCloud_heavensoft

回复 祈愿稻荷神 :
都啥年代了,还在用5+ app和wap2app吗?这块已经不维护了。现在都是uni-app x的年代了
2024-04-12 02:21
祈愿稻荷神

祈愿稻荷神

即使设置了重新打包了,iOS后台一会儿 回来依旧是白屏,还是不会重启或者自己恢复。用户体验真的非常差,丢失客户。
2024-04-11 21:30
yangyuanlife

yangyuanlife

拍照重新页面重新加载要怎么恢复拍摄的照片呀
2024-01-31 12:29
1***@qq.com

1***@qq.com

uniapp 项目vue页面 ios 息屏进入后台过一阵进入前台还是会白屏崩溃啊 加了"kernel": {
"ios": "WKWebview",
"recovery": "restart|reload|none"
}, 无效果啊
2023-12-04 14:54
veichi

veichi

回复 刘超群 :
2023 8月还是没解决 弃坑吧
2023-08-07 12:26
veichi

veichi

配置 "recovery": "restart|reload|none" 根本没用 还是照样崩
2023-08-07 12:26
加勒比路飞

加勒比路飞

plus.runtime.isRecovery 为何返回的是undefined
2023-04-06 17:16
正能量10086

正能量10086

我的在ios上面切换后台再回来,布局会乱,整体尺寸变小,横屏应用,版本3.6.4.20220922
2022-11-28 13:56
刘超群

刘超群

都两年了还没解决?这个问题该怎么解决啊,坑太多了
2022-11-24 11:50
碎叶城

碎叶城

回复 t***@ledreamer.com :
请问解决了吗?
2022-11-09 18:15