Android学习之 WebView使用小结

这段时间基于项目需要 在开发中与WebView的接触比较多，前段时间关于HTML5规范尘埃落定的消息出现在各大IT社区头版上，更有人说：HTML5将颠覆原生App开发 虽然我不太认同这一点 但是关于HTML5+JS+CSS+Native的跨平台开发模式还是为很多企业节省了开发资源和成本、一定程度上提升了WebView的使用率和地位。

网上关于HTML5规范定稿的一篇见解文章：

http://www.csdn.net/article/2014-11-06/2822513-how-html5-changes

本篇主要基于这段时间对WebView的使用经验和网上学习到的对WebView开发做一个要点小结：

一、WebView基于webkit引擎展现web页面的控件，使用前需要在Android Manifest file中配置internet访问权限，否则提示页面无法访问。

 

[html]  view plain copy

1. <</span>manifest ... >  
2.     <</span>uses-permission android:name="android.permission.INTERNET" />  
3.     ...  
4. </</span>manifest>  

二、WebView属性的设置
  1、设置WebSettings类
     WebSettings用来对WebView的配置进行配置和管理，比如是否可以进行文件操作、缓存的设置、页面是否支持放大和缩小、是否允许使用数据库api、字体及文字编码设置、是否允许js脚本运行、是否允许图片自动加载、是否允许数据及密码保存等等
     示例代码如下：

 

[java]  view plain copy

1. WebSettings webSettings = mWebView.getSettings();  
2. webSettings.setJavaScriptEnabled(true);  
3. webSettings.setCacheMode(WebSettings.LOAD_DEFAULT);   
4. webSettings.setDomStorageEnabled(true);    
5. webSettings.setDatabaseEnabled(true);  
6. webSettings.setAppCacheEnabled(true);   
7. webSettings.setAllowFileAccess(true);  
8. webSettings.setSavePassword(true);  
9. webSettings.setSupportZoom(true);  
10. webSettings.setBuiltInZoomControls(true);   
11.    
12. webSettings.setLayoutAlgorithm(WebSettings.LayoutAlgorithm.NARROW_COLUMNS);  
13. webSettings.setUseWideViewPort(true);   
14.   
15. mWebView.setScrollBarStyle(WebView.SCROLLBARS_OUTSIDE_OVERLAY);  
16. mWebView.setHorizontalScrollbarOverlay(true);  
17. mWebView.setHorizontalScrollBarEnabled(true);  
18. mWebView.requestFocus();   

  2、设置WebChromeClient子类
      WebChromeClient会在一些影响浏览器ui交互动作发生时被调用，比如WebView关闭和隐藏、页面加载进展、js确认框和警告框、js加载前、js操作超时、webView获得焦点等等

 

[java]  view plain copy

1. mWebView.setWebChromeClient(new MyWebChromeClient());  

3、设置WebViewClient子类
     WebViewClient会在一些影响内容渲染的动作发生时被调用，比如表单的错误提交需要重新提交、页面开始加载及加载完成、资源加载中、接收到https认证需要处理、页面键盘响应、页面中的url打开处理等等

 

 

[java]  view plain copy

1. mWebView.setWebViewClient(new MyWebViewClient());  

4、设置addJavascriptInterface方法
     使Js调用Native本地Java对象,实现本地Java代码和HTML页面进行交互，
     注意:因为安全问题的考虑 Google在使用Android API 17以上的版本的时候 需要通过@JavascriptInterface来注解的Java函数才能被识别可以被Js调用。

 

三、设置当前网页的链接仍在WebView中跳转，而不是跳到手机浏览器里显示，
       在WebViewClient的子类中重写shouldOverrideUrlLoading函数  代码如下：

 

[java]  view plain copy

1. webView.setWebViewClient(new WebViewClient() {    
2.     
3.     @Override    
4.     public boolean shouldOverrideUrlLoading(WebView view, String url) {    
5.         view.loadUrl(url);    
6.         return true;    
7.     }    
8. });   

shouldOverrideUrlLoading表示当前webView中的一个新url需要加载时，给当前应用程序一个处理机会，如果没有重写此函数，webView请求ActivityManage选择合适的方式处理请求，就像弹出uc和互联网让用户选择浏览器一样。重写后return true表示让当前程序处理，return false表示让当前webView处理

四、设置开始加载网页、加载完成、加载错误时处理
   在WebViewClient子类中分别重写如下父类函数  代码如下：

 

