Android WebView开发问题汇总

在native与网页相结合开发的过程中，难免会遇到关于WebView一些共通的问题。就我目前开发过程中遇到的问题以及最后得到的优化方案都将在这里列举出来。有些是老生常谈，有些则是个人摸索得出解决方法。

1.加快HTML网页装载完成的速度

默认情况html代码下载到WebView后，webkit开始解析网页各个节点，发现有外部样式文件或者外部脚本文件时，会异步发起网络请求下载文件，但如果在这之前也有解析到image节点，那势必也会发起网络请求下载相应的图片。在网络情况较差的情况下，过多的网络请求就会造成带宽紧张，影响到css或js文件加载完成的时间，造成页面空白loading过久。解决的方法就是告诉WebView先不要自动加载图片，等页面finish后再发起图片加载。

故在WebView初始化时设置如下代码：

[java]  view plain  copy

 

1. public void int () {  
2.     if(Build.VERSION.SDK_INT >= 19) {  
3.         webView.getSettings().setLoadsImagesAutomatically(true);  
4.     } else {  
5.         webView.getSettings().setLoadsImagesAutomatically(false);  
6.     }  
7. }  

同时在WebView的WebViewClient实例中的onPageFinished()方法添加如下代码：

[java]  view plain  copy

 

1. @Override  
2. public void onPageFinished(WebView view, String url) {  
3.     if(!webView.getSettings().getLoadsImagesAutomatically()) {  
4.         webView.getSettings().setLoadsImagesAutomatically(true);  
5.     }  
6. }  

从上面的代码，可以看出我们对系统API在19以上的版本作了兼容。因为4.4以上系统在onPageFinished时再恢复图片加载时,如果存在多张图片引用的是相同的src时，会只有一个image标签得到加载，因而对于这样的系统我们就先直接加载。

2.自定义出错界面

当WebView加载页面出错时（一般为404 NOT FOUND），安卓WebView会默认显示一个卖萌的出错界面。但我们怎么能让用户发现原来我使用的是网页应用呢，我们期望的是用户在网页上得到是如原生般应用的体验，那就先要从干掉这个默认出错页面开始。当WebView加载出错时，我们会在WebViewClient实例中的onReceivedError()方法接收到错误，我们就在这里做些手脚：

[java]  view plain  copy

 

1. @Override  
2. public void onReceivedError (WebView view, int errorCode, String description, String failingUrl) {  
3.     super.onReceivedError(view, errorCode, description, failingUrl);  
4.     loadDataWithBaseURL(null, "", "text/html", "utf-8", null);  
5.     mErrorFrame.setVisibility(View.VISIBLE);  
6. }  

从上面可以看出，我们先使用loadDataWithBaseURL清除掉默认错误页内容，再让我们自定义的View得到显示（mErrorFrame为蒙在WebView之上的一个LinearLayout布局，默认为View.GONE）。

3.是否存在滚动条

当我们做类似上拉加载下一页这样的功能的时候，页面初始的时候需要知道当前WebView是否存在纵向滚动条，如果有则不加载下一页，如果没有则加载下一页直到其出现纵向滚动条。首先继承WebView类，在子类添加下面的代码：

[java]  view plain  copy

 

1. public boolean existVerticalScrollbar () {  
2.     return computeVerticalScrollRange() > computeVerticalScrollExtent();  
3. }  

computeVerticalScrollRange得到的是可滑动的最大高度，computeVerticalScrollExtent得到的是滚动把手自身的高，当不存在滚动条时，两者的值是相等的。当有滚动条时前者一定是大于后者的。

4.是否已滚动到页面底部

同样我们在做上拉加载下一页这样的功能时，也需要知道当前页面滚动条所处的状态，如果快到底部，则要发起网络请求数据更新网页。同样继承WebView类，在子类覆盖onScrollChanged方法，具体如下：

[java]  view plain  copy

 

1. @Override  
2. protected void onScrollChanged(int newX, int newY, int oldX, int oldY) {  
3.     super.onScrollChanged(newX, newY, oldX, oldY);  
4.     if (newY != oldY) {  
5.         float contentHeight = getContentHeight() * getScale();  
6.         // 当前内容高度下从未触发过, 浏览器存在滚动条且滑动到将抵底部位置  
7.         if (mCurrContentHeight != contentHeight && newY > 0 && contentHeight <= newY + getHeight() + mThreshold) {  
8.             // TODO Something...  
9.             mCurrContentHeight = contentHeight;  
10.         }  
11.     }  
12. }  

上面mCurrContentHeight用于记录上次触发时的网页高度，用来防止在网页总高度未发生变化而目标区域发生连续滚动时会多次触发TODO，mThreshold是一个阈值，当页面底部距离滚动条底部的高度差<=这个值时会触发TODO。

