史上最全Android WebView使用
如果本文幫助到你,本人不勝榮幸,如果浪費了你的時間,本人深感抱歉。
希望用最簡單的大白話來幫助那些像我一樣的人。如果有什麼錯誤,請一定指出,以免誤導大家、也誤導我。
本文來自:http://www.jianshu.com/users/320f9e8f7fc9/latest_articles
感謝您的關注。
WebView在現在的專案中使用的頻率應該還是非常高的。
我個人總覺得HTML5是一種趨勢。找了一些東西,在此總結。
本篇最後有一個非常不錯 的 Html5Activity 載入類,不想看的可以直接跳下載。
WebSettings
WebSettings webSettings = mWebView .getSettings();
// 支援獲取手勢焦點,輸入使用者名稱、密碼或其他
webview.requestFocusFromTouch();
setJavaScriptEnabled(true); //支援js
setPluginsEnabled(true); //支援外掛
設定自適應螢幕,兩者合用
setUseWideViewPort(true); //將圖片調整到適合webview的大小
setLoadWithOverviewMode(true); // 縮放至螢幕的大小
setSupportZoom(true); //支援縮放,預設為true。是下面那個的前提。
setBuiltInZoomControls(true ); //設定內建的縮放控制元件。
若上面是false,則該WebView不可縮放,這個不管設定什麼都不能縮放。
setDisplayZoomControls(false); //隱藏原生的縮放控制元件
setLayoutAlgorithm(LayoutAlgorithm.SINGLE_COLUMN); //支援內容重新佈局
supportMultipleWindows(); //多視窗
setCacheMode(WebSettings.LOAD_CACHE_ELSE_NETWORK); //關閉webview中快取
setAllowFileAccess(true); //設定可以訪問檔案
setNeedInitialFocus(true ); //當webview呼叫requestFocus時為webview設定節點
setJavaScriptCanOpenWindowsAutomatically(true); //支援通過JS開啟新視窗
setLoadsImagesAutomatically(true); //支援自動載入圖片
setDefaultTextEncodingName("utf-8");//設定編碼格式
載入方式
載入一個網頁:
webView.loadUrl("http://www.google.com/");
載入apk包中的一個html頁面
webView.loadUrl("file:///android_asset/test.html");
載入手機本地的一個html頁面的方法:
webView.loadUrl("content://com.android.htmlfileprovider/sdcard/test.html");
WebViewClient
WebViewClient就是幫助WebView處理各種通知、請求事件的。
開啟網頁時不呼叫系統瀏覽器, 而是在本WebView中顯示:
mWebView.setWebViewClient(new WebViewClient(){
@Override
public boolean shouldOverrideUrlLoading(WebView view, String url) {
view.loadUrl(url);
return true;
}
});
WebViewClient方法
WebViewClient mWebViewClient = new WebViewClient()
{
shouldOverrideUrlLoading(WebView view, String url) 最常用的,比如上面的。
//在網頁上的所有載入都經過這個方法,這個函式我們可以做很多操作。
//比如獲取url,檢視url.contains(“add”),進行新增操作
shouldOverrideKeyEvent(WebView view, KeyEvent event)
//重寫此方法才能夠處理在瀏覽器中的按鍵事件。
onPageStarted(WebView view, String url, Bitmap favicon)
//這個事件就是開始載入頁面呼叫的,我們可以設定一個loading的頁面,告訴使用者程式在等待網路響應。
onPageFinished(WebView view, String url)
//在頁面載入結束時呼叫。同樣道理,我們可以關閉loading 條,切換程式動作。
onLoadResource(WebView view, String url)
// 在載入頁面資源時會呼叫,每一個資源(比如圖片)的載入都會呼叫一次。
onReceivedError(WebView view, int errorCode, String description, String failingUrl)
// (報告錯誤資訊)
doUpdateVisitedHistory(WebView view, String url, boolean isReload)
//(更新歷史記錄)
onFormResubmission(WebView view, Message dontResend, Message resend)
//(應用程式重新請求網頁資料)
onReceivedHttpAuthRequest(WebView view, HttpAuthHandler handler, String host,String realm)
//(獲取返回資訊授權請求)
onReceivedSslError(WebView view, SslErrorHandler handler, SslError error)
//重寫此方法可以讓webview處理https請求。
onScaleChanged(WebView view, float oldScale, float newScale)
// (WebView發生改變時呼叫)
onUnhandledKeyEvent(WebView view, KeyEvent event)
//(Key事件未被載入時呼叫)
}
將上面定義的WebViewClient設定給WebView:
webView.setWebViewClient(webViewClient);
WebChromeClient
WebChromeClient是輔助WebView處理Javascript的對話方塊,網站圖示,網站title,載入進度等 :
方法中的程式碼都是由Android端自己處理。
WebChromeClient mWebChromeClient = new WebChromeClient() {
//獲得網頁的載入進度,顯示在右上角的TextView控制元件中
@Override
public void onProgressChanged(WebView view, int newProgress) {
if (newProgress < 100) {
String progress = newProgress + "%";
} else {
}
}
//獲取Web頁中的title用來設定自己介面中的title
//當加載出錯的時候,比如無網路,這時onReceiveTitle中獲取的標題為 找不到該網頁,
//因此建議當觸發onReceiveError時,不要使用獲取到的title
@Override
public void onReceivedTitle(WebView view, String title) {
MainActivity.this.setTitle(title);
}
@Override
public void onReceivedIcon(WebView view, Bitmap icon) {
//
}
@Override
public boolean onCreateWindow(WebView view, boolean isDialog, boolean isUserGesture, Message resultMsg) {
//
return true;
}
@Override
public void onCloseWindow(WebView window) {
}
//處理alert彈出框,html 彈框的一種方式
@Override
public boolean onJsAlert(WebView view, String url, String message, JsResult result) {
//
return true;
}
//處理confirm彈出框
@Override
public boolean onJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult
result) {
//
return true;
}
//處理prompt彈出框
@Override
public boolean onJsConfirm(WebView view, String url, String message, JsResult result) {
//
return true;
}
};
同樣,將上面定義的WebChromeClient設定給WebView:
webView.setWebChromeClient(mWebChromeClient);
呼叫JS程式碼
WebSettings webSettings = mWebView .getSettings();
webSettings.setJavaScriptEnabled(true);
mWebView.addJavascriptInterface(new InsertObj(), "jsObj");
上面這是前提!!!
然後實現上面的類,這個類提供了四個方法,註釋的非常清楚。
class InsertObj extends Object {
//給html提供的方法,js中可以通過:var str = window.jsObj.HtmlcallJava(); 獲取到
@JavascriptInterface
public String HtmlcallJava() {
return "Html call Java";
}
//給html提供的有參函式 : window.jsObj.HtmlcallJava2("IT-homer blog");
@JavascriptInterface
public String HtmlcallJava2(final String param) {
return "Html call Java : " + param;
}
//Html給我們提供的函式
@JavascriptInterface
public void JavacallHtml() {
runOnUiThread(new Runnable() {
@Override
public void run() {
//這裡是呼叫方法
mWebView.loadUrl("javascript: showFromHtml()");
Toast.makeText(Html5Activity.this, "clickBtn", Toast.LENGTH_SHORT).show();
}
});
}
//Html給我們提供的有參函式
@JavascriptInterface
public void JavacallHtml2(final String param) {
runOnUiThread(new Runnable() {
@Override
public void run() {
mWebView.loadUrl("javascript: showFromHtml2('IT-homer blog')");
Toast.makeText(Html5Activity.this, "clickBtn2", Toast.LENGTH_SHORT).show();
}
});
}
}
WebView的方法
前進、後退
goBack()//後退
goForward()//前進
goBackOrForward(intsteps) //以當前的index為起始點前進或者後退到歷史記錄中指定的steps,
如果steps為負數則為後退,正數則為前進
canGoForward()//是否可以前進
canGoBack() //是否可以後退
清除快取資料:
clearCache(true);//清除網頁訪問留下的快取,由於核心快取是全域性的因此這個方法不僅僅針對webview而是針對整個應用程式.
clearHistory()//清除當前webview訪問的歷史記錄,只會webview訪問歷史記錄裡的所有記錄除了當前訪問記錄.
clearFormData()//這個api僅僅清除自動完成填充的表單資料,並不會清除WebView儲存到本地的資料。
WebView的狀態:
onResume() //啟用WebView為活躍狀態,能正常執行網頁的響應
onPause()//當頁面被失去焦點被切換到後臺不可見狀態,需要執行onPause動過, onPause動作通知核心暫停所有的動作,比如DOM的解析、plugin的執行、JavaScript執行。
pauseTimers()//當應用程式被切換到後臺我們使用了webview, 這個方法不僅僅針對當前的webview而是全域性的全應用程式的webview,它會暫停所有webview的layout,parsing,javascripttimer。降低CPU功耗。
resumeTimers()//恢復pauseTimers時的動作。
destroy()//銷燬,關閉了Activity時,音樂或視訊,還在播放。就必須銷燬。
但是注意:
webview呼叫destory時,webview仍繫結在Activity上.這是由於自定義webview構建時傳入了該Activity的context物件,因此需要先從父容器中移除webview,然後再銷燬webview:
rootLayout.removeView(webView);
webView.destroy();
判斷WebView是否已經滾動到頁面底端 或者 頂端:
getScrollY() //方法返回的是當前可見區域的頂端距整個頁面頂端的距離,也就是當前內容滾動的距離.
getHeight()或者getBottom() //方法都返回當前WebView這個容器的高度
getContentHeight()返回的是整個html的高度,但並不等同於當前整個頁面的高度,因為WebView有縮放功能,所以當前整個頁面的高度實際上應該是原始html的高度再乘上縮放比例.因此,更正後的結果,準確的判斷方法應該是:
if (webView.getContentHeight() * webView.getScale() == (webView.getHeight() + webView.getScrollY())) {
//已經處於底端
}
if(webView.getScrollY() == 0){
//處於頂端
}
避免WebView記憶體洩露的一些方式
1.可以將 Webview 的 Activity 新起一個程序,結束的時候直接System.exit(0);退出當前程序;
啟動新程序,主要程式碼: AndroidManifest.xml 配置檔案程式碼如下
<activity
android:name=".ui.activity.Html5Activity"
android:process=":lyl.boon.process.web">
<intent-filter>
<action android:name="com.lyl.boon.ui.activity.htmlactivity"/>
<category android:name="android.intent.category.DEFAULT"/>
</intent-filter>
</activity>
在新程序中啟動 Activity ,裡面傳了 一個 Url:
Intent intent = new Intent("com.lyl.boon.ui.activity.htmlactivity");
Bundle bundle = new Bundle();
bundle.putString("url", gankDataEntity.getUrl());
intent.putExtra("bundle",bundle);
startActivity(intent);
然後在 Html5Activity 的onDestory() 最後加上 System.exit(0); 殺死當前程序。
2.不能在xml中定義 Webview ,而是在需要的時候建立,並且Context使用 getApplicationgContext(),如下程式碼:
LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT);
mWebView = new WebView(getApplicationContext());
mWebView.setLayoutParams(params);
mLayout.addView(mWebView);
3.在 Activity 銷燬的時候,可以先讓 WebView 載入null內容,然後移除 WebView,再銷燬 WebView,最後置空。
程式碼如下:
@Override
protected void onDestroy() {
if (mWebView != null) {
mWebView.loadDataWithBaseURL(null, "", "text/html", "utf-8", null);
mWebView.clearHistory();
((ViewGroup) mWebView.getParent()).removeView(mWebView);
mWebView.destroy();
mWebView = null;
}
super.onDestroy();
}
返回鍵
返回上一次瀏覽的頁面
public boolean onKeyDown(int keyCode, KeyEvent event) {
if ((keyCode == KeyEvent.KEYCODE_BACK) && mWebView.canGoBack()) {
mWebView.goBack();
return true;
}
return super.onKeyDown(keyCode, event);
}
有一個非常不錯的 Html5Activity 載入類帖出來:
package com.lyl.web;
import android.graphics.Bitmap;
import android.os.Bundle;
import android.os.Message;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.view.KeyEvent;
import android.webkit.GeolocationPermissions;
import android.webkit.WebChromeClient;
import android.webkit.WebSettings;
import android.webkit.WebView;
import android.webkit.WebViewClient;
import com.lyl.test.R;
public class Html5Activity extends AppCompatActivity {
private String mUrl;
private LinearLayout mLayout;
private WebView mWebView;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_web);
Bundle bundle = getIntent().getBundleExtra("bundle");
mUrl = bundle.getString("url");
Log.d("Url:", mUrl);
mLayout = (LinearLayout) findViewById(R.id.web_layout);
LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT);
mWebView = new WebView(getApplicationContext());
mWebView.setLayoutParams(params);
mLayout.addView(mWebView);
WebSettings mWebSettings = mWebView.getSettings();
mWebSettings.setSupportZoom(true);
mWebSettings.setLoadWithOverviewMode(true);
mWebSettings.setUseWideViewPort(true);
mWebSettings.setDefaultTextEncodingName("utf-8");
mWebSettings.setLoadsImagesAutomatically(true);
//呼叫JS方法.安卓版本大於17,加上註解 @JavascriptInterface
mWebSettings.setJavaScriptEnabled(true);
saveData(mWebSettings);
newWin(mWebSettings);
mWebView.setWebChromeClient(webChromeClient);
mWebView.setWebViewClient(webViewClient);
mWebView.loadUrl(mUrl);
}
/**
* 多視窗的問題
*/
private void newWin(WebSettings mWebSettings) {
//html中的_bank標籤就是新建視窗開啟,有時會打不開,需要加以下
//然後 複寫 WebChromeClient的onCreateWindow方法
mWebSettings.setSupportMultipleWindows(true);
mWebSettings.setJavaScriptCanOpenWindowsAutomatically(true);
}
/**
* HTML5資料儲存
*/
private void saveData(WebSettings mWebSettings) {
//有時候網頁需要自己儲存一些關鍵資料,Android WebView 需要自己設定
mWebSettings.setDomStorageEnabled(true);
mWebSettings.setDatabaseEnabled(true);
mWebSettings.setAppCacheEnabled(true);
String appCachePath = getApplicationContext().getCacheDir().getAbsolutePath();
mWebSettings.setAppCachePath(appCachePath);
}
WebViewClient webViewClient = new WebViewClient(){
/**
* 多頁面在同一個WebView中開啟,就是不新建activity或者呼叫系統瀏覽器開啟
*/
@Override
public boolean shouldOverrideUrlLoading(WebView view, String url) {
view.loadUrl(url);
return true;
}
};
WebChromeClient webChromeClient = new WebChromeClient() {
//=========HTML5定位==========================================================
//需要先加入許可權
//<uses-permission android:name="android.permission.INTERNET"/>
//<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
//<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
@Override
public void onReceivedIcon(WebView view, Bitmap icon) {
super.onReceivedIcon(view, icon);
}
@Override
public void onGeolocationPermissionsHidePrompt() {
super.onGeolocationPermissionsHidePrompt();
}
@Override
public void onGeolocationPermissionsShowPrompt(final String origin, final GeolocationPermissions.Callback callback) {
callback.invoke(origin, true, false);//注意個函式,第二個引數就是是否同意定位許可權,第三個是是否希望核心記住
super.onGeolocationPermissionsShowPrompt(origin, callback);
}
//=========HTML5定位==========================================================
//=========多視窗的問題==========================================================
@Override
public boolean onCreateWindow(WebView view, boolean isDialog, boolean isUserGesture, Message resultMsg) {
WebView.WebViewTransport transport = (WebView.WebViewTransport) resultMsg.obj;
transport.setWebView(mWebView);
resultMsg.sendToTarget();
return true;
}
//=========多視窗的問題==========================================================
};
@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
if (keyCode == KeyEvent.KEYCODE_BACK && mWebView.canGoBack()) {
mWebView.goBack();
return true;
}
return super.onKeyDown(keyCode, event);
}
@Override
protected void onDestroy() {
if (mWebView != null) {
mWebView.loadDataWithBaseURL(null, "", "text/html", "utf-8", null);
mWebView.clearHistory();
((ViewGroup) mWebView.getParent()).removeView(mWebView);
mWebView.destroy();
mWebView = null;
}
super.onDestroy();
}
}
文/Wing_Li(簡書作者)
原文連結:http://www.jianshu.com/p/3fcf8ba18d7f
著作權歸作者所有,轉載請聯絡作者獲得授權,並標註“簡書作者”。