为了学习webview，打算从官网API学起。因为我英文不好，所以打算译下这篇文章，慢慢去认识这个控件。(官网地址)

Building Web Apps in WebView

      如果你想要传送一个web的应用 或者 仅仅是一个web 页面作为一个应用客户端。你可以使用webview。这个webview的类是安卓的一个拓展的视图控件允许你在activity中显示你web页面作为你页面布局的一部分。它不包含任何一个充分发展有特色的web浏览器，例如导航控制或者 一个地址栏。webview所做的是，默认是显示一个web页面的。 一个很普遍的情况，当你想要在你的应用中展示信息的时候，使用webview是很有用的。也许你可能需要更新才能实现，例如一份终端用户协议或者一份使用者指南。在你android应用中，你可以创建一个含有webview控件的activity，然后可以使用它去展示你的在线文档。 另外一种情况是使用webview有帮助的是如果你的应用提供的数据总是来源于一个网络连接的话，例如email。在这种情况下，也许你会发现在你的android中建立一个webview 来展示带有用户数据 的web页面，而不是执行一个 网络请求，然后解析这些数据，然后在android页面中显示出来。相反，你可以设计一个web页面专为android设备 然后实现一个webview在你android应用中去加载这些web页面。   以下文档展示你如何开始使用一个webview  和做一些额外的事。例如处理页面导航和绑定js从web页面到android客户端应用。

Adding a WebView to Your Application

为了在你的应用中增加一个webview控件 ，仅仅只要在的布局中引入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中加载一个web页面，使用   loadUrl() . 例如: yWebView = (WebView) findViewById(R.id.webview); myWebView.loadUrl("http://www.example.com"); 为了让这个起作用,然而你的应用必须添加联网权限。为了得到联网权限, 需要在你的 manifest 文件使用 INTERNET  permission. 例如: <manifest ... >     <uses-permission android:name="android.permission.INTERNET" />     ... </manifest> 这些就是所有你需要webview的一个最基本功能，去展示一个web页面。

Using JavaScript in WebView

如果你在webview 中你计划加载的web页面需要用到js，你必须在webview中允许JAVAScript。一旦你允许js，你也能创建一个接口在你的android 代码 和js代码中。

Enabling JavaScript

默认情况下JAVASCRIPT是不能用的，你可以通过websettings连接着你的webview。你能得到 websettings对象通过webview 的getsettings()的方法，然后 设置JavaScript可用 通过使用   setJavaScriptEnabled()方法。 如： WebSettings  提供各种各样的设置，也许你会发现很有用的设置。例如，如果你开发一个web应用，它是专门为你android应用的webview设计。然后你可以定制一个用户代理 字符串通过使用setUserAgentString()方法，然后通过查询你的web页面中询用户代理，去验证客户端请求你的web页面是确实是你的android应用程序。 WebView myWebView = (WebView) findViewById(R.id.webview); WebSettings webSettings = myWebView.getSettings(); webSettings.setJavaScriptEnabled(true); When developing a web application that's designed specifically for the  WebView in your Android application, you can create interfaces between your JavaScript code and client-side Android code. For example, your JavaScript code can call a method in your Android code to display a  Dialog, instead of using JavaScript's  alert() function.

To bind a new interface between your JavaScript and Android code, call addJavascriptInterface(), passing it a class instance to bind to your JavaScript and an interface name that your JavaScript can call to access the class.

大概意思是这样的：

     当你想要在你安卓应用的webview上设置一个web的应用时，你能在你android和js之间创立一个接口。例如，你的js代码能够调用你安卓代码去显示一个对话框，而不是用js的alert()方法。

    为了去绑定一个新的接口在js和android之间，你需要调用addJavascriptInterface()方法，然后通过一个类的实例去绑定你的js， 然后js可以通过接口名字访问该类。

例如，你可以引入如下的类在你的android 应用中：

public class WebAppInterface { Context mContext; /** Instantiate the interface and set the context */ WebAppInterface(Context c) { mContext = c; } /** Show a toast from the web page */ @JavascriptInterface public void showToast(String toast) { Toast.makeText(mContext, toast, Toast.LENGTH_SHORT).show(); } } 注意：如果你应用的targetSdkVersion是17或者更高  你 必须在 你每个的js需要调用的android类中的方法上  加上    @JavascriptInterface，而且这个方法必须是public的。 如果你不加的话，这些方法将会无效的。