5.远程网页需访问本地资源

当我们在WebView中加载出从web服务器上拿取的内容时，是无法访问本地资源的，如assets目录下的图片资源，因为这样的行为属于跨域行为（Cross-Domain），而WebView是禁止的。解决这个问题的方案是把html内容先下载到本地，然后使用loadDataWithBaseURL加载html。这样就可以在html中使用 file:///android_asset/xxx.png 的链接来引用包里面assets下的资源了。示例如下：

[java]  view plain  copy

 

1. private void loadWithAccessLocal(final String htmlUrl) {  
2.     new Thread(new Runnable() {  
3.         public void run() {  
4.             try {  
5.                 final String htmlStr = NetService.fetchHtml(htmlUrl);  
6.                 if (htmlStr != null) {  
7.                     TaskExecutor.runTaskOnUiThread(new Runnable() {  
8.                         @Override  
9.                         public void run() {  
10.                             loadDataWithBaseURL(htmlUrl, htmlStr, "text/html", "UTF-8", "");  
11.                         }  
12.                     });  
13.                     return;  
14.                 }  
15.             } catch (Exception e) {  
16.                 Log.e("Exception:" + e.getMessage());  
17.             }  
18.             TaskExecutor.runTaskOnUiThread(new Runnable() {  
19.                 @Override  
20.                 public void run() {  
21.                     onPageLoadedError(-1, "fetch html failed");  
22.                 }  
23.             });  
24.         }  
25.     }).start();  
26. }  

上面有几点需要注意：

• 从网络上下载html的过程应放在工作线程中
• html下载成功后渲染出html的步骤应放在UI主线程，不然WebView会报错
• html下载失败则可以使用我们前面讲述的方法来显示自定义错误界面
  
  完整的demo项目代码我已放到：http://yunpan.cn/cgQPvJQxxkCBj （提取码：6712）。

6.ViewPager里非首屏WebView点击事件不响应

如果你的多个WebView是放在ViewPager里一个个加载出来的，那么就会遇到这样的问题。ViewPager首屏WebView的创建是在前台，点击时没有问题；而其他非首屏的WebView是在后台创建，滑动到它后点击页面会出现如下错误日志：

20955-20968/xx.xxx.xxx E/webcoreglue﹕ Should not happen: no rect-based-test nodes found

解决这个问题的办法是继承WebView类，在子类覆盖onTouchEvent方法，填入如下代码：

[java]  view plain  copy

 

1. @Override  
2. public boolean onTouchEvent(MotionEvent ev) {  
3.     if (ev.getAction() == MotionEvent.ACTION_DOWN) {  
4.         onScrollChanged(getScrollX(), getScrollY(), getScrollX(), getScrollY());  
5.     }  
6.     return super.onTouchEvent(ev);  
7. }  

该方法的最先提出在WebView in ViewPager not receive user inputs。

7.WebView硬件加速导致页面渲染闪烁

4.0以上的系统我们开启硬件加速后，WebView渲染页面更加快速，拖动也更加顺滑。但有个副作用就是，当WebView视图被整体遮住一块，然后突然恢复时（比如使用SlideMenu将WebView从侧边滑出来时），这个过渡期会出现白块同时界面闪烁。解决这个问题的方法是在过渡期前将WebView的硬件加速临时关闭，过渡期后再开启，代码如下：

[java]  view plain  copy

 

1. if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {  
2.     webview.setLayerType(View.LAYER_TYPE_SOFTWARE, null);  
3. }  

8.避免addJavaScriptInterface带来的安全问题

使用开源项目Safe Java-JS WebView Bridge可以很好替代addJavaScriptInterface方法，同时增加了异步回调等支持，并且不存在了安全风险。

9.WebView与上层父元素的TouchMove事件冲突

在开发过程中你可能会遇到这样一种情况。端里面使用ViewPager嵌套了多个WebView页面，同时某一个WebView中的页面元素需要响应TouchMove事件。详细解决方案请移步：http://www.pedant.cn/2014/09/23/webview-touch-conflict

10.清理Cache和历史记录

在开发过程中你可能会遇到这样一种情况。端里面使用ViewPager嵌套了多个WebView页面，同时某一个WebView中的页面元素需要响应TouchMove事件。详细解决方案请移步：http://www.pedant.cn/2014/09/23/webview-touch-conflict

[java]  view plain  copy

 

1. webView.clearCache(true);   
2. webView.clearHistory();  

11.WebView Cookies清理

[java]  view plain  copy

 

1. CookieSyncManager.createInstance(this);   
2. CookieSyncManager.getInstance().startSync();   
3. CookieManager.getInstance().removeSessionCookie();   

