文檔內容

將 WebView 加入你的應用

¨     在Webview中使用 JavaScript

¨     啟用 JavaScript

¨     將 JavaScript代碼綁定到Android代碼

處理頁面導航

¨    歷史記錄導航

關鍵的類

WebView

WebSettings

WebViewClient

相關手冊

Web View

如果你想發布一個web app(或者僅僅是一個web頁面)作為客戶端的一部分，你可以使用WebView。WebView是Android中 View的擴展，能讓你將web頁面作為你的活動布局(activity layout)。它不包含一個瀏覽器的完整功能，比如導航控制或者地址欄。 WebView默認做的僅僅是展現一個Web頁面。

使用 WebView的一個常見場景是當你想要在應用中提供一些你可能需要更新的信息的時候，比如終端用戶協議或者用戶指南。在你的Android應用中，你需要創建包含WebView的Activity ，然后利用它來展現你掛在網上的文檔。

另外一個使用WebView的場景是你為用戶提供的數據時需要連接網絡來獲取數據，比如email。在這種情況下，你可能會發現在Android應用中構建一個WebView來展現提供相關數據的web頁面更為容易，而不是試圖連接到網絡獲取數據，解析數據并將其安置到Android布局中。你可以設計一個專供Android設備使用的web頁面，并在Android中實現一個WebView來加載這個頁面。

該文檔展示了你可以如何開始使用 WebView并額外做一些事情，比如頁面導航、將web頁面中的Javascript代碼綁定到你的Android應用中的代碼上去。

將 WebView 加入你的應用

要在你的應用中加入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加載頁面， 使用 loadUrl()。例如：

WebView myWebView = (WebView) findViewById(R.id.webview); 
myWebView.loadUrl("http://www.example.com"); 

在它有效工作之前，你要保證你的應用能訪問網絡。要訪問網絡，需要在你的配置文件中獲取INTERNET許可。例如：

<manifest ... > 
    <uses-permission android:name="android.permission.INTERNET" /> 
    ... 
</manifest> 

這就是你要應用一個WebView 來展現web頁面基本的所要做的所有事情了。

在WebView中使用JavaScript

如果你想要你加載在WebView中的web頁面使用Javascript，你需要在WebView中啟用Javascript。一旦啟用Javascript，你就可以在你的應用代碼以及你的Javascript代碼間創建接口了。

啟用JavaScript

你可以通過WebView中帶有的 WebSettings來啟用它。你可以通過 getSettings()來獲取 WebSettings的值，然后通過setJavaScriptEnabled()來啟用JavaScript。

例如：

WebView myWebView = (WebView) findViewById(R.id.webview);  
WebSettings webSettings = myWebView.getSettings();  
webSettings.setJavaScriptEnabled(true);  

WebSettings 還提供了很多其他有用的設置。比如，如果你在開發一個專用于Android應用中 WebView 的web app，那么你就可以通過 setUserAgentString()定義自定義用戶代理字符串(custom user agent string)，然后通過在web頁面中查詢自定義用戶代理來確認正在請求你的web頁面的客戶端確實是Android應用。

將JavaScript 代碼綁定到Android 代碼

在開發專用于Android應用中 WebView 的web app時，你可以在你的Javascript代碼和客戶端的Android代碼間創建接口。例如，你的Javascript代碼可以調用Android代碼中的方法來展示一個Dialog，而不是使用Javascript中的alert()函數。

為了在你的Javascript和Android代碼間綁定一個新的接口，需要調用addJavascriptInterface()，傳給它一個類實例來綁定到Javascript，以及一個接口名讓Javascript可以調用以便來訪問類。

例如：你可以在你的Android應用中包括如下類：

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讓web頁面可以使用showToast()方法來創建一個Toast 消息。

你可以通過 addJavascriptInterface()綁定這個類到在WebView 運行的Javascript，并將接口命名為Android。例如：

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

這段代碼為在WebView 運行的Javascript創建了一個名為Android的接口。這時候，你的web app就能訪問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會自動讓它可以為你的web頁面所用。所以，在按下按鈕的時候，showAndroidToast() 函數會用這個Android接口來調用 JavaScriptInterface.showToast() 方法。

注意：綁定到你的Javascript的對象在另一個線程中運行，而不是在創建它的線程中運行。

小心：使用 addJavascriptInterface()可以讓Javascript控制你的Android應用。這是一把雙刃劍，有用的同時也可能帶來安全威脅。當WebView 中的HTML不可信時(例如，HTML的部分或者全部都是由一個未知的人或者進程提供的)，那么一個攻擊者就可能使用HTML來執行客戶端的任何他想要的代碼。因此，不應該使用addJavascriptInterface() ，除非WebView中的所有HTML以及Javascript都是你自己寫的。你同樣不應該讓用戶在你的WebView可以定向到另外一個不是你自己的web頁面上去(相反，讓用戶的默認瀏覽器應用打開外部鏈接——用戶瀏覽器默認打開所有URL鏈接，因此一定要小心處理頁面導航，像下面一節所描述的那樣。)

處理頁面導航

當用戶點擊一個WebView中的頁面的鏈接時，默認是讓Android啟動一個可以處理URL的應用。通常，是由默認的瀏覽器打開并加載目標URL的。然而，你可以在 WebView中覆蓋這一行為，那么鏈接就會在WebView中打開。這樣，你就可以讓用戶通過保存在WebView中的瀏覽記錄前進或者后退了。

要想讓用戶可以通過點擊打開鏈接，只需要使用 setWebViewClient()為WebView提供一個 WebViewClient即可。例如：

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; 
} 
} 

然后為 WebView創建一個新的 WebViewClient的實例。

WebView myWebView = (WebView) findViewById(R.id.webview); 
myWebView.setWebViewClient(new MyWebViewClient()); 

現在當用戶點擊鏈接的時候，系統會調用shouldOverrideUrlLoading()，來檢查URL host是否和某個特定的域匹配(如上面的定義)。如果匹配，那么該方法就返回false，不去覆蓋URL加載(它仍然讓WebView 像往常一樣加載URL)。如果不匹配，那么就會創建一個Intent來加載默認活動(default Activity)來處理URLs(通過用戶默認的web瀏覽器解析)。

歷史記錄導航

當你的 WebView覆蓋了URL加載，它會自動生成歷史訪問記錄。你可以通過 goBack() 或 goForward()向前或向后訪問已訪問過的站點。

例如，下面的代碼實現了通過 Activity來利用設備的后退按鈕來向后導航：

@Override 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
// Check if the key event was the BACK key 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()什么都不會做。