原文链接:http://developer.android.com/guide/webapps/webview.html
reference:http://developer.android.com/reference/android/webkit/WebView.html
如果你想实现一个Web应用(或仅仅是一个网页)作为你应用中的一部分,你可以使用WebView来实现它。WebView是Android的View类的扩展,它允许你显示一个网页作为Activity布局的一部分。它不包含成熟的浏览器的一些功能,例如导航控制或输入栏。默认情况下,WebView显示一个网页。
一个使用WebView的很普遍的场合是当你想要在应用中提供需要时常更新的信息时,例如用户协议或用户手册。在Android应用当中,你能创建一个Activity它包含一个WebView,然后使用它你可以显示网上提供的文档。
另一个使用WebView的场合是:假如你的应用总是需要网络链接来获取数据并提供给用户,例如电子邮件。这时候,你能发现在应用中创建一个WebView并使用网页来显示用户数据,比执行网络请求,解析数据然后再渲染到Android布局当中更加方便。你只需要根据Android设备设计网页,然后在应用当中实现一个WebView然后载入刚刚设计的网页。
这篇文档会教你如何开始学习WebView并实现一些其他功能,例如页面导航和绑定JavaScript到网页当中。
在应用中添加一个WebView
想添加一个WebView到应用当中,你只需要包含WebView标签到你的Activity布局文件当中。例如,下面是一个WebView填充满屏幕的布局
<?xml version="1.0" encoding="utf-8"?> <WebView xmlns:android=http://schemas.android.com/apk/res/android android:id="@+id/webview" android:layout_width="fill_parent" android:layout_height="fill_parent"/>
在WebView中载入网页,可以使用loadUrl()方法,例如
WebView myWebView = (WebView) findViewById(R.id.webview); myWebView.loadUrl("http://www.baidu.com");
这段代码运行之前,你需要接入到因特网中。你仅需要添加因特网权限到你的Manifest文件当中。
<uses-permission android:name="android.permission.INTERNET" />
这些是显示一个网页的基本知识。
在WebView中使用JavaScript
如果你想要载入的网页实现了JavaScript,你必须在WebView中开启JavaScript功能。当JavaScript有用时,你还可以再你的应用代码和JavaScript代码之间创建接口。
开启JavaScript
在WebView中JavaScript默认是不开启的。你可以通过WebSettings添加到WebView当中开启它。你可以使用getSettings()方法获得WebSettings,然后使用setJavaScriptEnabled()来开启它。 例如:
WebView myWebView = (WebView) findViewById(R.id.webview); WebSettings webSettings = myWebView.getSettings(); webSettings.setJavaScriptEnabled(true);
在WebSettings中你可以发现很多有用的功能。例如,如果你使用WebView开发一个网络应用,你可以使用setUserAgentString()方法定义一个自定义用户代理字符串,后面可以查询网页中的自定义用户代理,辨别当前请求网页的是不是你的Android应用。
绑定JavaScript代码到Android源码
当在应用当中使用WebView创建网络应用的时候,你可以在JavaScript和Android源码之间创建一个接口,例如,你的JavaScript代码可以调用Android中定义的方法来显示一个对话框,而不适用JavaScript的alert()方法。
例如你可以在应用当中添加以下的类:
public class JavaScriptInterface { Context mContext; /** Instantiate the interface and set the context */ JavaScriptInterface(Context c) { mContext = c; } /** Show a toast from the web page */ public void showToast(String toast) { Toast.makeText(mContext, toast, Toast.LENGTH_SHORT).show(); } }
在这个例子中,JavaScriptInterface类使用showToast()方法创建Toast消息。
你可以绑定这个类到JavaScript当中并在WebView当中使用addJavaScriptInterface()方法运行并创建接口的名称为Android。
WebView webView = (WebView) findViewById(R.id.webview); webView.addJavascriptInterface(new JavaScriptInterface(this), "Android");
这段代码会创建一个名称为“Android”的JavaScript接口并运行在WebView当中。在这里,你的Web应用会接入到JavaScriptInterface类。例如,下面为Html何JavaScript代码,它会在用户点击按钮的时候使用新的接口创建一个Toast消息。
<input type="button" value="Say hello" onClick="showAndroidToast('Hello Android!')" /> <script type="text/javascript"> function showAndroidToast(toast) { Android.showToast(toast); } </script>
你不需要初始化从JavaScript当中初始化Android接口。WebView会自动的让他可以使用在网页当中。因此,当点击按钮的时候showAndroidToast()方法会使用Android接口调用JavaScriptInterface.showToast()方法。
备注:在JavaScript中绑定的对象会运行在另一个线程,它和创建它的线程是不同的线程。
注意点:使用java.lang.String) addJavaScriptInterface()允许JavaScript来控制Android应用。这是一个非常有用和危险的。当在WebView当中的HTML是不能信任的(例如,HTML中的一些内容是由不认识的人或线程来提供),攻击者可以随意控制执行在客户端的HTML代码。同样的,除了你需要你写的HTML或JavaScript在WebView当中呈现出来,你不应该使用java.lang.String) addJavaScriptInterface()方法。你也不能允许用户在WebView中操纵除了自己外的别的网页(相反,你应该让用户调用默认的浏览器来打开外部的连接--一般,用户的网页浏览器会打开所有的URL链接,因此只有当操纵的网页跟下部分描述的一样)。
处理页面导航
当用户在你的WebView中点击一个链接时,对于Android来说默认的动作时启动一个应用程序捕捉它。通常,默认的网页浏览器会打开并且载入目标URL。然而,你可以在WebView中重写该动作,把该链接在你的WebView中打开。你还可以让用户自己处理历史的回退和前进功能。
打开用户点击的链接,仅仅在WebView中提供WebViewClient即可,使用setWebViewClient()方法。例如:
WebView myWebView = (WebView) findViewById(R.id.webview); myWebView.setWebViewClient(new WebViewClient());
完成,现在用户点击的所有链接都会在WebView中打开。如果你想要在点击链接并载入网页的时候做更多的操作,请创建自己的WebViewClient 并重写java.lang.String) shouldOverrideUrlLoading()方法。例如:
private class MyWebViewClient extends WebViewClient { @Override public boolean shouldOverrideUrlLoading(WebView view, String url) { if (Uri.parse(url).getHost().equals("www.example.com")) { //这是我的网页,所以不要重写,让我的WebView载入它 return false; } // 如果不是我的网页,则启动另外的Activity来处理该URL Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url)); startActivity(intent); return true; } }
然后给WebView创建一个WebViewClient的实例。
WebView myWebView = (WebView) findViewById(R.id.webview); myWebView.setWebViewClient(new MyWebViewClient());
现在当用户点击一个链接,系统会调用java.lang.String) shouldOverrideUrlLoading() , 它会辨别URL主机是否要匹配指定的域名(就像我们上面列举的一样)。如果它不能匹配,则该方法返回false,一个Intent会创建并启动默认的Activity来处理该URL(它一般解析为用户的默认浏览器)。
操作网页历史
当你的WebView重写URL的载入,它会自动累积访问过的网页历史。你可以使用goBack()方法和goForward()方法操纵回退和向前功能。 例如,下面是Activity使用返回按钮操作“回退”功能。
@Override public boolean onKeyDown(int keyCode, KeyEvent event) { // Check if the key event was the Back button and if there's history if ((keyCode == KeyEvent.KEYCODE_BACK) && myWebView.canGoBack() { myWebView.goBack(); return true; } // If it wasn't the Back key or there's no web page history, bubble up to the default // system behavior (probably exit the activity) return super.onKeyDown(keyCode, event); }
如果有网页历史则canGoBack()方法返回True,同样的,你可以使用canGoForward()来检查是否有“前进”历史。如果你不执行这个检查,当用户到达历史的尽头的时候,goBack()和goForward()什么都不做。