在这个例子中，这个 WebAppInterface类允许网页去创建一个Toast通过使用showToast()方法。

你可以绑定这个类到js通过在你的WebView 使用addJavascriptInterface()方法然后命名这个接口为‘Android’(名字是可以任意取的).例如：

WebView webView = (WebView) findViewById(R.id.webview); webView.addJavascriptInterface(new WebAppInterface(this), "android");

以上为js在webview运行中创建了一个名为android的接口。在这一点上，你的web应用已经拿到了WebAppInterface类的访问权了。例如，以下有一些html和js的代码片断 当用户点击一个按钮的时候，就会创建一个toast通过使用这个新的接口：

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

在js中是无需实例化这个叫‘Android’的接口，WebView已经自动让你在网页中可以使用。所以在你点击button的时候 ，这个showAndroidToast()方法 使用这个 ‘Android’接口 去调用 WebAppInterface.showToast()  方法。

Note: 这个绑定的sj的对象是运行在另外一个线程的，而不是在构造的这个线程。

Caution:使用addJavascriptInterface()允许js控制你的android应用。这可以是一个非常有用的特点，也可以是一个危险的安全问题。当这个HTML 在这个webview中靠不住的时候（例如，这个HTML是被一个不认识的人或者 不认识的程序提供的时候），这时候一个攻击者能引用这个HTML然后提交你的客户端的代码或任何他想要的代码。像这样，你就不应该使用 addJavascriptInterface() 方法，除非你能保证在你的webview中的这个HTML和js都是你写的。你也不应该允许用户在你的webview中导航到其他不属于你的网页（相反，在默认情况下允许用户的默认浏览器打开一个外链接，用户的web浏览器就会打开所有的url链接，所以要当心只有你在以下描述中处理页面的导航）。

Handling Page Navigation

当用记在你的webview中点击了一个链接，对于Android这个默认的行为是打开一个应用去处理URLS。通常，默认浏览器打开和加载到目的链接。然而你可以 在你的webview中打开这些链接，通过在 WebView中覆盖这个行为。你可以允许用户向前和后退导航通过网页的历史记录在你的webview中维护。 用户点击打开链接，只需要为你的WebView提供一个 WebViweClient，使用 setWebViewClient().例如： WebView myWebView = (WebView) findViewById(R.id.webview); myWebView.setWebViewClient(new WebViewClient());  就这样，现在用户所有点击的链接都会在你的WebView加载。  如果你想要更多的控制加载点击的链接，创建你自己WebViewClient,通过覆盖shouldOverrideUrlLoading()方法。例如： private class MyWebViewClient extends WebViewClient { @Override public boolean shouldOverrideUrlLoading(WebView view, String url) { if (Uri.parse(url).getHost().equals("www.example.com")) { // This is my web site, so do not override; let my WebView load the page return false; } // Otherwise, the link is not for a page on my site, so launch another Activity that handles URLs Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url)); startActivity(intent); return true; } } 然后通过 new WebViewClient 为WebView去创建一个实例： WebView myWebView = (WebView) findViewById(R.id.webview); myWebView.setWebViewClient(new MyWebViewClient()); 现在当用户点击一个链接的时候，系统就会回调shouldOverrideUrlLoading()方法，然后可以检查是否这个url主机是否匹配你需要的链接主机地址。如果匹配的话，然后这个方法会返回false为了不重写这个url的链接的加载（它允许这个WebView 像往常一样加载url）;如果这个url 的主机 和条件不匹配的话，然后我们可以创建一个意图去处理这个链接（这解决了用户默认的浏览器？）;

Navigating web page history

当你的WebView 重写了url的加载，WebView就会自动的积累你的历史访问路径。你可以向前导航和向后导航通过 历史的 goBack()和goForward()方法。

例如，以下例子是 展示 如何使你页面通过设置的回退按钮导航回去：

@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() or goForward() 什么也做不了。