DCloud_IOS_XTY
DCloud_IOS_XTY
  • 发布:2019-11-01 18:23
  • 更新:2024-04-26 18:22
  • 阅读:14676

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重新创建完成后会触发该事件,可以监听该事件做具体处理
引用文档

4 关注 分享
DCloud_iOS_XHY 3***@qq.com 穷鬼溪风 rysnone

要回复文章请先登录注册

祈愿稻荷神

祈愿稻荷神

回复 祈愿稻荷神 :
但是很麻烦,有时候页面正常也获取不到高度(怀疑渲染慢,加个延迟减少复现)
但是他有时候白屏也能获取到 高度,这个我没办法了,目前就这样了,然后准备后面转原生了.
2024-04-26 18:22
祈愿稻荷神

祈愿稻荷神

回复 4***@qq.com :
没有找到uniapp 相关很好的解决方案

目前是在页面定义个元素设置高度宽度,
因为jsCore不会崩溃 所以页面的onShow还是能执行的,
然后在onShow 第二次+ 的时候尝试获取 dom 元素的高度[用 uni.createSelectorQuery()] ,
如果没有拿到高度我则判定页面已经白屏然后重新刷新当前页面
2024-04-26 18:19
4***@qq.com

4***@qq.com

回复 刘超群 :
2024年了都没解决
2024-04-26 09:19
4***@qq.com

4***@qq.com

回复 yangyuanlife :
对啊,找到解决方案了吗
2024-04-26 09:18
4***@qq.com

4***@qq.com

回复 祈愿稻荷神 :
确实啊,找到解决方案了吗
2024-04-26 09:17
祈愿稻荷神

祈愿稻荷神

回复 祈愿稻荷神 :
不好意思,搞错了,我还以为uniapp 也支持。
2024-04-12 11:29
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