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代码，它会在用户点击按钮的时候使用新的接口创建一个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()什么都不做。