跨平台应用开发进阶(五十)uni-app ios web-view嵌套H5项目白屏问题分析及解决

文章目录

一、前言

应用

uni-app

框架开发好APP上架使用过程中，发现应用经过长时间由后台切换至前台时，通过

webview

方式嵌套的H5页面发生白屏现象。

二、问题分析

任何手机设备上，当手机内存不足时，os都会回收资源。一般是先回收后台打开的资源。如果当前应用占用的资源过高，当前应用也有可能崩溃。尤其是在调用摄像头点击拍照时，手机内存占用会达到一个峰值，此时较容易出问题。

在iOS上，当内存不足时，根据

uiwebview

和

wkwebview

的不同，它自身有不同的回收策略。

如果是

uiwebview

的app（常见于5+app），内存不足时整个app会崩溃，即闪退。

如果是

wkwebview

的app（uni-app和wap2app在iOS上默认就是

wkwebview

），内存不足时，单个

wkwebview

会崩溃。也就是所谓的应用还在，而页面白屏。

这个问题在所有使用

wkwebview

的应用都会出现，比如微信的公众号网页里也存在。在微信小程序里，它做了一个自动恢复手段，可以让

jscore

存储数据状态，崩溃的

wkwebview

自动恢复。所以在遇到问题时，会白一下然后恢复渲染。

三、解决方案

uni-app因为引入了独立的jscore处理数据状态，jscore不会崩溃，所以官方采用了和微信小程序一致的策略，补充自动的白屏恢复能力。亲测使用 HBuilder 3.6.4.20220922 并无白屏自动恢复功能，怀疑是HBuilder版本问题！
uni-app中也可以使用nvue来避免这个问题，nvue页面不会出现内存不足引发的白屏崩溃。

3.1 nvue 页面替代 vue 页面

nvue

文件

webview

使用方式如下：

//nvue 中的webview需要自行设置宽高否则无法展示<template><view><web-view ref="webview" src="/hybrid/html/local.html" style="width: 500px;height: 600px;" @onPostMessage="getMessage"></web-view></view></template><script>exportdefault{data(){return{}},onLoad(){setTimeout(()=>{this.handlePostMessage('测试传参')},200)},methods:{handlePostMessage(res){this.$refs.webview.evalJs(`handleMessage()`);},getMessage(e){
                uni.showModal({content:JSON.stringify(e.detail),showCancel:false})}}}</script>

h5页面内容如下：

<!DOCTYPE html><html><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"><title>本地网页</title><style type="text/css">.btn {display: block;margin: 20px auto;padding: 5px;
                background-color: #007aff;border:0;color: #ffffff;height: 40px;width: 200px;}.btn-red {
                background-color: #dd524d;}.btn-yellow {
                background-color: #f0ad4e;}.desc {padding: 10px;color: #999999;}</style></head><body><p class="desc">web-view 组件加载本地 html 示例，仅在 App 环境下生效。点击下列按钮，跳转至其它页面。</p><div class="btn-list"><button class="btn" type="button" data-action="navigateTo">navigateTo</button><button class="btn" type="button" data-action="redirectTo">redirectTo</button><button class="btn" type="button" data-action="navigateBack">navigateBack</button><button class="btn" type="button" data-action="reLaunch">reLaunch</button><button class="btn" type="button" data-action="switchTab">switchTab</button></div><p class="desc" id="lizhao">网页向应用发送消息。注意：小程序端应用会在此页面后退时接收到消息。</p><div class="btn-list"><button class="btn btn-red" type="button" id="postMessage">postMessage</button></div><!-- uni 的 SDK--><script type="text/javascript" src="https://unpkg.com/@dcloudio/[email protected]/index.js"></script><script type="text/javascript">
            
            window.handleMessage=function(data){alert('传来的参数'+data)}    
            document.addEventListener('UniAppJSBridgeReady',function(){
                
                document.querySelector('.btn-list').addEventListener('click',function(evt){var target = evt.target;if(target.tagName ==='BUTTON'){var action = target.getAttribute('data-action');switch(action){case'switchTab':
                                uni.switchTab({url:'/pages/tabBar/API/API'});break;case'reLaunch':
                                uni.reLaunch({url:'/pages/tabBar/API/API'});break;case'navigateBack':
                                uni.navigateBack({delta:1});break;default:
                                uni[action]({url:'/pages/component/button/button'});break;}}});
                document.querySelector("#postMessage").addEventListener('click',function(){
                    uni.postMessage({data:{action:'message888888'}});})});</script></body></html>