12.处理WebView中的非超链接请求(如Ajax请求): 

有时候需要加上请求头，但是非超链接的请求，没有办法再shouldOverrinding中拦截并用webView.loadUrl(String url,HashMap headers)方法添加请求头目前用了一个临时的办法解决：
      首先需要在url中加特殊标记/协议, 如在onWebViewResource方法中拦截对应的请求，然后将要添加的请求头，以get形式拼接到url末尾
在shouldInterceptRequest()方法中,可以拦截到所有的网页中资源请求，比如加载JS，图片以及Ajax请求等等
Ex:

[java]  view plain  copy

 

1. @SuppressLint("NewApi")  
2. @Override  
3. public WebResourceResponse shouldInterceptRequest(WebView view,String url) {  
4.     // 非超链接(如Ajax)请求无法直接添加请求头，现拼接到url末尾,这里拼接一个imei作为示例  
5.   
6.     String ajaxUrl = url;  
7.     // 如标识:req=ajax  
8.     if (url.contains("req=ajax")) {  
9.        ajaxUrl += "&imei=" + imei;  
10.     }  
11.   
12.     return super.shouldInterceptRequest(view, ajaxUrl);  
13.   
14. }  

13.WebView页面中播放了音频,退出Activity后音频仍然在播放

需要在Activity的onDestory()中调用

[java]  view plain  copy

 

1. webView.destroy();  

但是直接调用可能会引起如下错误:

[java]  view plain  copy

 

1. 10-10 15:01:11.402: E/ViewRootImpl(7502): sendUserActionEvent() mView == null  
2. 10-10 15:01:26.818: E/webview(7502): java.lang.Throwable: Error: WebView.destroy() called while still attached!  
3. 10-10 15:01:26.818: E/webview(7502):    at android.webkit.WebViewClassic.destroy(WebViewClassic.java:4142)  
4. 10-10 15:01:26.818: E/webview(7502):    at android.webkit.WebView.destroy(WebView.java:707)  
5. 10-10 15:01:26.818: E/webview(7502):    at com.didi.taxi.ui.webview.OperatingWebViewActivity.onDestroy(OperatingWebViewActivity.java:236)  
6. 10-10 15:01:26.818: E/webview(7502):    at android.app.Activity.performDestroy(Activity.java:5543)  
7. 10-10 15:01:26.818: E/webview(7502):    at android.app.Instrumentation.callActivityOnDestroy(Instrumentation.java:1134)  
8. 10-10 15:01:26.818: E/webview(7502):    at android.app.ActivityThread.performDestroyActivity(ActivityThread.java:3619)  
9. 10-10 15:01:26.818: E/webview(7502):    at android.app.ActivityThread.handleDestroyActivity(ActivityThread.java:3654)  
10. 10-10 15:01:26.818: E/webview(7502):    at android.app.ActivityThread.access$1300(ActivityThread.java:159)  
11. 10-10 15:01:26.818: E/webview(7502):    at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1369)  
12. 10-10 15:01:26.818: E/webview(7502):    at android.os.Handler.dispatchMessage(Handler.java:99)  
13. 10-10 15:01:26.818: E/webview(7502):    at android.os.Looper.loop(Looper.java:137)  
14. 10-10 15:01:26.818: E/webview(7502):    at android.app.ActivityThread.main(ActivityThread.java:5419)  
15. 10-10 15:01:26.818: E/webview(7502):    at java.lang.reflect.Method.invokeNative(Native Method)  
16. 10-10 15:01:26.818: E/webview(7502):    at java.lang.reflect.Method.invoke(Method.java:525)  
17. 10-10 15:01:26.818: E/webview(7502):    at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:1187)  
18. 10-10 15:01:26.818: E/webview(7502):    at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1003)  
19. 10-10 15:01:26.818: E/webview(7502):    at dalvik.system.NativeStart.main(Native Method)  

如上所示，webview调用destory时，webview仍绑定在Activity上。这是由于自定义webview构建时传入了该Activity的context对象，因此需要先从父容器中移除webview，然后再销毁webview：

[java]  view plain  copy

 

1. rootLayout.removeView(webView);  
2. webView.destroy();  

14.WebView长按自定义菜单,实现复制分享相关功能

这个功能首先可以从两方面完成：

  (1) 在js中完成：

    处理Android.selection.longTouch

这里推荐一个开源项目进行参考,：

https://github.com/btate/BTAndroidWebViewSelection

   (2) android层处理:

     首先使用OnTouchListener实现长按实现监听，然后实现WebView的Context menu，最后调用webview中的emulateShiftHeld()，为了适配安卓不同版本，最好使用反射方式调用。