[java]  view plain copy

1. webView.setWebViewClient(new WebViewClient() {    
2.     
3.     @Override  
4.     public void onPageStarted(WebView view, String url, Bitmap favicon) {  
5.         super.onPageStarted(view, url, favicon);  
6.         // 开始加载网页时处理 如：显示"加载提示" 的加载对话框  
7.         DialogManager.showLoadingDialog(this);  
8.     }  
9.   
10.     @Override  
11.     public void onPageFinished(WebView view, String url) {  
12.         super.onPageFinished(view, url);  
13.         // 网页加载完成时处理  如：让 加载对话框 消失  
14.         DialogManager.dismissLoadingDialog();  
15.     }  
16.   
17.     @Override  
18.     public void onReceivedError(WebView view, int errorCode, String description, String failingUrl) {  
19.         super.onReceivedError(view, errorCode, description, failingUrl);  
20.         // 加载网页失败时处理  如：  
21.         view.loadDataWithBaseURL(null,  
22.                 "网页加载失败",  
23.                 "text/html",  
24.                 "utf-8",  
25.                 null);  
26.     }    
27. });  

五、处理https请求，为WebView处理ssl证书设置
    WebView默认是不处理https请求的，页面显示空白，需要进行如下设置
    在WebViewClient子类中重写父类的onReceivedSslError函数  代码如下：

[java]  view plain copy

1. webView.setWebViewClient(new WebViewClient() {    
2.     
3.     @Override  
4.     public void onReceivedSslError(WebView view, SslErrorHandler handler, SslError error) {  
5.         handler.proceed();  // 接受信任所有网站的证书  
6.         // handler.cancel();   // 默认操作 不处理  
7.         // handler.handleMessage(null);  // 可做其他处理  
8.     }   
9. });   

六、显示页面加载进度
   在WebChromeClient子类中重写父类的onProgressChanged函数  代码如下：

[java]  view plain copy

1. webView.setWebChromeClient(new WebChromeClient() {    
2.     
3.     public void onProgressChanged(WebView view, int progress) {    
4.         setTitle("页面加载中，请稍候..." + progress + "%");    
5.         setProgress(progress * 100);    
6.     
7.         if (progress == 100) {    
8.             setTitle(R.string.app_name);    
9.         }    
10.     }    
11. });  

onProgressChanged通知应用程序当前页面加载的进度
progress表示当前页面加载的进度，为1至100的整数

七、back键控制网页后退
   Activity默认的back键处理为结束当前Activity，WebView查看了很多网页后，希望按back键返回上一次浏览的页面，这个时候我们就需要覆盖WebView所在Activity的onKeyDown函数，告诉他如何处理，代码如下：

 

[java]  view plain copy

1. public boolean onKeyDown(int keyCode, KeyEvent event) {    
2.     if (webView.canGoBack() && event.getKeyCode() == KeyEvent.KEYCODE_BACK && event.getRepeatCount() == 0) {    
3.         webView.goBack();    
4.         return true;    
5.     }    
6.     return super.onKeyDown(keyCode, event);    
7. }  

其中webView.canGoBack()在webView含有一个可后退的浏览记录时返回true
webView.goBack();表示返回至webView的上次访问页面

 

八、使用addJavascriptInterface完成和js交互
1、Js中调Native本地Java方法
  设置webView的addJavascriptInterface方法，该方法有两个参数，第一个参数为被绑定到js中的类实例，第二个参数为在js中暴露的类别名，在js中引用java对象就是用这个名字
在Native Java代码如下：

 

[java]  view plain copy

1. mWebView.getSettings().setJavaScriptEnabled(true);  
2. mWebView.addJavascriptInterface(new JavaScriptInterface(this), "Android");  
3.   
4. class JavaScriptInterface{  
5.   
6.     Context mContext;  
7.   
8.       
9.     JavaScriptInterface(Context c) {  
10.         mContext = c;  
11.     }  
12.   
13.       
14.     @JavascriptInterface  
15.     public void showToast(String toast) {  
16.         Log.d("TAG", "Js Invoker Native Function");  
17.         Toast.makeText(mContext, toast, Toast.LENGTH_SHORT).show();  
18.     }         
19.           
20. }  

在HTML中Js调用Native方法 代码如下：

 

[html]  view plain copy

1. <</span>input type="button" value="Say hello" onClick="showAndroidToast('Hello Android!')" />  
2.   
3. <</span>script type="text/javascript">  
4.     function showAndroidToast(toast) {  
5.         Android.showToast(toast);  
6.     }  
7. </</span>script>  

