WebView开源库终极学习方案

最新推荐文章于 2025-03-27 14:28:40 发布

2401_84091289

最新推荐文章于 2025-03-27 14:28:40 发布

阅读量1k

点赞数 30

分类专栏：程序员文章标签：开源学习

本文链接：https://blog.csdn.net/2401_84091289/article/details/138879751

版权

程序员专栏收录该内容

301 篇文章

订阅专栏

03.Js调用Android
04.WebView.loadUrl(url)流程
05.js的调用时机分析
06.清除缓存数据方式有哪些
07.如何使用DeepLink
08.为什么WebView那么难搞
09.如何处理加载错误
10.应用被作为第三方浏览器打开
11.理解WebView独立进程
12.使用外部浏览器下载
13.tel,sms等协议用法
更多内容看wiki

02.如何使用

2.1 如何引入

implementation ‘cn.yc:WebViewLib:1.2.0’

2.2 最简单使用

X5WebUtils.init(this);

<可以使用ProgressWebView
android:id=“@+id/web_view”
android:layout_width=“match_parent”
android:layout_height=“match_parent”
android:scrollbarSize=“3dp” />

//主要是在X5WebViewClient和X5WebChromeClient已经做了很多常见的逻辑处理，如果不满足你使用，可以如下这样写
MyX5WebViewClient webViewClient = new MyX5WebViewClient(webView, this);
webView.setWebViewClient(webViewClient);
MyX5WebChromeClient webChromeClient = new MyX5WebChromeClient(this);
webView.setWebChromeClient(webChromeClient);

private class MyX5WebViewClient extends X5WebViewClient {
public MyX5WebViewClient(BridgeWebView webView, Context context) {
super(webView, context);
}

//重写你需要的方法即可
}

private class MyX5WebChromeClient extends X5WebChromeClient{
public MyX5WebChromeClient(Activity activity) {
super(activity);
}

//重写你需要的方法即可
}

针对类似购物的商品详情页面的webView
当WebView在最顶部或者最底部的时候，不消费事件，则可以使用VerticalWebView

2.3 常用api

mWebView.getX5WebChromeClient().setWebListener(interWebListener);
private InterWebListener interWebListener = new InterWebListener() {
@Override
public void hindProgressBar() {
pb.setVisibility(View.GONE);
}

@Override
public void showErrorView(@X5WebUtils.ErrorType int type) {
//设置自定义异常错误页面
}

@Override
public void startProgress(int newProgress) {
//该方法是是监听进度条进度变化的逻辑
pb.setProgress(newProgress);
}

@Override
public void showTitle(String title) {
//该方法是监听h5中title
}
};

x5WebChromeClient = x5WebView.getX5WebChromeClient();
x5WebChromeClient.setVideoWebListener(new VideoWebListener() {
@Override
public void showVideoFullView() {
//视频全频播放时监听
}

@Override
public void hindVideoFullView() {
//隐藏全频播放，也就是正常播放视频
}

@Override
public void showWebView() {
//显示webView
}

@Override
public void hindWebView() {
//隐藏webView
}
});

//X5WebView中
//设置是否开启密码保存功能，不建议开启，默认已经做了处理，存在盗取密码的危险
mWebView.setSavePassword(false);
//是否开启软硬件加速
mWebView.setOpenLayerType(false);
//获取x5WebChromeClient对象
x5WebChromeClient = mWebView.getX5WebChromeClient();
//获取x5WebViewClient对象
x5WebViewClient = mWebView.getX5WebViewClient();

关于如何使用仿微信加载H5页面进度条
前端页面时受到网路环境，页面内容大小的影响有时候会让用户等待很久。显示一个加载进度条可以说很大程度上提升用户的体验。

private WebProgress pb;
//显示进度条
pb.show();
//设置进度条过度颜色
pb.setColor(Color.BLUE,Color.RED);
//设置单色进度条
pb.setColor(Color.BLUE);
//为单独处理WebView进度条
pb.setWebProgress(newProgress);
//进度完成后消失
pb.hide();

//同步cookie
X5WebUtils.syncCookie(this,“url”,cookieList);
//清除cookie
X5WebUtils.removeCookie(this);

2.4 使用建议

优化一下相关的操作
关于设置js支持的属性

@Override
public void onResume() {
super.onResume();
if (mWebView != null) {
mWebView.getSettings().setJavaScriptEnabled(true);
}
}

@Override
protected void onStop() {
super.onStop();
if (mWebView != null) {
mWebView.getSettings().setJavaScriptEnabled(false);
}
}

关于destroy销毁逻辑

@Override
protected void onDestroy() {
try {
if (webView != null) {
webView.stopLoading();
webView.destroy();
webView = null;
}
} catch (Exception e) {
Log.e(“X5WebViewActivity”, e.getMessage());
}
super.onDestroy();
}

2.5 关于web页面异常状态区分类型

@Override
public void showErrorView(@X5WebUtils.ErrorType int type) {
switch (type){
//没有网络
case X5WebUtils.ErrorMode.NO_NET:
break;
//404，网页无法打开
case X5WebUtils.ErrorMode.STATE_404:
break;
//onReceivedError，请求网络出现error
case X5WebUtils.ErrorMode.RECEIVED_ERROR:
break;
//在加载资源时通知主机应用程序发生SSL错误
case X5WebUtils.ErrorMode.SSL_ERROR:
break;
default:
break;
}
}

