文檔內(nèi)容

將 WebView 加入你的應(yīng)用

¨     在Webview中使用 JavaScript

¨     啟用 JavaScript

¨     將 JavaScript代碼綁定到Android代碼

處理頁面導(dǎo)航

¨    歷史記錄導(dǎo)航

關(guān)鍵的類

WebView

WebSettings

WebViewClient

相關(guān)手冊

Web View

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

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

另外一個使用WebView的場景是你為用戶提供的數(shù)據(jù)時需要連接網(wǎng)絡(luò)來獲取數(shù)據(jù)，比如email。在這種情況下，你可能會發(fā)現(xiàn)在Android應(yīng)用中構(gòu)建一個WebView來展現(xiàn)提供相關(guān)數(shù)據(jù)的web頁面更為容易，而不是試圖連接到網(wǎng)絡(luò)獲取數(shù)據(jù)，解析數(shù)據(jù)并將其安置到Android布局中。你可以設(shè)計一個專供Android設(shè)備使用的web頁面，并在Android中實現(xiàn)一個WebView來加載這個頁面。

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

將 WebView 加入你的應(yīng)用

要在你的應(yīng)用中加入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"); 

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

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

這就是你要應(yīng)用一個WebView 來展現(xiàn)web頁面基本的所要做的所有事情了。

在WebView中使用JavaScript

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

啟用JavaScript

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

例如：

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

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

將JavaScript 代碼綁定到Android 代碼

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

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

例如：你可以在你的Android應(yīng)用中包括如下類：

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()方法來創(chuàng)建一個Toast 消息。

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

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

這段代碼為在WebView 運行的Javascript創(chuàng)建了一個名為Android的接口。這時候，你的web app就能訪問JavaScriptInterface 類了。例如，下面是一些HTML以及Javascript，在用戶敲擊按鈕的時候，它們使用這個新接口創(chuàng)建一個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() 函數(shù)會用這個Android接口來調(diào)用 JavaScriptInterface.showToast() 方法。

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

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

處理頁面導(dǎo)航

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

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

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

這樣就可以了。現(xiàn)在所有用戶點擊的鏈接都會直接在WebView中加載了。

如果你想要對于加載的鏈接的位置有更多控制，你可以創(chuàng)建自己的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創(chuàng)建一個新的 WebViewClient的實例。

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

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

歷史記錄導(dǎo)航

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

例如，下面的代碼實現(xiàn)了通過 Activity來利用設(shè)備的后退按鈕來向后導(dǎo)航：

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