2、Java调Js方法
比如在HTML中有如下Js函数

 

[javascript]  view plain copy

1. "text/javascript">  
2.       function showAlert() {  
3.         alert("Be executed by Native");  
4.     }  
5.   

在Native调Js方法如下：

 

[java]  view plain copy

1. mWebView.loadUrl("javascript:showAlert()");  

九、WebView缓存模式的设置
1、网页数据缓存
当使用WebView加载HTML网页时，会在我们data/应用package下生成database与cache两个文件夹:
我们请求的Url记录是保存在webviewCache.db里，而url的内容是保存在webviewCache文件夹下.

五种缓存模式的设置setCacheMode：
LOAD_CACHE_ONLY:  不使用网络，只读取本地缓存数据。
LOAD_DEFAULT:  根据cache-control决定是否从网络上取数据。
LOAD_CACHE_NORMAL: API level 17中已经废弃, 从API level 11开始作用同LOAD_DEFAULT模式。
LOAD_NO_CACHE: 不使用缓存，只从网络获取数据。
LOAD_CACHE_ELSE_NETWORK，只要本地有，无论是否过期，或者no-cache，都使用缓存中的数据。

如示例代码：

 

[java]  view plain copy

1. WebSettings webSettings = mWebView.getSettings();  
2. webSettings.setCacheMode(WebSettings.LOAD_DEFAULT);  //设置 缓存模式    
3. // 开启 DOM storage API 功能    
4. webSettings.setDomStorageEnabled(true);    
5. //开启 database storage API 功能    
6. webSettings.setDatabaseEnabled(true);    

2、H5缓存
通过setAppCacheEnabled(boolean flag)设置H5的缓存是否打开，默认关闭。
根据setAppCachePath(String appCachePath)提供的路径，在H5使用缓存过程中生成的缓存文件。
通过setAppCacheMaxSize(long appCacheMaxSize)设置缓存最大容量。

如示例代码：

 

[java]  view plain copy

1. String cacheDirPath = getCacheDir().getAbsolutePath()+ "/webViewCache ";  
2. WebSettings webSettings = mWebView.getSettings();  
3. //开启 database storage API 功能    
4. webSettings.setDatabaseEnabled(true);      
5. //设置数据库缓存路径    
6. webSettings.setDatabasePath(cacheDirPath);   
7. //开启Application H5 Caches 功能    
8. webSettings.setAppCacheEnabled(true);   
9. //设置Application Caches 缓存目录    
10. webSettings.setAppCachePath(cacheDirPath);  

十、加快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()方法添加如下代码：

 

 

[html]  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标签得到加载，因而对于这样的系统我们就先直接加载。

十一、WebView硬件加速导致页面渲染闪烁问题解决方法
    关于Android硬件加速 开始于Android 3.0 (API level 11),在四个级别上开启/关闭硬件加速
    1、Application级别：为整个应用程序开启硬件加速，在AndroidManifest中加入如下配置

 

[html]  view plain copy

1. <</span>application android:hardwareAccelerated="true" ...>  

      2、Activity级别：控制每个activity是否开启硬件加速，只需在activity元素中添加android:hardwareAccelerated属性即可

 

[html]  view plain copy

1. <</span>activity android:hardwareAccelerated="true" ...>  

    3、Window级别：注：目前还不支持在Window级别上关闭硬件加速

 

[java]  view plain copy

1. getWindow().setFlags(  
2.     WindowManager.LayoutParams.FLAG_HARDWARE_ACCELERATED，  
3.     WindowManager.LayoutParams.FLAG_HARDWARE_ACCELERATED);  

   4、View级别：运行时单个view硬件加速，目前Android还不支持在View级别开启硬件加速  代码如下：

 

[java]  view plain copy

1. mView.setLayerType(View.LAYER_TYPE_SOFTWARE, null);  

    

 

 [//TODO 关于Android硬件加速 小吕有时间会更详细的单独整理成一篇来做介绍 
     先提供学习地址：http://android.toolib.net/guide/topics/graphics/hardware-accel.html ]

     我们开启硬件加速后，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. }  

十二、其他注意事项：
    1> 从网络上下载html页面的过程应放在工作线程(后台线程)中
    2> html下载成功后渲染出html的步骤应放在UI主线程,不然WebView加载网页过程会容易报错