注意⚠️：

uni-app

中的

nvue

页面问题

nvue

页面不使用

webview

渲染，但其中的

web-view

组件说明如下：

nvue的weex 组件模式： weex模式下的web-view组件是weex自己实现的，它目前仍然使用UIWebview。官方会追踪weex的升级。
nvue的uni-app组件模式： web-view组件使用WKWebview，不可修改为uiWebview。

3.2 白屏检测刷新

3.2.1 自动刷新

需要一个全局挂载的工具类，Vue.prototype.$utils = utils
在需要使用的页面（一般为tab页）最外层需要设置为同一个class名称；
在onshow方法调用；

let pageList ={};const utils ={reloadCurrentPage:function(_self, isTab =true){// #ifdef APP-PLUS// 获取当前路由及传参，以备页面刷新之用var route = _self.$scope.route;var data = _self.$scope.options && _self.$scope.options.data;var url ='/'+ route;if(data){
            url ='/'+ route +'?data='+ data;}var isRecovery =true;// 页面刷新标识let newTime = Date.now();if(pageList[url]){const query = uni.createSelectorQuery().in(_self);//这里select()中替换为自己的样式class名称
            query.select('.container').fields({size:true},data=>{
                isRecovery =false;// 重置页面刷新标识}).exec();setTimeout(()=>{// 页面白屏，需触发刷新机制if(isRecovery){//如果获取不到节点//确保只刷新一次if(newTime - pageList[url]>3000){//超过3秒才重新刷新，这里设置几秒就行，目的是防止无限刷新//因为刷新后页面肯定会出来，但是立马再次调用该方法不一定能获取节点（DOM树未必构建完毕）
                        pageList[url]= newTime;// 若为tab标签栏位if(isTab){
                            uni.reLaunch({
                                url
                            })}else{// 若为页面
                            uni.redirectTo({
                                url
                            })}}}},600)}else{// 页面正常，记录当前时间
            pageList[url]= newTime;}// if (plus.os.name === 'iOS') {// }// #endif}}

3.2.2 手动刷新

webview

页面提供按钮以支持用户手动刷新，

在这里插入图片描述
手动刷新实现逻辑如下：

手动刷新按钮在检测到白屏事件发生时显示：

query.select('.container').fields({size:true},data=>{
     isShow =true;// 展示刷新按钮}).exec();

应用3.2.1小节提供的刷新方法，当点击刷新按钮调用刷新方式。

3.3 总结

在前端减少内存使用，最重要的就是图片渲染，尤其是大图片。

在页面上不要渲染多张大图，比如从摄像头或相册选择多张图，并缩放尺寸渲染在页面上，虽然肉眼看起来手机屏幕上是几张小图，但实际上是多张大图只是被缩小，这种情况非常耗费内存。一张图片3m，9张这样的大图同时渲染到屏幕上，什么手机都受不了。

一个缩略图控制在几k或十几k，才是合理的。

详情页面展现多张大图并不受影响。如果图片滚动在屏幕外，os内存不足时也会自动收回这些屏幕外图片占用的渲染资源，最吃资源的就是同屏渲染多张大图。

四、拓展阅读

《uni-app中Webview的使用注意》
《uni-app SelectorQuery》

标签：前端 uni-app ios

本文转载自: https://blog.csdn.net/sunhuaqiang1/article/details/128390980
版权归原作者 No Silver Bullet 所有，如有侵权，请联系我们删除。

跨平台应用开发进阶(五十)uni-app ios web-view嵌套H5项目白屏问题分析及解决

文章目录

一、前言

二、问题分析

三、解决方案

3.1 nvue 页面替代 vue 页面

3.2 白屏检测刷新

3.2.1 自动刷新

3.2.2 手动刷新

3.3 总结

四、拓展阅读

发表评论

“跨平台应用开发进阶(五十)uni-app ios web-view嵌套H5项目白屏问题分析及解决”的评论:

关于作者

overfit同步小助手

相关阅读

文章导航