内置浏览器
网页视图WebView
如果一个网站已经有现成的网页及业务逻辑,那么使用WebView将其内嵌到app中,省去了app重画页面与http通信的事情,无疑是更经济的做法。WebView就是Android上的一个浏览器内核,可自动展示web页面,并且实现js代码的相互调用。
下面是WebView的常用方法:
getSettings : 获取浏览器的web设置信息。
addJavascriptInterface : 添加本地的js代码接口。
removeJavascriptInterface : 移除本地的js代码接口。在4.0至4.2的Android系统上,Webview自己增加了searchBoxJavaBredge_,可能被黑客利用导致远程代码执行。为阻止该漏洞,需要手工移除接口searchBoxJavaBredge_。代码如下所示:
[java]
view plain
copy
wv_web.removeJavascriptInterface("searchBoxJavaBredge_");
setWebViewClient : 设置浏览器的加载事件。
setWebChromeClient : 设置浏览器的交互事件。
setDownloadListener : 设置文件下载监听器。
loadData : 加载文本数据。第二个参数表示媒体类型,如"text/html";第三个参数表示数据的编码格式,"base64"表示采用base64编码,其余值(包括null)表示url编码。
loadUrl : 加载url。
canGoBack : 判断页面能否返回。
goBack : 返回到上一个页面。
网页设置WebSettings
WebSettings用于操作WebView的web设置信息。其对象由WebView的getSettings方法得到。下面是WebSettings的常用设置方法:
setLoadsImagesAutomatically : 设置是否自动加载图片
setDefaultTextEncodingName : 设置默认的文本编码。如utf-8、gbk等等。
setJavaScriptEnabled : 设置是否支持Javascript
setJavaScriptCanOpenWindowsAutomatically : 设置是否允许js自动打开新窗口(window.open())
以上是基本的设置。
setSupportZoom : 设置是否支持缩放。
setBuiltInZoomControls : 设置是否出现缩放工具。
setUseWideViewPort : 当容器超过页面大小时,是否放大页面大小到容器宽度。
setLoadWithOverviewMode : 当页面超过容器大小时,是否缩小页面尺寸到页面宽度。
setLayoutAlgorithm : 设置自适应屏幕的算法,一般是LayoutAlgorithm.SINGLE_COLUMN。如果不做设置,4.2.2及之前版本自适应时可能会出现表格错乱的情况。
以上是网页与容器适配的设置。
setDomStorageEnabled : 设置是否启用本地存储。
setCacheMode : 设置是否使用缓存。LOAD_CACHE_ELSE_NETWORK表示优先使用缓存,LOAD_NO_CACHE表示不使用缓存,LOAD_CACHE_ONLY表示只使用缓存。
setAppCacheEnabled : 设置是否启用app缓存。
setAppCachePath : 设置app缓存文件的路径。
setAllowFileAccess : 设置是否允许访问文件,例如WebView访问sd卡的文件。不过assets与res文件不受此限制,仍然可以通过“file:
setDatabaseEnabled : 设置是否启用数据库。
以上是与存储有关的设置。
网页事件监听
主要有三个事件监听器,分别是WebViewClient、WebChromeClient和DownloadListener。
浏览器加载事件
WebViewClient主要用于处理。相关类名与方法说明如下:
监听器类名 : WebViewClient
设置监听器的方法 : setWebViewClient
监听器需要重写的方法 :
onPageStarted : 页面开始加载。一般在此弹出进度对话框ProgressFialog
onPageFinished : 页面加载结束。一般在此关闭进度对话框。
onReceivedError : 收到错误信息。
onReceivedSslError : 收到ssl错误。
shouldOverrideUrlLoading : 重写该方法表明,点击网页里面的链接是在当前的webview里跳转,还是跳转到其它浏览器。如果想在当前的webview跳转,则加上下面这句代码:
[java]
view plain
copy
view.loadUrl(url);
浏览器的交互事件
WebChromeClient主要用于。相关类名与方法说明如下:
监听器类名 : WebChromeClient
设置监听器的方法 : setWebChromeClient
监听器需要重写的方法 :
onReceivedTitle : 收到页面标题
onProgressChanged : 页面加载进度发生变化
onJsAlert : 弹出js警告框。
onJsConfirm : 弹出js确认框。
onJsPrompt : 弹出js提示框。
onGeolocationPermissionsShowPrompt : 网页请求定位权限。通常重写该方法弹出一个确认对话框,提示用户是否允许网页获得定位权限。下面代码表示允许定位权限:
[java]
view plain
copy
callback.invoke(origin, true, false);
文件下载事件
DownloadListener主要用于。相关类名与方法说明如下:
监听器类名 : DownloadListener
设置监听器的方法 : setDownloadListener
监听器需要重写的方法 :
onDownloadStart : 文件开始下载。可在此设置文件下载的方式,以及文件的保存路径。
浏览器的应用场景
1、点击返回键返回上个页面,可监听返回键的按下事件,具体有两种方式,分别是重写onBackPressed函数,以及重写onKeyDown函数。
重写onBackPressed函数
@Override public void onBackPressed() { if (wv_web.canGoBack()) { wv_web.goBack(); return; } else { finish(); } }
重写onKeyDown函数
@Override public boolean onKeyDown(int keyCode, KeyEvent event) { if ((keyCode == KeyEvent.KEYCODE_BACK) && wv_web.canGoBack()) { wv_web.goBack(); return true; } else { return false; } }
2、显示页面加载进度。可在WebViewClient的onPageStarted方法中弹出进度对话框ProgressFialog,然后在onPageFinished方法中关闭进度对话框。要想动态显示当前页面的加载百分比,可在WebChromeClient的onProgressChanged方法中设置进度对话框的当前进度。
3、显示js的提示对话框。默认情况下,js对话框也能正常显示和操作,只是对话框标题默认为“网址为"***"的网页显示”,这个标题信息不够友好,所以我们需要重写WebChromeClient的三个js方法onJsAlert、onJsConfirm和onJsPrompt,在内部构造一个AlertDialog实例,分别设置标题、信息,以及肯定按钮和否定按钮。同时监听肯定按钮的点击事件,调用JsResult的confirm方法;监听否定按钮的点击事件,调用JsResult的cancel方法。
4、允许js调用本地java代码。先声明一个本地java代码的操作类,然后调用WebView的addJavascriptInterface方法,关联本地java对象与对象名称。代码示例如下:
声明一个本地java代码的操作类:
[java]
view plain
copy
class MyJavaScript { @JavascriptInterface public String toString() { return "injectedObject"; } }
在WebView中注册该java代码的对象,并演示javascript的调用过程:
[java]
view plain
copy
wv_web.getSettings().setJavaScriptEnabled(true); wv_web.addJavascriptInterface(new MyJavaScript(), "injectedObject"); wv_web.loadData("<!DOCTYPE html><title></title>", "text/html", null); wv_web.loadUrl("javascript:alert(injectedObject.toString())");
Android代码与html的js代码相互调用
Android代码调用js代码
下面是android的代码
[java]
view plain
copy
wv_local.getSettings().setJavaScriptEnabled(true); wv_local.setWebChromeClient(new WebChromeClient()); wv_local.loadUrl("file:///android_asset/sample.html"); wv_local.loadUrl("javascript:showMsg()");
下面是js的代码
[html]
view plain
copy
<script type="text/javascript"> function showMsg(){ alert("hello world!"); } </script>
js代码调用Android代码
下面是android的代码
[java]
view plain
copy
wv_local.getSettings().setJavaScriptEnabled(true); wv_local.addJavascriptInterface(new Contact(), "contact"); wv_local.loadUrl("file:///android_asset/sample.html"); private final class Contact { @JavascriptInterface public void showMsg(String msg) { AlertDialog.Builder builder = new AlertDialog.Builder(LocalActivity.this); builder.setMessage(msg).create().show(); } }
下面是js的代码
[html]
view plain
copy
<script type="text/javascript"> function showMsgInAndroid(){ contact.showMsg("hello world 3"); } </script> <button id="btntest" onclick="javascript:showMsgInAndroid()">调用android方法</button>
Android与js互调获得返回值
js调用Android方法,可直接获取调用的返回值,难点在于Android调用js方法的返回值。因为WebView加载网页是异步的,所以loadUrl方法调用js无法直接获得返回值。多数情况只能在js代码中回调Android方法,从而间接获取Android调用js的返回值。不过从Android4.4.2开始,我们可通过调用WebView的evaluateJavascript方法来直接得到js返回值,下面是Android的示例代码:
[java]
view plain
copy
wv_local.evaluateJavascript("getMsg()", new ValueCallback<String>() { @Override public void onReceiveValue(String value) { AlertDialog.Builder builder = new AlertDialog.Builder(LocalActivity.this); builder.setMessage(UnicodeToString(value)).create().show(); } }); public static String UnicodeToString(String str) { if (str != null && str.trim().length() > 0) { String un = str.trim(); StringBuffer sb = new StringBuffer(); int idx = un.indexOf("\\u"); while (idx >= 0) { if (idx > 0) { sb.append(un.substring(0, idx)); } String hex = un.substring(idx + 2, idx + 2 + 4); sb.append((char) Integer.parseInt(hex, 16)); un = un.substring(idx + 2 + 4); idx = un.indexOf("\\u"); } sb.append(un); return sb.toString(); } return ""; }
下面是js的代码
[html]
view plain
copy
<script type="text/javascript"> function getMsg(){ return "来自网页的消息: hello world!"; } </script>
注意事项
下面是android与js相互调用的几个注意点:
1、WebView要调用setWebChromeClient方法设置js的解释客户端,来解决js中alert不弹出的问题,因为js页面的渲染需要WebChromeClient去实现。
2、如果js调用android代码时,logcat报错“Uncaught TypeError: Object [object Object] has no method”,那是因为Android4.2以上版本默认不开放js调用本地方法的权限,得给开放js调用的方法加上“@JavascriptInterface注释”,该注释允许js代码访问android的方法。
3、evaluateJavascript是Android4.4.2之后才引入的新方法,如果是4.4.2之前的Android版本,需要注意做兼容处理。
4、js获取Android方法返回值中的中文是正常,但Android获取js方法返回值的中文却是“\u”打头的字符串,所以Android要先将js返回的字符串做转义处理,即调用上面的UnicodeToString方法,转义后的字符串才是正常的汉字。
5、如果android与js存在嵌套调用(即A调用B,B内部又去调用A),那么在Android4.4.2之后务必要保证两个调用在同一个线程中,不然运行时会报错“java.lang.Throwable: A WebView method was called on thread 'JavaBridge'. All WebView methods must be called on the same thread.”。具体的解决方法,是调用WebView对象的post方法,在post的Runnable任务中再去调用js方法,示例代码如下:
[java]
view plain
copy
private final class Contact {
HTML5框架
PhoneGap
以下说明文字来自百度百科的PhoneGap词条:
“PhoneGap是一个用基于HTML,CSS和JavaScript的,创建移动跨平台移动应用程序的快速开发平台。它使开发者能够利用iPhone、Android、Palm、Symbian、WP7、WP8、Bada和Blackberry智能手机的核心功能——包括地理定位,加速器,联系人,声音和振动等,此外PhoneGap拥有丰富的插件,可以调用。
它需要特定平台提供的附加软件,例如iPhone的iPhone SDK,Android的Android SDK等,也可以和DW5.5及以上版本配套开发。使用PhoneGap只比为每个平台分别建立应用程序好一点点,因为虽然基本代码是一样的,但是你仍然需要为每个平台分别编译应用程序。”
对于Android开发来说,PhoneGap其实就是在assets下面新建了www目录,然后入口Activity通过嵌入WebView来加载www下的html页面,接下来就是在各个html之间互相跳转,从而实现Android原生app界面交互的效果。
Cordova
虽然PhoneGap号称跨平台,但是html5+js也只能完成网站那样的网页操作,却无法直接操作手机设备的功能。因此PhoneGap引入了Cordova,Cordova提供了一组与设备相关的API,通过这组API,app能够以JavaScript访问原生的设备功能,如摄像头、麦克风等。Cordova还提供了一组统一的JavaScript类库,以及为这些类库所用的设备相关的原生后台代码。Cordova是驱动PhoneGap的核心引擎,有人说它们的关系类似于Webkit和Google Chrome的关系。
WeX5
WeX5是国内基于Phonegap的一个HTML5开发框架,它有自己的开发工具“WeX5 studio”,其实就是个定制版的Eclipse。在这个IDE上,可以通过拖曳控件来画html页面,这个倒是很像ios的开发工具Xcode。另外,WeX5的Cordova插件还集成了国内常用的几个工具包,与PhoneGap相比,WeX5更适合于国内的开发者。
代码示例
下面是WebView使用的代码例子:
[java]
view plain
copy
import android.annotation.SuppressLint; import android.app.Activity; import android.app.AlertDialog; import android.app.ProgressDialog; import android.content.Context; import android.content.DialogInterface; import android.graphics.Bitmap; import android.os.Bundle; import android.util.Log; import android.view.KeyEvent; import android.view.View; import android.view.View.OnClickListener; import android.view.View.OnLongClickListener; import android.view.inputmethod.InputMethodManager; import android.webkit.DownloadListener; import android.webkit.GeolocationPermissions.Callback; import android.webkit.JavascriptInterface; import android.webkit.JsResult; import android.webkit.WebChromeClient; import android.webkit.WebSettings; import android.webkit.WebSettings.LayoutAlgorithm; import android.webkit.WebView; import android.webkit.WebViewClient; import android.widget.Button; import android.widget.EditText; import android.widget.Toast; public class WebActivity extends Activity implements OnClickListener, OnLongClickListener { private final static String TAG = "WebActivity"; private Context mContext; private EditText et_web_url; private Button btn_web_go; private WebView wv_web; private ProgressDialog m_pd; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_web); mContext = this; et_web_url = (EditText) findViewById(R.id.et_web_url); et_web_url.setOnLongClickListener(this); et_web_url.setText("222.77.181.14/news/zapb.aspx"); wv_web = (WebView) findViewById(R.id.wv_web); btn_web_go = (Button) findViewById(R.id.btn_web_go); btn_web_go.setOnClickListener(this); initWebViewSettings(); } @SuppressLint("SetJavaScriptEnabled") private void initWebViewSettings() { WebSettings settings = wv_web.getSettings();
点击下载本文用到的网页加载与JS调用的工程代码
点此查看Android开发笔记的完整目录