2.6 该库流程图

java调用js的流程图
第一步操作：mWebView.callHandler(“functionInJs”, “小杨逗比”, new CallBackFunction() {//这里面是回调});
第二步操作：将handlerName，data，responseCallback，封装到Message对象中，然后开始分发数据，最后webView执行_handleMessageFromNative；
第三步操作：去WebViewJavascriptBridge.js类中找到_handleMessageFromNative方法，js根据"functionInJs"找到对应的js方法并且执行；
第四步操作：js把运行结果保存到message对象中，然后添加到js消息队列中；
第五步操作：在_dispatchMessageFromNative方法中，可以看到，js向native发送 “消息队列中有消息” 的通知；
第六步操作：webView执行js的_fetchQueue（WebViewJavascriptBridge.js类）方法；
第七步操作：js把消息队列中的所有消息都一起回传给webView；
第八步操作：webView收到所有的消息，一个一个串行处理，注意其中包括 "functionInJs"方法运行的结果的消息；
js调用Android的流程图
第一步操作：mWebView.registerHandler(“toPhone”, new BridgeHandler() { //回调});
第二步操作：调用messageHandlers.put(handlerName, handler)，将名称和BridgeHandler对象放到map集合中
第三步操作：在shouldOverrideUrlLoading方法中拦截url，与网页约定好一个协议，匹配则执行相应操作，也就是利用WebViewClient接口回调方法拦截url
第四步操作：如果是url.startsWith(BridgeUtil.YY_RETURN_DATA)则有数据返回；如果是BridgeUtil.YY_OVERRIDE_SCHEMA则刷新消息队列
第五步操作：通过BridgeHandler对象，将data和callBackFunction返回交给开发者

03.js交互操作

3.1 Java调用js的使用方法

代码如下所示，下面updateAttentionStatus代表js这边的方法名称
webView.callHandler(“updateAttentionStatus”, …, new CallBackFunction());这是Java层主动调用Js的”updateAttentionStatus”方法。

mWebView.callHandler(“updateAttentionStatus”, attention, new CallBackFunction() {
@Override
public void onCallBack(String data) {

}
});

3.2 js调用java的使用方法

代码如下所示，下面中的toPhone代表的是Android这边提供给js的方法名称
webView.registerHandler(“toPhone”, …);这是Java层注册了一个叫”toPhone”的接口方法，目的是提供给Js来调用。这个”toPhone”的接口方法的回调就是BridgeHandler.handler()。

mWebView.registerHandler(“toPhone”, new BridgeHandler() {
@Override
public void handler(String data, CallBackFunction function) {
try {
JSONObject jsonData = new JSONObject(data);
String phone = jsonData.optString(“phone”);
//todo 打电话
} catch (JSONException e) {
e.printStackTrace();
}
}
});

//注意，这里回传数据目前只是支持String字符串类型
function.onCallBack(“回调数据”);

3.3 js的调用时机分析

onPageFinished()或者onPageStarted()方法中注入js代码
做过WebView开发，并且需要和js交互，大部分都会认为js在WebViewClient.onPageFinished()方法中注入最合适，此时dom树已经构建完成，页面已经完全展现出来。但如果做过页面加载速度的测试，会发现WebViewClient.onPageFinished()方法通常需要等待很久才会回调（首次加载通常超过3s），这是因为WebView需要加载完一个网页里主文档和所有的资源才会回调这个方法。
能不能在WebViewClient.onPageStarted()中注入呢？答案是不确定。经过测试，有些机型可以，有些机型不行。在WebViewClient.onPageStarted()中注入还有一个致命的问题——这个方法可能会回调多次，会造成js代码的多次注入。
从7.0开始，WebView加载js方式发生了一些小改变，官方建议把js注入的时机放在页面开始加载之后。
WebViewClient.onProgressChanged()方法中注入js代码
WebViewClient.onProgressChanged()这个方法在dom树渲染的过程中会回调多次，每次都会告诉我们当前加载的进度。
在这个方法中，可以给WebView自定义进度条，类似微信加载网页时的那种进度条
如果在此方法中注入js代码，则需要避免重复注入，需要增强逻辑。可以定义一个boolean值变量控制注入时机
那么有人会问，加载到多少才需要处理js注入逻辑呢？
正是因为这个原因，页面的进度加载到80%的时候，实际上dom树已经渲染得差不多了，表明WebView已经解析了标签，这时候注入一定是成功的。在WebViewClient.onProgressChanged()实现js注入有几个需要注意的地方：
1 上文提到的多次注入控制，使用了boolean值变量控制
2 重新加载一个URL之前，需要重置boolean值变量，让重新加载后的页面再次注入js
3 如果做过本地js，css等缓存，则先判断本地是否存在，若存在则加载本地，否则加载网络js
4 注入的进度阈值可以自由定制，理论上10%-100%都是合理的，不过建议使用了75%到90%之间可以。