Android在WebView上构建Web应用程序

原文链接：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代码，它会在用户点击button的时候使用新的接口创建一个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中的一些内容是由不认识的人或线程来提供），攻击者能够任意控制运行在client的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使用返回button操作“回退”功能。

@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()什么都不做。