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访问权限，否则提示页面无法访问。

?

1 2 3 4

<manifest ...= "" >      <uses-permission android:name= "android.permission.INTERNET" >      ... </uses-permission></manifest>

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

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22

WebSettings webSettings = mWebView.getSettings(); webSettings.setJavaScriptEnabled( true ); webSettings.setCacheMode(WebSettings.LOAD_DEFAULT); webSettings.setDomStorageEnabled( true );  webSettings.setDatabaseEnabled( true ); webSettings.setAppCacheEnabled( true ); webSettings.setAllowFileAccess( true ); webSettings.setSavePassword( true ); webSettings.setSupportZoom( true ); webSettings.setBuiltInZoomControls( true );   /**    * 用WebView显示图片，可使用这个参数 设置网页布局类型：    * 1、LayoutAlgorithm.NARROW_COLUMNS ：适应内容大小    * 2、LayoutAlgorithm.SINGLE_COLUMN : 适应屏幕，内容将自动缩放    */ webSettings.setLayoutAlgorithm(WebSettings.LayoutAlgorithm.NARROW_COLUMNS); webSettings.setUseWideViewPort( true );   mWebView.setScrollBarStyle(WebView.SCROLLBARS_OUTSIDE_OVERLAY); mWebView.setHorizontalScrollbarOverlay( true ); mWebView.setHorizontalScrollBarEnabled( true ); mWebView.requestFocus();

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

?

1	mWebView.setWebChromeClient( new MyWebChromeClient());

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

?

1	mWebView.setWebViewClient( new MyWebViewClient());

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

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

?

1 2 3 4 5 6 7 8

webView.setWebViewClient( new WebViewClient() {           @Override       public boolean shouldOverrideUrlLoading(WebView view, String url) {           view.loadUrl(url);           return true ;       }  });

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

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

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27

webView.setWebViewClient( new WebViewClient() {           @Override      public void onPageStarted(WebView view, String url, Bitmap favicon) {          super .onPageStarted(view, url, favicon);          // 开始加载网页时处理 如：显示"加载提示" 的加载对话框          DialogManager.showLoadingDialog( this );      }        @Override      public void onPageFinished(WebView view, String url) {          super .onPageFinished(view, url);          // 网页加载完成时处理  如：让 加载对话框 消失          DialogManager.dismissLoadingDialog();      }        @Override      public void onReceivedError(WebView view, int errorCode, String description, String failingUrl) {          super .onReceivedError(view, errorCode, description, failingUrl);          // 加载网页失败时处理  如：          view.loadDataWithBaseURL( null ,                  "<span style=" \"color:#FF0000\" ">网页加载失败</span>" ,                  "text/html" ,                  "utf-8" ,                  null );      }  });

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

?

1 2 3 4 5 6 7 8 9

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

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

?

1 2 3 4 5 6 7 8 9 10 11

webView.setWebChromeClient( new WebChromeClient() {           public void onProgressChanged(WebView view, int progress) {           setTitle( "页面加载中，请稍候..." + progress + "%" );           setProgress(progress * 100 );               if (progress == 100 ) {               setTitle(R.string.app_name);           }       }  });

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

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

?

1 2 3 4 5 6 7

public boolean onKeyDown( int keyCode, KeyEvent event) {       if (webView.canGoBack() && event.getKeyCode() == KeyEvent.KEYCODE_BACK && event.getRepeatCount() == 0 ) {           webView.goBack();           return true ;       }       return super .onKeyDown(keyCode, event);  }

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

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

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22

mWebView.getSettings().setJavaScriptEnabled( true ); mWebView.addJavascriptInterface( new JavaScriptInterface( this ), "Android" );   class JavaScriptInterface{        Context mContext;        /** Instantiate the interface and set the context */      JavaScriptInterface(Context c) {          mContext = c;      }        /** Show a toast from the web page        * 由Js调用执行Native本地Java方法        */      @JavascriptInterface      public void showToast(String toast) {          Log.d( "TAG" , "Js Invoker Native Function" );          Toast.makeText(mContext, toast, Toast.LENGTH_SHORT).show();      }                 }

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

?

1 2 3 4 5 6 7

<input type= "button" value= "Say hello" onclick= "showAndroidToast('Hello Android!')" >   <script type= "text/javascript" >      function showAndroidToast(toast) {          Android.showToast(toast);      } </script>

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

?

1 2 3 4 5

<script type= "text/javascript" >        function showAlert() {          alert( "Be executed by Native" );      } </script>

在Native调Js方法如下：

?

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，都使用缓存中的数据。

如示例代码：

?

1 2 3 4 5 6

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

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

如示例代码：

?

1 2 3 4 5 6 7 8 9 10

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

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

?

1 2 3 4 5 6 7

public void int () {      if (Build.VERSION.SDK_INT >= 19 ) {          webView.getSettings().setLoadsImagesAutomatically( true );      } else {          webView.getSettings().setLoadsImagesAutomatically( false );      } }

同时在WebView的WebViewClient子类中重写onPageFinished()方法添加如下代码：

?

1 2 3 4 5 6

@Override public void onPageFinished(WebView view, String url) {      if (!webView.getSettings().getLoadsImagesAutomatically()) {          webView.getSettings().setLoadsImagesAutomatically( true );      } }

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

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

?

1	</application>

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

?

1	</activity>

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

?

1 2 3

getWindow().setFlags(      WindowManager.LayoutParams.FLAG_HARDWARE_ACCELERATED，      WindowManager.LayoutParams.FLAG_HARDWARE_ACCELERATED);

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

?

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

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

我们开启硬件加速后，WebView渲染页面更加快速，拖动也更加顺滑。但有个副作用就是容易会出现页面加载白块同时界面闪烁现象。解决这个问题的方法是设置WebView暂时关闭硬件加速 代码如下：

?

1 2 3

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

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