概覽
- 在你的Android應用佈局中使用
WebView
來展現web頁面 - 你可以創建從Javascript到客戶端Android代碼的接口
文檔內容
¨
歷史記錄導航
關鍵的類
相關手冊
如果你想發佈一個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>
元素即可。例如,下面是一個佈局文件,在這個文件中,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 booleanonKeyDown
(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()
什麼都不會做。
原文鏈接:Building Web Apps in WebView