1. 從 WebView 談起我們?yōu)槭裁葱枰苿踊ヂ?lián)網(wǎng)發(fā)展至今原生應(yīng)用的速度與體驗(yàn)有其天然優(yōu)勢但 H5 頁面在動態(tài)化、跨平臺和運(yùn)營迭代方面擁有不可替代的地位。無論是電商詳情頁、活動落地頁、圖文混排文章還是內(nèi)嵌的 H5 游戲我們都很難繞開一個核心控件WebView。Android WebView 從最初基于 WebKit 的精簡封裝到如今依托 Chromium 內(nèi)核獨(dú)立演進(jìn)其功能邊界一直在不斷擴(kuò)大坑也在不斷增加。本文試圖用超過兩萬字的篇幅對 Android WebView 進(jìn)行系統(tǒng)且深入的全集講解從基礎(chǔ)使用、WebSettings 配置、WebViewClient 與 WebChromeClient 自定義到 JavaScript 交互、生命周期管理、緩存機(jī)制、性能優(yōu)化、安全防護(hù)再到獨(dú)立進(jìn)程、多進(jìn)程 WebView 和未來可替代方案力求覆蓋一線開發(fā)中會遇到的絕大部分問題。讀完本文你將能夠理解 WebView 加載流程與核心回調(diào)鏈路熟練配置 WebSettings平衡功能與安全掌握 JavaScript 雙向通信的多種方案與最新方案設(shè)計健壯的 WebView 頁面生命周期管理策略找到 WebView 內(nèi)存泄漏的根因并治理使用離線包、攔截加載等方式優(yōu)化首屏加載速度構(gòu)建安全可靠的 WebView 容器防范常見攻擊了解 Android WebView 未來的演進(jìn)方向。文章較長建議先收藏再按章節(jié)閱讀代碼示例均可在 Android 項目中直接運(yùn)行。2. WebView 的基本使用從 Hello World 開始WebView 的初始使用門檻很低但很多看似簡單的代碼背后都藏有未來可能爆炸的隱患。我們先從最基礎(chǔ)的加載開始。在布局文件中添加 WebViewWebView android:idid/webview android:layout_widthmatch_parent android:layout_heightmatch_parent /在 Activity 或 Fragment 中初始化WebView webView findViewById(R.id.webview); webView.loadUrl(https://www.example.com);這三行代碼已經(jīng)可以讓一個網(wǎng)頁展示出來但為了讓它穩(wěn)定運(yùn)行我們至少還需要補(bǔ)充三件事啟用 JavaScript 支持、自定義 WebViewClient 處理頁面跳轉(zhuǎn)、以及在合適的生命周期節(jié)點(diǎn)上管理 WebView 的狀態(tài)。如果忽略這些你會很快遇到以下典型問題點(diǎn)擊頁面內(nèi)鏈接會拉起系統(tǒng)瀏覽器頁面中的 JavaScript 完全不可用按 Home 鍵后再返回WebView 內(nèi)容丟失。一個更完備的初始化模板如下WebView webView findViewById(R.id.webview); WebSettings settings webView.getSettings(); settings.setJavaScriptEnabled(true); settings.setDomStorageEnabled(true); settings.setUseWideViewPort(true); settings.setLoadWithOverviewMode(true); webView.setWebViewClient(new WebViewClient() { Override public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) { view.loadUrl(request.getUrl().toString()); return true; } }); webView.setWebChromeClient(new WebChromeClient()); webView.loadUrl(https://www.example.com);上述模板中我們僅啟用了最基本的配置。接下來我們深入 WebSettings 的每一個配置項了解它們各自的影響范圍和適用場景。3. WebSettings 全配置解析WebSettings 是管理 WebView 狀態(tài)的配置中心幾乎所有影響 WebView 行為、性能和安全的關(guān)鍵開關(guān)都在這里。WebSettings 的實(shí)例通過webView.getSettings()獲取它的內(nèi)部默認(rèn)值隨 Android 版本和 WebView 實(shí)現(xiàn)不同而變化不要依賴默認(rèn)值應(yīng)該按需顯式設(shè)置。3.1 JavaScript 相關(guān)配置// 啟用 JavaScript 執(zhí)行默認(rèn) false settings.setJavaScriptEnabled(true); // 允許 JavaScript 打開新窗口如 window.open默認(rèn) false settings.setJavaScriptCanOpenWindowsAutomatically(true);關(guān)于setJavaScriptEnabled官方文檔明確指出禁用狀態(tài)下的 WebView 不會執(zhí)行任何 JavaScript這可以有效減少攻擊面但現(xiàn)代頁面幾乎都依賴 JS 渲染關(guān)閉會導(dǎo)致頁面白屏或功能殘廢。因此大部分情況下我們必須開啟但需要在 WebViewClient 的shouldInterceptRequest中配合請求過濾來保障安全。3.2 頁面適配與縮放// 使用寬視口推薦開啟讓頁面按設(shè)備寬度渲染 settings.setUseWideViewPort(true); // 縮放至屏幕寬度推薦開啟在 loadUrl 時自動縮放 settings.setLoadWithOverviewMode(true); // 是否支持縮放 settings.setSupportZoom(true); settings.setBuiltInZoomControls(true); // 隱藏原生縮放控件推薦隱藏避免 UI 沖突 settings.setDisplayZoomControls(false); // 文字縮放百分比默認(rèn) 100 settings.setTextZoom(100);移動端頁面大多通過meta nameviewport聲明視口寬度此時setUseWideViewPort配合setLoadWithOverviewMode能保證頁面按預(yù)期適配屏幕。對于 PC 版頁面開啟縮放支持是必要的逃生手段。需要注意部分 Android 版本的 WebView 在縮放后會出現(xiàn)觸摸偏移問題建議在測試時覆蓋多種系統(tǒng)版本。3.3 存儲與緩存// DOM 存儲如 localStorage推薦開啟 settings.setDomStorageEnabled(true); // 應(yīng)用緩存API 已廢棄不推薦使用 settings.setAppCacheEnabled(false); // 數(shù)據(jù)庫存儲默認(rèn) true一般保持即可 settings.setDatabaseEnabled(true); // 設(shè)置存儲路徑 String dbPath context.getDir(databases, Context.MODE_PRIVATE).getPath(); settings.setDatabasePath(dbPath);DOM Storage是當(dāng)前使用最廣泛的客戶端存儲方式務(wù)必開啟。而 AppCache 已在標(biāo)準(zhǔn)層面被 Service Worker 取代Android WebView 中也已 deprecated不建議開啟。3.4 文件訪問// 允許訪問文件默認(rèn) true存在安全風(fēng)險 settings.setAllowFileAccess(false); // 允許通過 file:// 加載其他資源默認(rèn) true settings.setAllowFileAccessFromFileURLs(false); // 允許通過 file:// 加載的 JS 訪問通用文件默認(rèn) true settings.setAllowUniversalAccessFromFileURLs(false);這三個設(shè)置是與安全密切相關(guān)的核心配置。setAllowFileAccess若開啟WebView 中的 JS 可能通過file://協(xié)議讀取應(yīng)用私有目錄下的敏感文件。如果你的 WebView 只用于加載遠(yuǎn)程頁面應(yīng)全部設(shè)為 false。如果確實(shí)需要加載本地 HTML應(yīng)使用loadDataWithBaseURL或應(yīng)用內(nèi)置的 HTTP Server 方案并配合安全域名白名單進(jìn)行嚴(yán)格限制。3.5 圖片與資源加載// 自動加載圖片默認(rèn) true settings.setLoadsImagesAutomatically(true); // 阻止圖片加載以節(jié)省流量 settings.setBlockNetworkImage(false); // 混合內(nèi)容模式Android 5.0 if (Build.VERSION.SDK_INT Build.VERSION_CODES.LOLLIPOP) { settings.setMixedContentMode(WebSettings.MIXED_CONTENT_NEVER_ALLOW); }setMixedContentMode控制 HTTPS 頁面中是否允許加載 HTTP 資源。生產(chǎn)環(huán)境應(yīng)設(shè)置為MIXED_CONTENT_NEVER_ALLOW以防止中間人攻擊。如果業(yè)務(wù)側(cè)確實(shí)存在混合內(nèi)容過渡期至少使用MIXED_CONTENT_COMPATIBILITY_MODE但絕不推薦MIXED_CONTENT_ALWAYS_ALLOW。3.6 其他重要配置// 設(shè)置默認(rèn)字體大小 settings.setDefaultFontSize(16); // 設(shè)置最小字體大小 settings.setMinimumFontSize(8); // 設(shè)置默認(rèn)等寬字體大小 settings.setDefaultFixedFontSize(13); // 是否阻止網(wǎng)絡(luò)加載可用于離線模式 settings.setBlockNetworkLoads(false); // 設(shè)置 User-Agent String ua settings.getUserAgentString(); settings.setUserAgentString(ua MyApp/1.0); // 設(shè)置默認(rèn)文本編碼 settings.setDefaultTextEncodingName(utf-8); // 地理定位 settings.setGeolocationEnabled(false); // 是否需要保存表單數(shù)據(jù) settings.setSaveFormData(false); // 設(shè)置 layout 算法NORMAL 或 SINGLE_COLUMN后者已廢棄 settings.setLayoutAlgorithm(WebSettings.LayoutAlgorithm.NORMAL); // 是否允許內(nèi)容 URL 訪問content:// 協(xié)議 settings.setAllowContentAccess(true); // 是否在加載過程中顯示縮放控件已廢棄 settings.setLoadWithOverviewMode(true); // 是否需要觸摸焦點(diǎn) webView.requestFocus(View.FOCUS_DOWN);設(shè)置 User-Agent 時務(wù)必在系統(tǒng)默認(rèn) UA 尾部追加而不是替換。直接覆蓋會影響 H5 側(cè)的設(shè)備識別與兼容性邏輯。修改后的 UA 可以用于區(qū)分 WebView 流量與瀏覽器流量方便后端進(jìn)行統(tǒng)計分析。4. WebViewClient加載全流程攔截與控制WebViewClient 是 WebView 加載流程中最重要的攔截器它決定了 URL 在 WebView 內(nèi)部的走向。幾乎所有與頁面導(dǎo)航、資源加載和錯誤處理相關(guān)的邏輯都通過 WebViewClient 的回調(diào)實(shí)現(xiàn)。不設(shè)置 WebViewClient 的 WebView 會在用戶點(diǎn)擊鏈接時跳轉(zhuǎn)到系統(tǒng)默認(rèn)瀏覽器破壞應(yīng)用內(nèi)體驗(yàn)。4.1 shouldOverrideUrlLoading這是開發(fā)者最熟悉的回調(diào)在每次頁面導(dǎo)航前觸發(fā)。返回 true 表示攔截本次加載通常用來處理自定義協(xié)議或內(nèi)部路由跳轉(zhuǎn)返回 false默認(rèn)表示交給 WebView 繼續(xù)加載。Android 7.0 以前使用舊版 APIOverride public boolean shouldOverrideUrlLoading(WebView view, String url) { if (url.startsWith(myapp://)) { // 處理自定義 scheme handleCustomScheme(url); return true; } return false; }Android 7.0API 24及以上推薦覆寫新版 API它可以拿到完整的WebResourceRequest包括請求方法、請求頭等信息Override public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) { Uri uri request.getUrl(); if (myapp.equals(uri.getScheme())) { handleCustomUri(uri); return true; } if (uri.getHost().equals(www.example.com)) { // 在白名單內(nèi)的域名交給 WebView 處理 return false; } // 其他域名跳系統(tǒng)瀏覽器 Intent intent new Intent(Intent.ACTION_VIEW, uri); view.getContext().startActivity(intent); return true; }注意如果你的 WebView 沒有調(diào)用view.loadUrl(url)并返回 trueWebView 不會自己加載該 URL。如果希望留在 WebView 內(nèi)且不做額外操作直接返回 false 即可。4.2 onPageStarted / onPageFinished頁面開始加載和加載完成的回調(diào)。這兩個回調(diào)用于展示和隱藏進(jìn)度條但不要以為onPageFinished就代表頁面所有內(nèi)容都渲染完畢它只表示主 frame 的 HTML 加載完成異步資源圖片、JS、CSS可能還在加載中。Override public void onPageStarted(WebView view, String url, Bitmap favicon) { progressBar.setVisibility(View.VISIBLE); } Override public void onPageFinished(WebView view, String url) { progressBar.setVisibility(View.GONE); }當(dāng)頁面中存在 iframe 時onPageStarted和onPageFinished可能會被多次調(diào)用因?yàn)?iframe 內(nèi)部的導(dǎo)航也會觸發(fā)這些回調(diào)?？梢酝ㄟ^WebResourceRequest.isForMainFrame()來判斷是否為主 frame 請求但這兩者本身不直接攜帶WebResourceRequest。更精確的做法是在shouldInterceptRequest中統(tǒng)計資源加載數(shù)量或在onProgressChanged中判斷進(jìn)度到達(dá) 100% 時才隱藏進(jìn)度條。4.3 shouldInterceptRequest這是資源攔截的強(qiáng)大武器。WebView 中的每一次資源請求HTML、JS、CSS、圖片、字體等都會經(jīng)過shouldInterceptRequest你可以在此返回一個自定義的WebResourceResponse從而實(shí)現(xiàn)離線包加載、資源替換、請求攔截等功能。Override public WebResourceResponse shouldInterceptRequest(WebView view, WebResourceRequest request) { String url request.getUrl().toString(); if (isOfflineResource(url)) { try { InputStream is getOfflineResourceStream(url); return new WebResourceResponse(text/javascript, UTF-8, is); } catch (Exception e) { return null; } } return super.shouldInterceptRequest(view, request); }使用shouldInterceptRequest時注意返回 null 會讓 WebView 走正常網(wǎng)絡(luò)加載流程同步的 I/O 操作和復(fù)雜邏輯可能阻塞 UI 線程如果資源特別多需要在設(shè)計上控制攔截粒度或把邏輯放到異步線程然后通過shouldInterceptRequest的同步返回提供預(yù)緩存內(nèi)容。4.4 錯誤處理頁面加載錯誤時的回調(diào)。早期版本是onReceivedErrorAndroid 8.0API 26之后分為onReceivedError(WebView, WebResourceRequest, WebResourceError)和已廢棄的舊版。對于主 frame 加載錯誤通常需要展示自定義錯誤頁面Override public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) { if (request.isForMainFrame()) { showErrorPage(view, error.getErrorCode(), error.getDescription().toString()); } } private void showErrorPage(WebView view, int errorCode, String description) { String errorHtml htmlbodyh2頁面加載失敗/h2p description /p/body/html; view.loadDataWithBaseURL(null, errorHtml, text/html, UTF-8, null); }另外還有一個容易忽視的回調(diào)onReceivedSslError用于處理 SSL 證書錯誤。生產(chǎn)環(huán)境絕不要在此回調(diào)中調(diào)用handler.proceed()忽略證書問題這會讓應(yīng)用面臨中間人攻擊風(fēng)險。如果確實(shí)有調(diào)試需求應(yīng)在 Debug 構(gòu)建中臨時處理。4.5 其他有用回調(diào)onLoadResource頁面中每加載一個資源都會回調(diào)用于統(tǒng)計資源數(shù)量或診斷加載慢的資源。doUpdateVisitedHistory可用于構(gòu)建 WebView 內(nèi)部的導(dǎo)航棧實(shí)現(xiàn)真正的“返回上一頁”而非關(guān)閉 Activity。onFormResubmission當(dāng)用戶通過返回鍵回到一個 POST 頁面時觸發(fā)應(yīng)提示用戶是否重新提交表單。5. WebChromeClientUI 與交互的橋梁如果說 WebViewClient 專注于頁面加載和資源控制那么 WebChromeClient 就是負(fù)責(zé)與 UI 交互處理 JS 彈窗、標(biāo)題變化、文件選擇、權(quán)限請求以及全屏視頻等 Web 內(nèi)容相關(guān)的瀏覽器行為。5.1 onProgressChanged頁面加載進(jìn)度回調(diào)用于展示真實(shí)的加載進(jìn)度條Override public void onProgressChanged(WebView view, int newProgress) { if (newProgress 100) { progressBar.setVisibility(View.GONE); } else { progressBar.setVisibility(View.VISIBLE); progressBar.setProgress(newProgress); } }這個回調(diào)比onPageFinished更準(zhǔn)確地反映頁面加載的完成狀態(tài)當(dāng)進(jìn)度達(dá)到 100 時主資源和大部分子資源都已加載完成。但如果有長時間輪詢或 WebSocket 連接進(jìn)度條可能一直在 90% 左右晃動需要額外處理。5.2 onReceivedTitle頁面標(biāo)題改變時觸發(fā)適合動態(tài)更新 ActionBar 或 Toolbar 的標(biāo)題Override public void onReceivedTitle(WebView view, String title) { if (!TextUtils.isEmpty(title) !title.startsWith(http)) { toolbar.setTitle(title); } }某些 H5 頁面會動態(tài)設(shè)置 document.title因此這個回調(diào)在一個頁面的生命周期中可能觸發(fā)多次。5.3 JavaScript 對話框onJsAlertalert 彈窗返回 true 表示自行處理。onJsConfirmconfirm 彈窗需返回用戶的選擇結(jié)果。onJsPromptprompt 彈窗可以借此實(shí)現(xiàn) Native 與 JS 的通信后文詳述。Override public boolean onJsAlert(WebView view, String url, String message, JsResult result) { new AlertDialog.Builder(view.getContext()) .setTitle(提示) .setMessage(message) .setPositiveButton(確定, (dialog, which) - result.confirm()) .setOnCancelListener(dialog - result.cancel()) .show(); return true; }如果不覆寫這些方法WebView 不會顯示任何 JS 彈窗JavaScript 對話框功能將完全失效。但如果你全都不攔截系統(tǒng)默認(rèn)的彈窗樣式在不同 Android 版本上表現(xiàn)不一致建議統(tǒng)一使用自定義彈窗。5.4 文件選擇允許 WebView 中的input typefile觸發(fā)系統(tǒng)文件選擇器Override public boolean onShowFileChooser(WebView webView, ValueCallbackUri[] filePathCallback, FileChooserParams fileChooserParams) { this.filePathCallback filePathCallback; Intent intent fileChooserParams.createIntent(); startActivityForResult(Intent.createChooser(intent, 選擇文件), FILE_CHOOSER_REQUEST); return true; } Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { if (requestCode FILE_CHOOSER_REQUEST) { if (filePathCallback ! null) { Uri[] results WebChromeClient.FileChooserParams.parseResult(resultCode, data); filePathCallback.onReceiveValue(results); filePathCallback null; } } }Android 5.0 使用onShowFileChooser低版本則使用已廢棄的openFileChooser系列方法。應(yīng)注意filePathCallback.onReceiveValue(null)必須在某個時刻被調(diào)用否則 WebView 內(nèi)部會一直等待可能導(dǎo)致后續(xù)文件選擇無法觸發(fā)。5.5 全屏視頻WebView 中的 HTML5 視頻全屏需要通過onShowCustomView和onHideCustomView配合實(shí)現(xiàn)Override public void onShowCustomView(View view, CustomViewCallback callback) { if (customViewContainer ! null) { customViewContainer.setVisibility(View.VISIBLE); customViewContainer.addView(view); customViewCallback callback; toolbar.setVisibility(View.GONE); } } Override public void onHideCustomView() { if (customViewContainer ! null) { customViewContainer.setVisibility(View.GONE); customViewContainer.removeAllViews(); customViewCallback null; toolbar.setVisibility(View.VISIBLE); } }你需要在布局中預(yù)留一個全屏容器通常是一個覆蓋在最上層的 FrameLayout用于承載全屏視頻 View。退出全屏?xí)r務(wù)必調(diào)用customViewCallback.onCustomViewHidden()通知 WebView 狀態(tài)恢復(fù)。5.6 權(quán)限請求Android WebView 通過onPermissionRequest回調(diào)向應(yīng)用請求敏感權(quán)限如攝像頭、麥克風(fēng)、地理位置和 MIDI 設(shè)備。你必須顯式處理這些請求否則 Web API 將直接失敗。Override public void onPermissionRequest(PermissionRequest request) { for (String resource : request.getResources()) { if (PermissionRequest.RESOURCE_VIDEO_CAPTURE.equals(resource)) { // 請求攝像頭權(quán)限 requestPermissions(new String[]{Manifest.permission.CAMERA}, CAMERA_PERMISSION); this.pendingPermissionRequest request; return; } } request.deny(); }權(quán)限處理成功或失敗后必須調(diào)用request.grant(resources)或request.deny()否則 WebView 內(nèi)的頁面會無限期等待結(jié)果。6. JavaScript 與 Native 的雙向通信WebView 中最核心、也是出錯最多的一部分就是 JavaScript 與原生代碼之間的交互。Android 平臺提供了多種方案老的addJavascriptInterface、通過onJsPrompt攔截、evaluateJavascript注入 JS以及 Chrome DevTools 遠(yuǎn)程調(diào)試。6.1 addJavascriptInterfaceJSI最常用的方式將 Java 對象注入到 JS 的 window 對象下前端可以直接調(diào)用注入對象的方法class AndroidBridge { JavascriptInterface public void showToast(String message) { Toast.makeText(context, message, Toast.LENGTH_SHORT).show(); } JavascriptInterface public String getUserToken() { return tokenManager.getToken(); } } webView.addJavascriptInterface(new AndroidBridge(), android);前端調(diào)用window.android.showToast(Hello from H5); const token window.android.getUserToken();安全警告Android 4.2API 17之前任何 public 方法都可以被 JS 調(diào)用導(dǎo)致嚴(yán)重的安全漏洞。從 API 17 開始只有標(biāo)記了JavascriptInterface的方法才會暴露給 JS但僅靠注解仍不夠。你還要確保不要將敏感對象注入到 WebView確保被注入的頁面是你完全控制的不要在第三方頁面加載時注入 JSI 對象注入的對象方法中校驗(yàn)調(diào)用來源如檢查 URL 白名單。6.2 evaluateJavascript從 Native 調(diào)用 JS 方法并可以獲取返回值webView.evaluateJavascript(document.title, new ValueCallbackString() { Override public void onReceiveValue(String value) { Log.d(WebView, Title: value); } });注意evaluateJavascript必須在 UI 線程調(diào)用且頁面 JS 環(huán)境就緒后才有效。返回值的類型是 JSON 格式的字符串需要手動解析。對于沒有返回值的純執(zhí)行調(diào)用可以傳入 null 作為回調(diào)。6.3 利用 onJsPrompt 實(shí)現(xiàn)通信這是一種繞過addJavascriptInterface限制的通信方式。前端調(diào)用prompt(method:params)Native 在onJsPrompt中攔截特定前綴的消息并處理。這種方式更安全因?yàn)椴槐┞?Java 對象只傳遞字符串參數(shù)Override public boolean onJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult result) { if (message.startsWith(native:)) { String resultData handleNativeCall(message.substring(7)); result.confirm(resultData); return true; } return super.onJsPrompt(view, url, message, defaultValue, result); }這種方式最早在微信 JS-SDK 中流行具有良好的兼容性適用于跨平臺 H5 容器的底層通信設(shè)計。6.4 WebView 調(diào)試Android 調(diào)試 WebView 離不開 Chrome DevTools。在應(yīng)用中開啟if (Build.VERSION.SDK_INT Build.VERSION_CODES.KITKAT) { if (BuildConfig.DEBUG) { WebView.setWebContentsDebuggingEnabled(true); } }然后在 Chrome 地址欄輸入chrome://inspect即可看到當(dāng)前連接設(shè)備的 WebView 實(shí)例點(diǎn)擊 inspect 即可進(jìn)入完整的 DevTools 界面。你可以看到控制臺輸出、網(wǎng)絡(luò)請求、DOM 結(jié)構(gòu)甚至可以實(shí)時修改頁面元素調(diào)試效率遠(yuǎn)超打日志。7. WebView 生命周期與內(nèi)存管理WebView 的生命周期管理不當(dāng)是 Android 內(nèi)存泄漏的重災(zāi)區(qū)。很多開發(fā)者抱怨“用了 WebView 之后 Activity 無法回收”根源往往在于 WebView 的初始化和銷毀時機(jī)不對。7.1 正確的生命周期方法WebView 需要響應(yīng) Activity 或 Fragment 的生命周期變化尤其是onPause、onResume和onDestroyOverride protected void onResume() { super.onResume(); if (webView ! null) { webView.onResume(); webView.resumeTimers(); } } Override protected void onPause() { super.onPause(); if (webView ! null) { webView.onPause(); webView.pauseTimers(); } } Override protected void onDestroy() { if (webView ! null) { ViewGroup parent (ViewGroup) webView.getParent(); if (parent ! null) { parent.removeView(webView); } webView.loadUrl(about:blank); webView.stopLoading(); webView.setWebChromeClient(null); webView.setWebViewClient(null); webView.removeAllViews(); webView.destroy(); webView null; } super.onDestroy(); }關(guān)鍵細(xì)節(jié)webView.destroy()必須放在removeView之后調(diào)用必須在銷毀前將 WebViewClient 和 WebChromeClient 置為 null切斷引用鏈loadUrl(about:blank)可以提前釋放 WebView 內(nèi)部的渲染資源在單獨(dú)的 Activity 中使用 WebView 是一個良好的隔離策略即使 WebView 出現(xiàn)內(nèi)存問題也只會影響它所在的 Activity不會污染整個應(yīng)用。7.2 Application Context 的陷阱很多開發(fā)者為了“避免 Activity 泄漏”使用Application Context創(chuàng)建 WebViewWebView webView new WebView(getApplicationContext());這實(shí)際上破壞了 WebView 對 Activity 上下文的一些隱式依賴可能導(dǎo)致彈出對話框崩潰、無法正確獲取主題樣式等問題。更推薦的做法是使用 Activity 上下文但在銷毀時嚴(yán)格按照上述步驟清理。如果你必須在非 Activity 場景使用 WebView如全局預(yù)加載池則需要額外處理這些上下文依賴問題。7.3 獨(dú)立進(jìn)程 WebViewAndroid 從 7.0API 24開始支持將 WebView 運(yùn)行在獨(dú)立進(jìn)程通過AndroidManifest.xml配置provider android:nameandroidx.webkit.WebViewRenderProcessProvider android:process:webview_process /獨(dú)立進(jìn)程的最大好處是隔離崩潰和隔離內(nèi)存。當(dāng) WebView 所在進(jìn)程因?yàn)轫撁?Bug 或內(nèi)存不足崩潰時不會影響主進(jìn)程。但劣勢也比較明顯跨進(jìn)程通信帶來額外開銷創(chuàng)建新進(jìn)程會增加冷啟動耗時需要權(quán)衡利弊后使用。如果你的應(yīng)用中 WebView 是核心高頻功能且頁面復(fù)雜獨(dú)立進(jìn)程非常值得投入。8. WebView 性能優(yōu)化WebView 性能直接決定 H5 頁面的用戶體驗(yàn)。優(yōu)化方向主要包括加載速度首屏白屏?xí)r間、渲染流暢度滾動與動畫幀率以及資源占用CPU/內(nèi)存/電量。8.1 首屏加載優(yōu)化預(yù)創(chuàng)建 WebViewWebView 的初始化成本很高可以通過預(yù)創(chuàng)建 WebView 池來減少首屏等待。在一個獨(dú)立的 Application 初始化階段或后臺線程中預(yù)先創(chuàng)建好 WebView 實(shí)例需要使用時直接從池中獲取。public class WebViewPool { private static QueueWebView pool new LinkedList(); public static void warmUp(Context context) { new Handler(Looper.getMainLooper()).post(() -gt; { WebView webView new WebView(context); webView.loadUrl(about:blank); pool.offer(webView); }); } public static WebView obtain(Context context) { WebView webView pool.poll(); return webView ! null ? webView : new WebView(context); } }離線包與資源攔截通過shouldInterceptRequest將頁面資源映射到本地 APK 內(nèi)置或下載好的離線包是當(dāng)前大多數(shù)大型 App 的標(biāo)準(zhǔn)做法。通常的策略是HTML/JS/CSS 走本地離線包API 數(shù)據(jù)走實(shí)時網(wǎng)絡(luò)請求圖片按需加載。DNS 預(yù)解析與連接預(yù)建// 在應(yīng)用啟動階段或即將打開 WebView 頁面之前調(diào)用 webView.getSettings().setNeedInitialFocus(true); // 使用 OkHttp 或其他網(wǎng)絡(luò)庫預(yù)先建立連接 OkHttpClient client new OkHttpClient(); Request request new Request.Builder().url(https://www.example.com).head().build(); client.newCall(request).enqueue(new Callback() { ... });延遲加載非關(guān)鍵資源通過setBlockNetworkImage可以在頁面加載過程中先阻止圖片加載等主內(nèi)容渲染完畢后再放開settings.setBlockNetworkImage(true); webView.setWebViewClient(new WebViewClient() { Override public void onPageFinished(WebView view, String url) { settings.setBlockNetworkImage(false); } });8.2 渲染優(yōu)化開啟硬件加速默認(rèn)情況下 WebView 使用硬件加速但如果你的應(yīng)用在某個地方關(guān)閉了硬件加速會導(dǎo)致 WebView 滾動時嚴(yán)重卡頓?？梢栽?Activity 級別或 Window 級別確保開啟getWindow().setFlags( WindowManager.LayoutParams.FLAG_HARDWARE_ACCELERATED, WindowManager.LayoutParams.FLAG_HARDWARE_ACCELERATED);減少布局嵌套WebView 自身就是一個復(fù)雜的 View盡量不要將它嵌套在多層 Layout 中避免過度的onMeasure和onLayout調(diào)用。合理使用 WebView 的 layout 屬性避免wrap_content導(dǎo)致多次測量建議使用0dpweight或明確的寬高值。8.3 內(nèi)存優(yōu)化WebView 的內(nèi)存消耗主要由 Chromium 內(nèi)核引起無法從應(yīng)用層完全消除但可以通過以下手段控制使用獨(dú)立進(jìn)程隔離內(nèi)存退出頁面時直接殺進(jìn)程徹底釋放減少同時存在的 WebView 實(shí)例數(shù)量定期調(diào)用webView.freeMemory()已廢棄但某些版本仍有一定效果對于不再需要的 WebView及時執(zhí)行 destroy 流程。9. WebView 安全實(shí)踐WebView 安全是移動安全體系中容易被低估的一環(huán)但實(shí)際上它是攻擊者進(jìn)入應(yīng)用內(nèi)部的重要入口。以下安全實(shí)踐建議逐條對照檢查項目代碼。9.1 文件訪問控制settings.setAllowFileAccess(false); settings.setAllowFileAccessFromFileURLs(false); settings.setAllowUniversalAccessFromFileURLs(false);這三項是 WebView 安全的第一道防線關(guān)閉后可以防止大部分通過文件協(xié)議進(jìn)行的跨域攻擊。如果必須加載本地文件請使用loadDataWithBaseURL并限制 baseURL 的有效范圍。9.2 HTTPS 與證書校驗(yàn)在onReceivedSslError中絕不調(diào)用proceed()。如果需要信任自簽名證書僅限內(nèi)網(wǎng)測試環(huán)境應(yīng)使用Network Security Config方案!-- res/xml/network_security_config.xml -- network-security-config domain-config cleartextTrafficPermittedfalse domain includeSubdomainstrueyourdomain.com/domain trust-anchors certificates srcraw/my_ca / /trust-anchors /domain-config /network-security-config9.3 JavaScript 接口安全只對可信頁面使用addJavascriptInterface標(biāo)記所有暴露方法為JavascriptInterface避免通過 JSI 暴露可能導(dǎo)致越權(quán)操作的方法如反射調(diào)用、文件讀寫、動態(tài)加載代碼使用 onJsPrompt 等非注入式通信作為更安全的選擇。9.4 防止釣魚與頁面?zhèn)卧煸趕houldOverrideUrlLoading中對頁面跳轉(zhuǎn) URL 進(jìn)行白名單校驗(yàn)任何不在白名單內(nèi)的域名都應(yīng)拉起系統(tǒng)瀏覽器或彈窗提示用戶。特別注意不要僅檢查 URL 前綴攻擊者可以通過構(gòu)造形如https://www.yourdomain.com.attacker.com的鏈接繞過簡單檢查。9.5 WebView 跨域與 Cookie 安全WebView 默認(rèn)遵循同源策略但部分業(yè)務(wù)可能因?yàn)椤胺奖恪倍P(guān)閉跨域限制。這相當(dāng)于把整個應(yīng)用的 Cookie 和存儲暴露給所有頁面極其危險。如果你的業(yè)務(wù)需要跨域處理應(yīng)通過 Native 層轉(zhuǎn)發(fā)請求來實(shí)現(xiàn)可控的跨域訪問而不是直接在 WebView 層面放行。10. 高級話題與實(shí)戰(zhàn)踩坑10.1 WebView 多進(jìn)程架構(gòu)Chromium 本身是多進(jìn)程架構(gòu)但 Android 上的 WebView 默認(rèn)與宿主應(yīng)用共享主進(jìn)程。當(dāng) WebView 內(nèi)容崩潰時例如 OOM 或 GPU 進(jìn)程掛掉整個應(yīng)用都會受到影響。從 Android 8.0API 26開始Google 逐步推進(jìn) WebView 的多進(jìn)程隔離開發(fā)者可以通過 AndroidManifest 和應(yīng)用設(shè)置來顯式開啟if (Build.VERSION.SDK_INT Build.VERSION_CODES.O) { // 開啟多進(jìn)程模式 WebView.startSafeBrowsing(context, new ValueCallbackBoolean() { Override public void onReceiveValue(Boolean value) { // 回調(diào) } }); }多進(jìn)程 WebView 模式下每個 WebView 實(shí)例可能會被分配到不同的渲染進(jìn)程進(jìn)一步提升了穩(wěn)定性但也會導(dǎo)致進(jìn)程間 Cookie 共享、存儲同步變得復(fù)雜。如果你的應(yīng)用使用了自定義 Cookie 管理邏輯需要全面回歸測試。10.2 WebView 加載本地頁面有三種主要方式加載本地 HTMLloadUrl(file:///android_asset/...)適用于固定資源需要允許文件訪問loadDataWithBaseURL適用于動態(tài)生成的內(nèi)容自定義 HTTP Server在應(yīng)用本地啟動一個微型 HTTP 服務(wù)器使用http://localhost加載安全性更好且無文件訪問風(fēng)險。10.3 請求頭與 Cookie 管理某些業(yè)務(wù)場景需要在 WebView 的請求中附加特定的 Header如 Token但 WebView 沒有全局 Header 注入機(jī)制。常見做法是在loadUrl時使用額外的 Header 參數(shù)MapString, String headers new HashMap(); headers.put(Authorization, Bearer token); webView.loadUrl(https://www.example.com, headers);但這只對主 frame 的首次請求生效后續(xù)的子請求和頁面內(nèi)跳轉(zhuǎn)均不會攜帶這些 Header。若需要持續(xù)注入 Header需要使用shouldInterceptRequest攔截所有請求并附加 Header 后重新發(fā)起這會增加額外延遲或者通過 Cookie 傳遞 Token因?yàn)?Cookie 會被自動附加到同域請求中。CookieManager cookieManager CookieManager.getInstance(); cookieManager.setAcceptCookie(true); cookieManager.setCookie(https://www.example.com, token token); if (Build.VERSION.SDK_INT Build.VERSION_CODES.LOLLIPOP) { cookieManager.flush(); }10.4 WebView 中的鍵盤處理WebView 內(nèi) H5 表單的軟鍵盤彈出和收起經(jīng)常引發(fā)布局異常尤其是在全屏 WebView 場景下。可以通過在 AndroidManifest 中設(shè)置android:windowSoftInputModeadjustResize并配合 WebView 的setOnTouchListener和自定義 JavaScript 監(jiān)聽window.visualViewport的變化來解決。10.5 常見崩潰與排查WebView 相關(guān)的常見崩潰包括Native Crash in libwebviewchromium.so一般由頁面 GPU 渲染異常引起嘗試關(guān)閉硬件加速定位java.lang.NullPointerException at WebView.destroy()通常是 WebView 已被提前回收但再次調(diào)用了 destroyRender process crash在獨(dú)立進(jìn)程或多進(jìn)程模式下渲染進(jìn)程可能因?yàn)轫撁孢^量內(nèi)存消耗被殺需要在 WebViewClient 的onRenderProcessGone中處理恢復(fù)邏輯。Override public boolean onRenderProcessGone(WebView view, RenderProcessGoneDetail detail) { if (!detail.didCrash()) { // 系統(tǒng)主動結(jié)束不是崩潰可以重新創(chuàng)建 WebView recreateWebView(); return true; } // 真的崩潰了展示錯誤頁面 showCrashError(view); return true; }11. 第三方 WebView 增強(qiáng)庫概述Android 原生 WebView API 在各版本間差異較大很多高級特性只有在較高版本才可用。Jetpack 中的androidx.webkit庫為開發(fā)者提供了向下兼容的 API強(qiáng)烈推薦引入。dependencies { implementation androidx.webkit:webkit:1.7.0 }關(guān)鍵 API 示例WebViewCompat提供兼容版本的 WebView 方法WebViewFeature檢測當(dāng)前 WebView 實(shí)現(xiàn)是否支持某項特性ProxyController為 WebView 設(shè)置代理TracingController用于性能分析追蹤。另外還有騰訊的 X5 WebViewTBS它提供了一套基于 Chromium 的增強(qiáng) WebView 內(nèi)核主要解決舊設(shè)備上系統(tǒng) WebView 版本過低的問題并增加了文件瀏覽、長截圖等擴(kuò)展能力。但隨著 Android 系統(tǒng) WebView 的快速迭代和高版本覆蓋率的提升TBS 的優(yōu)勢正在被削弱引入它需要額外承擔(dān)幾十 MB 的內(nèi)核包體積需要按業(yè)務(wù)需求評估。12. 總結(jié)與展望本文系統(tǒng)性地梳理了 Android WebView 從基礎(chǔ)到進(jìn)階的方方面面總計超過兩萬字。我們覆蓋了 WebSettings 的每一個關(guān)鍵配置、WebViewClient 與 WebChromeClient 的全套回調(diào)、JavaScript 雙端通信的多種方案、生命周期與內(nèi)存管理的實(shí)戰(zhàn)策略、性能優(yōu)化的具體手段以及安全實(shí)踐的每一條紅線。在實(shí)際項目中沒有一種萬能的 WebView 方案能適配所有業(yè)務(wù)。一個優(yōu)秀的 WebView 容器設(shè)計應(yīng)該是分層的底層提供穩(wěn)定、安全、高性能的內(nèi)核封裝中間層提供離線包、請求攔截、Cookie 管理等通用能力上層由具體業(yè)務(wù)定制加載策略和交互邏輯。保持每一層的職責(zé)清晰才能在快速迭代中避免牽一發(fā)而動全身。展望未來隨著 Android 與 ChromeOS 的逐步融合WebView 的能力還將進(jìn)一步增強(qiáng)。WebAssembly、WebAuthn、Trusted Web ActivityTWA等新技術(shù)正在把 Web 容器的應(yīng)用邊界推向更遠(yuǎn)的地方。掌握好 WebView 的底層原理才能在這些新浪潮中游刃有余。希望這篇文章能成為你 Android 開發(fā)路上的手邊參考如果覺得有幫助歡迎收藏、轉(zhuǎn)發(fā)并在實(shí)際項目中檢驗(yàn)這些實(shí)踐。 Android WebView 全集
1. 從 WebView 談起我們?yōu)槭裁葱枰苿踊ヂ?lián)網(wǎng)發(fā)展至今原生應(yīng)用的速度與體驗(yàn)有其天然優(yōu)勢但 H5 頁面在動態(tài)化、跨平臺和運(yùn)營迭代方面擁有不可替代的地位。無論是電商詳情頁、活動落地頁、圖文混排文章還是內(nèi)嵌的 H5 游戲我們都很難繞開一個核心控件WebView。Android WebView 從最初基于 WebKit 的精簡封裝到如今依托 Chromium 內(nèi)核獨(dú)立演進(jìn)其功能邊界一直在不斷擴(kuò)大坑也在不斷增加。本文試圖用超過兩萬字的篇幅對 Android WebView 進(jìn)行系統(tǒng)且深入的全集講解從基礎(chǔ)使用、WebSettings 配置、WebViewClient 與 WebChromeClient 自定義到 JavaScript 交互、生命周期管理、緩存機(jī)制、性能優(yōu)化、安全防護(hù)再到獨(dú)立進(jìn)程、多進(jìn)程 WebView 和未來可替代方案力求覆蓋一線開發(fā)中會遇到的絕大部分問題。讀完本文你將能夠理解 WebView 加載流程與核心回調(diào)鏈路熟練配置 WebSettings平衡功能與安全掌握 JavaScript 雙向通信的多種方案與最新方案設(shè)計健壯的 WebView 頁面生命周期管理策略找到 WebView 內(nèi)存泄漏的根因并治理使用離線包、攔截加載等方式優(yōu)化首屏加載速度構(gòu)建安全可靠的 WebView 容器防范常見攻擊了解 Android WebView 未來的演進(jìn)方向。文章較長建議先收藏再按章節(jié)閱讀代碼示例均可在 Android 項目中直接運(yùn)行。2. WebView 的基本使用從 Hello World 開始WebView 的初始使用門檻很低但很多看似簡單的代碼背后都藏有未來可能爆炸的隱患。我們先從最基礎(chǔ)的加載開始。在布局文件中添加 WebViewWebView android:idid/webview android:layout_widthmatch_parent android:layout_heightmatch_parent /在 Activity 或 Fragment 中初始化WebView webView findViewById(R.id.webview); webView.loadUrl(https://www.example.com);這三行代碼已經(jīng)可以讓一個網(wǎng)頁展示出來但為了讓它穩(wěn)定運(yùn)行我們至少還需要補(bǔ)充三件事啟用 JavaScript 支持、自定義 WebViewClient 處理頁面跳轉(zhuǎn)、以及在合適的生命周期節(jié)點(diǎn)上管理 WebView 的狀態(tài)。如果忽略這些你會很快遇到以下典型問題點(diǎn)擊頁面內(nèi)鏈接會拉起系統(tǒng)瀏覽器頁面中的 JavaScript 完全不可用按 Home 鍵后再返回WebView 內(nèi)容丟失。一個更完備的初始化模板如下WebView webView findViewById(R.id.webview); WebSettings settings webView.getSettings(); settings.setJavaScriptEnabled(true); settings.setDomStorageEnabled(true); settings.setUseWideViewPort(true); settings.setLoadWithOverviewMode(true); webView.setWebViewClient(new WebViewClient() { Override public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) { view.loadUrl(request.getUrl().toString()); return true; } }); webView.setWebChromeClient(new WebChromeClient()); webView.loadUrl(https://www.example.com);上述模板中我們僅啟用了最基本的配置。接下來我們深入 WebSettings 的每一個配置項了解它們各自的影響范圍和適用場景。3. WebSettings 全配置解析WebSettings 是管理 WebView 狀態(tài)的配置中心幾乎所有影響 WebView 行為、性能和安全的關(guān)鍵開關(guān)都在這里。WebSettings 的實(shí)例通過webView.getSettings()獲取它的內(nèi)部默認(rèn)值隨 Android 版本和 WebView 實(shí)現(xiàn)不同而變化不要依賴默認(rèn)值應(yīng)該按需顯式設(shè)置。3.1 JavaScript 相關(guān)配置// 啟用 JavaScript 執(zhí)行默認(rèn) false settings.setJavaScriptEnabled(true); // 允許 JavaScript 打開新窗口如 window.open默認(rèn) false settings.setJavaScriptCanOpenWindowsAutomatically(true);關(guān)于setJavaScriptEnabled官方文檔明確指出禁用狀態(tài)下的 WebView 不會執(zhí)行任何 JavaScript這可以有效減少攻擊面但現(xiàn)代頁面幾乎都依賴 JS 渲染關(guān)閉會導(dǎo)致頁面白屏或功能殘廢。因此大部分情況下我們必須開啟但需要在 WebViewClient 的shouldInterceptRequest中配合請求過濾來保障安全。3.2 頁面適配與縮放// 使用寬視口推薦開啟讓頁面按設(shè)備寬度渲染 settings.setUseWideViewPort(true); // 縮放至屏幕寬度推薦開啟在 loadUrl 時自動縮放 settings.setLoadWithOverviewMode(true); // 是否支持縮放 settings.setSupportZoom(true); settings.setBuiltInZoomControls(true); // 隱藏原生縮放控件推薦隱藏避免 UI 沖突 settings.setDisplayZoomControls(false); // 文字縮放百分比默認(rèn) 100 settings.setTextZoom(100);移動端頁面大多通過meta nameviewport聲明視口寬度此時setUseWideViewPort配合setLoadWithOverviewMode能保證頁面按預(yù)期適配屏幕。對于 PC 版頁面開啟縮放支持是必要的逃生手段。需要注意部分 Android 版本的 WebView 在縮放后會出現(xiàn)觸摸偏移問題建議在測試時覆蓋多種系統(tǒng)版本。3.3 存儲與緩存// DOM 存儲如 localStorage推薦開啟 settings.setDomStorageEnabled(true); // 應(yīng)用緩存API 已廢棄不推薦使用 settings.setAppCacheEnabled(false); // 數(shù)據(jù)庫存儲默認(rèn) true一般保持即可 settings.setDatabaseEnabled(true); // 設(shè)置存儲路徑 String dbPath context.getDir(databases, Context.MODE_PRIVATE).getPath(); settings.setDatabasePath(dbPath);DOM Storage是當(dāng)前使用最廣泛的客戶端存儲方式務(wù)必開啟。而 AppCache 已在標(biāo)準(zhǔn)層面被 Service Worker 取代Android WebView 中也已 deprecated不建議開啟。3.4 文件訪問// 允許訪問文件默認(rèn) true存在安全風(fēng)險 settings.setAllowFileAccess(false); // 允許通過 file:// 加載其他資源默認(rèn) true settings.setAllowFileAccessFromFileURLs(false); // 允許通過 file:// 加載的 JS 訪問通用文件默認(rèn) true settings.setAllowUniversalAccessFromFileURLs(false);這三個設(shè)置是與安全密切相關(guān)的核心配置。setAllowFileAccess若開啟WebView 中的 JS 可能通過file://協(xié)議讀取應(yīng)用私有目錄下的敏感文件。如果你的 WebView 只用于加載遠(yuǎn)程頁面應(yīng)全部設(shè)為 false。如果確實(shí)需要加載本地 HTML應(yīng)使用loadDataWithBaseURL或應(yīng)用內(nèi)置的 HTTP Server 方案并配合安全域名白名單進(jìn)行嚴(yán)格限制。3.5 圖片與資源加載// 自動加載圖片默認(rèn) true settings.setLoadsImagesAutomatically(true); // 阻止圖片加載以節(jié)省流量 settings.setBlockNetworkImage(false); // 混合內(nèi)容模式Android 5.0 if (Build.VERSION.SDK_INT Build.VERSION_CODES.LOLLIPOP) { settings.setMixedContentMode(WebSettings.MIXED_CONTENT_NEVER_ALLOW); }setMixedContentMode控制 HTTPS 頁面中是否允許加載 HTTP 資源。生產(chǎn)環(huán)境應(yīng)設(shè)置為MIXED_CONTENT_NEVER_ALLOW以防止中間人攻擊。如果業(yè)務(wù)側(cè)確實(shí)存在混合內(nèi)容過渡期至少使用MIXED_CONTENT_COMPATIBILITY_MODE但絕不推薦MIXED_CONTENT_ALWAYS_ALLOW。3.6 其他重要配置// 設(shè)置默認(rèn)字體大小 settings.setDefaultFontSize(16); // 設(shè)置最小字體大小 settings.setMinimumFontSize(8); // 設(shè)置默認(rèn)等寬字體大小 settings.setDefaultFixedFontSize(13); // 是否阻止網(wǎng)絡(luò)加載可用于離線模式 settings.setBlockNetworkLoads(false); // 設(shè)置 User-Agent String ua settings.getUserAgentString(); settings.setUserAgentString(ua MyApp/1.0); // 設(shè)置默認(rèn)文本編碼 settings.setDefaultTextEncodingName(utf-8); // 地理定位 settings.setGeolocationEnabled(false); // 是否需要保存表單數(shù)據(jù) settings.setSaveFormData(false); // 設(shè)置 layout 算法NORMAL 或 SINGLE_COLUMN后者已廢棄 settings.setLayoutAlgorithm(WebSettings.LayoutAlgorithm.NORMAL); // 是否允許內(nèi)容 URL 訪問content:// 協(xié)議 settings.setAllowContentAccess(true); // 是否在加載過程中顯示縮放控件已廢棄 settings.setLoadWithOverviewMode(true); // 是否需要觸摸焦點(diǎn) webView.requestFocus(View.FOCUS_DOWN);設(shè)置 User-Agent 時務(wù)必在系統(tǒng)默認(rèn) UA 尾部追加而不是替換。直接覆蓋會影響 H5 側(cè)的設(shè)備識別與兼容性邏輯。修改后的 UA 可以用于區(qū)分 WebView 流量與瀏覽器流量方便后端進(jìn)行統(tǒng)計分析。4. WebViewClient加載全流程攔截與控制WebViewClient 是 WebView 加載流程中最重要的攔截器它決定了 URL 在 WebView 內(nèi)部的走向。幾乎所有與頁面導(dǎo)航、資源加載和錯誤處理相關(guān)的邏輯都通過 WebViewClient 的回調(diào)實(shí)現(xiàn)。不設(shè)置 WebViewClient 的 WebView 會在用戶點(diǎn)擊鏈接時跳轉(zhuǎn)到系統(tǒng)默認(rèn)瀏覽器破壞應(yīng)用內(nèi)體驗(yàn)。4.1 shouldOverrideUrlLoading這是開發(fā)者最熟悉的回調(diào)在每次頁面導(dǎo)航前觸發(fā)。返回 true 表示攔截本次加載通常用來處理自定義協(xié)議或內(nèi)部路由跳轉(zhuǎn)返回 false默認(rèn)表示交給 WebView 繼續(xù)加載。Android 7.0 以前使用舊版 APIOverride public boolean shouldOverrideUrlLoading(WebView view, String url) { if (url.startsWith(myapp://)) { // 處理自定義 scheme handleCustomScheme(url); return true; } return false; }Android 7.0API 24及以上推薦覆寫新版 API它可以拿到完整的WebResourceRequest包括請求方法、請求頭等信息Override public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) { Uri uri request.getUrl(); if (myapp.equals(uri.getScheme())) { handleCustomUri(uri); return true; } if (uri.getHost().equals(www.example.com)) { // 在白名單內(nèi)的域名交給 WebView 處理 return false; } // 其他域名跳系統(tǒng)瀏覽器 Intent intent new Intent(Intent.ACTION_VIEW, uri); view.getContext().startActivity(intent); return true; }注意如果你的 WebView 沒有調(diào)用view.loadUrl(url)并返回 trueWebView 不會自己加載該 URL。如果希望留在 WebView 內(nèi)且不做額外操作直接返回 false 即可。4.2 onPageStarted / onPageFinished頁面開始加載和加載完成的回調(diào)。這兩個回調(diào)用于展示和隱藏進(jìn)度條但不要以為onPageFinished就代表頁面所有內(nèi)容都渲染完畢它只表示主 frame 的 HTML 加載完成異步資源圖片、JS、CSS可能還在加載中。Override public void onPageStarted(WebView view, String url, Bitmap favicon) { progressBar.setVisibility(View.VISIBLE); } Override public void onPageFinished(WebView view, String url) { progressBar.setVisibility(View.GONE); }當(dāng)頁面中存在 iframe 時onPageStarted和onPageFinished可能會被多次調(diào)用因?yàn)?iframe 內(nèi)部的導(dǎo)航也會觸發(fā)這些回調(diào)?？梢酝ㄟ^WebResourceRequest.isForMainFrame()來判斷是否為主 frame 請求但這兩者本身不直接攜帶WebResourceRequest。更精確的做法是在shouldInterceptRequest中統(tǒng)計資源加載數(shù)量或在onProgressChanged中判斷進(jìn)度到達(dá) 100% 時才隱藏進(jìn)度條。4.3 shouldInterceptRequest這是資源攔截的強(qiáng)大武器。WebView 中的每一次資源請求HTML、JS、CSS、圖片、字體等都會經(jīng)過shouldInterceptRequest你可以在此返回一個自定義的WebResourceResponse從而實(shí)現(xiàn)離線包加載、資源替換、請求攔截等功能。Override public WebResourceResponse shouldInterceptRequest(WebView view, WebResourceRequest request) { String url request.getUrl().toString(); if (isOfflineResource(url)) { try { InputStream is getOfflineResourceStream(url); return new WebResourceResponse(text/javascript, UTF-8, is); } catch (Exception e) { return null; } } return super.shouldInterceptRequest(view, request); }使用shouldInterceptRequest時注意返回 null 會讓 WebView 走正常網(wǎng)絡(luò)加載流程同步的 I/O 操作和復(fù)雜邏輯可能阻塞 UI 線程如果資源特別多需要在設(shè)計上控制攔截粒度或把邏輯放到異步線程然后通過shouldInterceptRequest的同步返回提供預(yù)緩存內(nèi)容。4.4 錯誤處理頁面加載錯誤時的回調(diào)。早期版本是onReceivedErrorAndroid 8.0API 26之后分為onReceivedError(WebView, WebResourceRequest, WebResourceError)和已廢棄的舊版。對于主 frame 加載錯誤通常需要展示自定義錯誤頁面Override public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) { if (request.isForMainFrame()) { showErrorPage(view, error.getErrorCode(), error.getDescription().toString()); } } private void showErrorPage(WebView view, int errorCode, String description) { String errorHtml htmlbodyh2頁面加載失敗/h2p description /p/body/html; view.loadDataWithBaseURL(null, errorHtml, text/html, UTF-8, null); }另外還有一個容易忽視的回調(diào)onReceivedSslError用于處理 SSL 證書錯誤。生產(chǎn)環(huán)境絕不要在此回調(diào)中調(diào)用handler.proceed()忽略證書問題這會讓應(yīng)用面臨中間人攻擊風(fēng)險。如果確實(shí)有調(diào)試需求應(yīng)在 Debug 構(gòu)建中臨時處理。4.5 其他有用回調(diào)onLoadResource頁面中每加載一個資源都會回調(diào)用于統(tǒng)計資源數(shù)量或診斷加載慢的資源。doUpdateVisitedHistory可用于構(gòu)建 WebView 內(nèi)部的導(dǎo)航棧實(shí)現(xiàn)真正的“返回上一頁”而非關(guān)閉 Activity。onFormResubmission當(dāng)用戶通過返回鍵回到一個 POST 頁面時觸發(fā)應(yīng)提示用戶是否重新提交表單。5. WebChromeClientUI 與交互的橋梁如果說 WebViewClient 專注于頁面加載和資源控制那么 WebChromeClient 就是負(fù)責(zé)與 UI 交互處理 JS 彈窗、標(biāo)題變化、文件選擇、權(quán)限請求以及全屏視頻等 Web 內(nèi)容相關(guān)的瀏覽器行為。5.1 onProgressChanged頁面加載進(jìn)度回調(diào)用于展示真實(shí)的加載進(jìn)度條Override public void onProgressChanged(WebView view, int newProgress) { if (newProgress 100) { progressBar.setVisibility(View.GONE); } else { progressBar.setVisibility(View.VISIBLE); progressBar.setProgress(newProgress); } }這個回調(diào)比onPageFinished更準(zhǔn)確地反映頁面加載的完成狀態(tài)當(dāng)進(jìn)度達(dá)到 100 時主資源和大部分子資源都已加載完成。但如果有長時間輪詢或 WebSocket 連接進(jìn)度條可能一直在 90% 左右晃動需要額外處理。5.2 onReceivedTitle頁面標(biāo)題改變時觸發(fā)適合動態(tài)更新 ActionBar 或 Toolbar 的標(biāo)題Override public void onReceivedTitle(WebView view, String title) { if (!TextUtils.isEmpty(title) !title.startsWith(http)) { toolbar.setTitle(title); } }某些 H5 頁面會動態(tài)設(shè)置 document.title因此這個回調(diào)在一個頁面的生命周期中可能觸發(fā)多次。5.3 JavaScript 對話框onJsAlertalert 彈窗返回 true 表示自行處理。onJsConfirmconfirm 彈窗需返回用戶的選擇結(jié)果。onJsPromptprompt 彈窗可以借此實(shí)現(xiàn) Native 與 JS 的通信后文詳述。Override public boolean onJsAlert(WebView view, String url, String message, JsResult result) { new AlertDialog.Builder(view.getContext()) .setTitle(提示) .setMessage(message) .setPositiveButton(確定, (dialog, which) - result.confirm()) .setOnCancelListener(dialog - result.cancel()) .show(); return true; }如果不覆寫這些方法WebView 不會顯示任何 JS 彈窗JavaScript 對話框功能將完全失效。但如果你全都不攔截系統(tǒng)默認(rèn)的彈窗樣式在不同 Android 版本上表現(xiàn)不一致建議統(tǒng)一使用自定義彈窗。5.4 文件選擇允許 WebView 中的input typefile觸發(fā)系統(tǒng)文件選擇器Override public boolean onShowFileChooser(WebView webView, ValueCallbackUri[] filePathCallback, FileChooserParams fileChooserParams) { this.filePathCallback filePathCallback; Intent intent fileChooserParams.createIntent(); startActivityForResult(Intent.createChooser(intent, 選擇文件), FILE_CHOOSER_REQUEST); return true; } Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { if (requestCode FILE_CHOOSER_REQUEST) { if (filePathCallback ! null) { Uri[] results WebChromeClient.FileChooserParams.parseResult(resultCode, data); filePathCallback.onReceiveValue(results); filePathCallback null; } } }Android 5.0 使用onShowFileChooser低版本則使用已廢棄的openFileChooser系列方法。應(yīng)注意filePathCallback.onReceiveValue(null)必須在某個時刻被調(diào)用否則 WebView 內(nèi)部會一直等待可能導(dǎo)致后續(xù)文件選擇無法觸發(fā)。5.5 全屏視頻WebView 中的 HTML5 視頻全屏需要通過onShowCustomView和onHideCustomView配合實(shí)現(xiàn)Override public void onShowCustomView(View view, CustomViewCallback callback) { if (customViewContainer ! null) { customViewContainer.setVisibility(View.VISIBLE); customViewContainer.addView(view); customViewCallback callback; toolbar.setVisibility(View.GONE); } } Override public void onHideCustomView() { if (customViewContainer ! null) { customViewContainer.setVisibility(View.GONE); customViewContainer.removeAllViews(); customViewCallback null; toolbar.setVisibility(View.VISIBLE); } }你需要在布局中預(yù)留一個全屏容器通常是一個覆蓋在最上層的 FrameLayout用于承載全屏視頻 View。退出全屏?xí)r務(wù)必調(diào)用customViewCallback.onCustomViewHidden()通知 WebView 狀態(tài)恢復(fù)。5.6 權(quán)限請求Android WebView 通過onPermissionRequest回調(diào)向應(yīng)用請求敏感權(quán)限如攝像頭、麥克風(fēng)、地理位置和 MIDI 設(shè)備。你必須顯式處理這些請求否則 Web API 將直接失敗。Override public void onPermissionRequest(PermissionRequest request) { for (String resource : request.getResources()) { if (PermissionRequest.RESOURCE_VIDEO_CAPTURE.equals(resource)) { // 請求攝像頭權(quán)限 requestPermissions(new String[]{Manifest.permission.CAMERA}, CAMERA_PERMISSION); this.pendingPermissionRequest request; return; } } request.deny(); }權(quán)限處理成功或失敗后必須調(diào)用request.grant(resources)或request.deny()否則 WebView 內(nèi)的頁面會無限期等待結(jié)果。6. JavaScript 與 Native 的雙向通信WebView 中最核心、也是出錯最多的一部分就是 JavaScript 與原生代碼之間的交互。Android 平臺提供了多種方案老的addJavascriptInterface、通過onJsPrompt攔截、evaluateJavascript注入 JS以及 Chrome DevTools 遠(yuǎn)程調(diào)試。6.1 addJavascriptInterfaceJSI最常用的方式將 Java 對象注入到 JS 的 window 對象下前端可以直接調(diào)用注入對象的方法class AndroidBridge { JavascriptInterface public void showToast(String message) { Toast.makeText(context, message, Toast.LENGTH_SHORT).show(); } JavascriptInterface public String getUserToken() { return tokenManager.getToken(); } } webView.addJavascriptInterface(new AndroidBridge(), android);前端調(diào)用window.android.showToast(Hello from H5); const token window.android.getUserToken();安全警告Android 4.2API 17之前任何 public 方法都可以被 JS 調(diào)用導(dǎo)致嚴(yán)重的安全漏洞。從 API 17 開始只有標(biāo)記了JavascriptInterface的方法才會暴露給 JS但僅靠注解仍不夠。你還要確保不要將敏感對象注入到 WebView確保被注入的頁面是你完全控制的不要在第三方頁面加載時注入 JSI 對象注入的對象方法中校驗(yàn)調(diào)用來源如檢查 URL 白名單。6.2 evaluateJavascript從 Native 調(diào)用 JS 方法并可以獲取返回值webView.evaluateJavascript(document.title, new ValueCallbackString() { Override public void onReceiveValue(String value) { Log.d(WebView, Title: value); } });注意evaluateJavascript必須在 UI 線程調(diào)用且頁面 JS 環(huán)境就緒后才有效。返回值的類型是 JSON 格式的字符串需要手動解析。對于沒有返回值的純執(zhí)行調(diào)用可以傳入 null 作為回調(diào)。6.3 利用 onJsPrompt 實(shí)現(xiàn)通信這是一種繞過addJavascriptInterface限制的通信方式。前端調(diào)用prompt(method:params)Native 在onJsPrompt中攔截特定前綴的消息并處理。這種方式更安全因?yàn)椴槐┞?Java 對象只傳遞字符串參數(shù)Override public boolean onJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult result) { if (message.startsWith(native:)) { String resultData handleNativeCall(message.substring(7)); result.confirm(resultData); return true; } return super.onJsPrompt(view, url, message, defaultValue, result); }這種方式最早在微信 JS-SDK 中流行具有良好的兼容性適用于跨平臺 H5 容器的底層通信設(shè)計。6.4 WebView 調(diào)試Android 調(diào)試 WebView 離不開 Chrome DevTools。在應(yīng)用中開啟if (Build.VERSION.SDK_INT Build.VERSION_CODES.KITKAT) { if (BuildConfig.DEBUG) { WebView.setWebContentsDebuggingEnabled(true); } }然后在 Chrome 地址欄輸入chrome://inspect即可看到當(dāng)前連接設(shè)備的 WebView 實(shí)例點(diǎn)擊 inspect 即可進(jìn)入完整的 DevTools 界面。你可以看到控制臺輸出、網(wǎng)絡(luò)請求、DOM 結(jié)構(gòu)甚至可以實(shí)時修改頁面元素調(diào)試效率遠(yuǎn)超打日志。7. WebView 生命周期與內(nèi)存管理WebView 的生命周期管理不當(dāng)是 Android 內(nèi)存泄漏的重災(zāi)區(qū)。很多開發(fā)者抱怨“用了 WebView 之后 Activity 無法回收”根源往往在于 WebView 的初始化和銷毀時機(jī)不對。7.1 正確的生命周期方法WebView 需要響應(yīng) Activity 或 Fragment 的生命周期變化尤其是onPause、onResume和onDestroyOverride protected void onResume() { super.onResume(); if (webView ! null) { webView.onResume(); webView.resumeTimers(); } } Override protected void onPause() { super.onPause(); if (webView ! null) { webView.onPause(); webView.pauseTimers(); } } Override protected void onDestroy() { if (webView ! null) { ViewGroup parent (ViewGroup) webView.getParent(); if (parent ! null) { parent.removeView(webView); } webView.loadUrl(about:blank); webView.stopLoading(); webView.setWebChromeClient(null); webView.setWebViewClient(null); webView.removeAllViews(); webView.destroy(); webView null; } super.onDestroy(); }關(guān)鍵細(xì)節(jié)webView.destroy()必須放在removeView之后調(diào)用必須在銷毀前將 WebViewClient 和 WebChromeClient 置為 null切斷引用鏈loadUrl(about:blank)可以提前釋放 WebView 內(nèi)部的渲染資源在單獨(dú)的 Activity 中使用 WebView 是一個良好的隔離策略即使 WebView 出現(xiàn)內(nèi)存問題也只會影響它所在的 Activity不會污染整個應(yīng)用。7.2 Application Context 的陷阱很多開發(fā)者為了“避免 Activity 泄漏”使用Application Context創(chuàng)建 WebViewWebView webView new WebView(getApplicationContext());這實(shí)際上破壞了 WebView 對 Activity 上下文的一些隱式依賴可能導(dǎo)致彈出對話框崩潰、無法正確獲取主題樣式等問題。更推薦的做法是使用 Activity 上下文但在銷毀時嚴(yán)格按照上述步驟清理。如果你必須在非 Activity 場景使用 WebView如全局預(yù)加載池則需要額外處理這些上下文依賴問題。7.3 獨(dú)立進(jìn)程 WebViewAndroid 從 7.0API 24開始支持將 WebView 運(yùn)行在獨(dú)立進(jìn)程通過AndroidManifest.xml配置provider android:nameandroidx.webkit.WebViewRenderProcessProvider android:process:webview_process /獨(dú)立進(jìn)程的最大好處是隔離崩潰和隔離內(nèi)存。當(dāng) WebView 所在進(jìn)程因?yàn)轫撁?Bug 或內(nèi)存不足崩潰時不會影響主進(jìn)程。但劣勢也比較明顯跨進(jìn)程通信帶來額外開銷創(chuàng)建新進(jìn)程會增加冷啟動耗時需要權(quán)衡利弊后使用。如果你的應(yīng)用中 WebView 是核心高頻功能且頁面復(fù)雜獨(dú)立進(jìn)程非常值得投入。8. WebView 性能優(yōu)化WebView 性能直接決定 H5 頁面的用戶體驗(yàn)。優(yōu)化方向主要包括加載速度首屏白屏?xí)r間、渲染流暢度滾動與動畫幀率以及資源占用CPU/內(nèi)存/電量。8.1 首屏加載優(yōu)化預(yù)創(chuàng)建 WebViewWebView 的初始化成本很高可以通過預(yù)創(chuàng)建 WebView 池來減少首屏等待。在一個獨(dú)立的 Application 初始化階段或后臺線程中預(yù)先創(chuàng)建好 WebView 實(shí)例需要使用時直接從池中獲取。public class WebViewPool { private static QueueWebView pool new LinkedList(); public static void warmUp(Context context) { new Handler(Looper.getMainLooper()).post(() -gt; { WebView webView new WebView(context); webView.loadUrl(about:blank); pool.offer(webView); }); } public static WebView obtain(Context context) { WebView webView pool.poll(); return webView ! null ? webView : new WebView(context); } }離線包與資源攔截通過shouldInterceptRequest將頁面資源映射到本地 APK 內(nèi)置或下載好的離線包是當(dāng)前大多數(shù)大型 App 的標(biāo)準(zhǔn)做法。通常的策略是HTML/JS/CSS 走本地離線包API 數(shù)據(jù)走實(shí)時網(wǎng)絡(luò)請求圖片按需加載。DNS 預(yù)解析與連接預(yù)建// 在應(yīng)用啟動階段或即將打開 WebView 頁面之前調(diào)用 webView.getSettings().setNeedInitialFocus(true); // 使用 OkHttp 或其他網(wǎng)絡(luò)庫預(yù)先建立連接 OkHttpClient client new OkHttpClient(); Request request new Request.Builder().url(https://www.example.com).head().build(); client.newCall(request).enqueue(new Callback() { ... });延遲加載非關(guān)鍵資源通過setBlockNetworkImage可以在頁面加載過程中先阻止圖片加載等主內(nèi)容渲染完畢后再放開settings.setBlockNetworkImage(true); webView.setWebViewClient(new WebViewClient() { Override public void onPageFinished(WebView view, String url) { settings.setBlockNetworkImage(false); } });8.2 渲染優(yōu)化開啟硬件加速默認(rèn)情況下 WebView 使用硬件加速但如果你的應(yīng)用在某個地方關(guān)閉了硬件加速會導(dǎo)致 WebView 滾動時嚴(yán)重卡頓?？梢栽?Activity 級別或 Window 級別確保開啟getWindow().setFlags( WindowManager.LayoutParams.FLAG_HARDWARE_ACCELERATED, WindowManager.LayoutParams.FLAG_HARDWARE_ACCELERATED);減少布局嵌套WebView 自身就是一個復(fù)雜的 View盡量不要將它嵌套在多層 Layout 中避免過度的onMeasure和onLayout調(diào)用。合理使用 WebView 的 layout 屬性避免wrap_content導(dǎo)致多次測量建議使用0dpweight或明確的寬高值。8.3 內(nèi)存優(yōu)化WebView 的內(nèi)存消耗主要由 Chromium 內(nèi)核引起無法從應(yīng)用層完全消除但可以通過以下手段控制使用獨(dú)立進(jìn)程隔離內(nèi)存退出頁面時直接殺進(jìn)程徹底釋放減少同時存在的 WebView 實(shí)例數(shù)量定期調(diào)用webView.freeMemory()已廢棄但某些版本仍有一定效果對于不再需要的 WebView及時執(zhí)行 destroy 流程。9. WebView 安全實(shí)踐WebView 安全是移動安全體系中容易被低估的一環(huán)但實(shí)際上它是攻擊者進(jìn)入應(yīng)用內(nèi)部的重要入口。以下安全實(shí)踐建議逐條對照檢查項目代碼。9.1 文件訪問控制settings.setAllowFileAccess(false); settings.setAllowFileAccessFromFileURLs(false); settings.setAllowUniversalAccessFromFileURLs(false);這三項是 WebView 安全的第一道防線關(guān)閉后可以防止大部分通過文件協(xié)議進(jìn)行的跨域攻擊。如果必須加載本地文件請使用loadDataWithBaseURL并限制 baseURL 的有效范圍。9.2 HTTPS 與證書校驗(yàn)在onReceivedSslError中絕不調(diào)用proceed()。如果需要信任自簽名證書僅限內(nèi)網(wǎng)測試環(huán)境應(yīng)使用Network Security Config方案!-- res/xml/network_security_config.xml -- network-security-config domain-config cleartextTrafficPermittedfalse domain includeSubdomainstrueyourdomain.com/domain trust-anchors certificates srcraw/my_ca / /trust-anchors /domain-config /network-security-config9.3 JavaScript 接口安全只對可信頁面使用addJavascriptInterface標(biāo)記所有暴露方法為JavascriptInterface避免通過 JSI 暴露可能導(dǎo)致越權(quán)操作的方法如反射調(diào)用、文件讀寫、動態(tài)加載代碼使用 onJsPrompt 等非注入式通信作為更安全的選擇。9.4 防止釣魚與頁面?zhèn)卧煸趕houldOverrideUrlLoading中對頁面跳轉(zhuǎn) URL 進(jìn)行白名單校驗(yàn)任何不在白名單內(nèi)的域名都應(yīng)拉起系統(tǒng)瀏覽器或彈窗提示用戶。特別注意不要僅檢查 URL 前綴攻擊者可以通過構(gòu)造形如https://www.yourdomain.com.attacker.com的鏈接繞過簡單檢查。9.5 WebView 跨域與 Cookie 安全WebView 默認(rèn)遵循同源策略但部分業(yè)務(wù)可能因?yàn)椤胺奖恪倍P(guān)閉跨域限制。這相當(dāng)于把整個應(yīng)用的 Cookie 和存儲暴露給所有頁面極其危險。如果你的業(yè)務(wù)需要跨域處理應(yīng)通過 Native 層轉(zhuǎn)發(fā)請求來實(shí)現(xiàn)可控的跨域訪問而不是直接在 WebView 層面放行。10. 高級話題與實(shí)戰(zhàn)踩坑10.1 WebView 多進(jìn)程架構(gòu)Chromium 本身是多進(jìn)程架構(gòu)但 Android 上的 WebView 默認(rèn)與宿主應(yīng)用共享主進(jìn)程。當(dāng) WebView 內(nèi)容崩潰時例如 OOM 或 GPU 進(jìn)程掛掉整個應(yīng)用都會受到影響。從 Android 8.0API 26開始Google 逐步推進(jìn) WebView 的多進(jìn)程隔離開發(fā)者可以通過 AndroidManifest 和應(yīng)用設(shè)置來顯式開啟if (Build.VERSION.SDK_INT Build.VERSION_CODES.O) { // 開啟多進(jìn)程模式 WebView.startSafeBrowsing(context, new ValueCallbackBoolean() { Override public void onReceiveValue(Boolean value) { // 回調(diào) } }); }多進(jìn)程 WebView 模式下每個 WebView 實(shí)例可能會被分配到不同的渲染進(jìn)程進(jìn)一步提升了穩(wěn)定性但也會導(dǎo)致進(jìn)程間 Cookie 共享、存儲同步變得復(fù)雜。如果你的應(yīng)用使用了自定義 Cookie 管理邏輯需要全面回歸測試。10.2 WebView 加載本地頁面有三種主要方式加載本地 HTMLloadUrl(file:///android_asset/...)適用于固定資源需要允許文件訪問loadDataWithBaseURL適用于動態(tài)生成的內(nèi)容自定義 HTTP Server在應(yīng)用本地啟動一個微型 HTTP 服務(wù)器使用http://localhost加載安全性更好且無文件訪問風(fēng)險。10.3 請求頭與 Cookie 管理某些業(yè)務(wù)場景需要在 WebView 的請求中附加特定的 Header如 Token但 WebView 沒有全局 Header 注入機(jī)制。常見做法是在loadUrl時使用額外的 Header 參數(shù)MapString, String headers new HashMap(); headers.put(Authorization, Bearer token); webView.loadUrl(https://www.example.com, headers);但這只對主 frame 的首次請求生效后續(xù)的子請求和頁面內(nèi)跳轉(zhuǎn)均不會攜帶這些 Header。若需要持續(xù)注入 Header需要使用shouldInterceptRequest攔截所有請求并附加 Header 后重新發(fā)起這會增加額外延遲或者通過 Cookie 傳遞 Token因?yàn)?Cookie 會被自動附加到同域請求中。CookieManager cookieManager CookieManager.getInstance(); cookieManager.setAcceptCookie(true); cookieManager.setCookie(https://www.example.com, token token); if (Build.VERSION.SDK_INT Build.VERSION_CODES.LOLLIPOP) { cookieManager.flush(); }10.4 WebView 中的鍵盤處理WebView 內(nèi) H5 表單的軟鍵盤彈出和收起經(jīng)常引發(fā)布局異常尤其是在全屏 WebView 場景下。可以通過在 AndroidManifest 中設(shè)置android:windowSoftInputModeadjustResize并配合 WebView 的setOnTouchListener和自定義 JavaScript 監(jiān)聽window.visualViewport的變化來解決。10.5 常見崩潰與排查WebView 相關(guān)的常見崩潰包括Native Crash in libwebviewchromium.so一般由頁面 GPU 渲染異常引起嘗試關(guān)閉硬件加速定位java.lang.NullPointerException at WebView.destroy()通常是 WebView 已被提前回收但再次調(diào)用了 destroyRender process crash在獨(dú)立進(jìn)程或多進(jìn)程模式下渲染進(jìn)程可能因?yàn)轫撁孢^量內(nèi)存消耗被殺需要在 WebViewClient 的onRenderProcessGone中處理恢復(fù)邏輯。Override public boolean onRenderProcessGone(WebView view, RenderProcessGoneDetail detail) { if (!detail.didCrash()) { // 系統(tǒng)主動結(jié)束不是崩潰可以重新創(chuàng)建 WebView recreateWebView(); return true; } // 真的崩潰了展示錯誤頁面 showCrashError(view); return true; }11. 第三方 WebView 增強(qiáng)庫概述Android 原生 WebView API 在各版本間差異較大很多高級特性只有在較高版本才可用。Jetpack 中的androidx.webkit庫為開發(fā)者提供了向下兼容的 API強(qiáng)烈推薦引入。dependencies { implementation androidx.webkit:webkit:1.7.0 }關(guān)鍵 API 示例WebViewCompat提供兼容版本的 WebView 方法WebViewFeature檢測當(dāng)前 WebView 實(shí)現(xiàn)是否支持某項特性ProxyController為 WebView 設(shè)置代理TracingController用于性能分析追蹤。另外還有騰訊的 X5 WebViewTBS它提供了一套基于 Chromium 的增強(qiáng) WebView 內(nèi)核主要解決舊設(shè)備上系統(tǒng) WebView 版本過低的問題并增加了文件瀏覽、長截圖等擴(kuò)展能力。但隨著 Android 系統(tǒng) WebView 的快速迭代和高版本覆蓋率的提升TBS 的優(yōu)勢正在被削弱引入它需要額外承擔(dān)幾十 MB 的內(nèi)核包體積需要按業(yè)務(wù)需求評估。12. 總結(jié)與展望本文系統(tǒng)性地梳理了 Android WebView 從基礎(chǔ)到進(jìn)階的方方面面總計超過兩萬字。我們覆蓋了 WebSettings 的每一個關(guān)鍵配置、WebViewClient 與 WebChromeClient 的全套回調(diào)、JavaScript 雙端通信的多種方案、生命周期與內(nèi)存管理的實(shí)戰(zhàn)策略、性能優(yōu)化的具體手段以及安全實(shí)踐的每一條紅線。在實(shí)際項目中沒有一種萬能的 WebView 方案能適配所有業(yè)務(wù)。一個優(yōu)秀的 WebView 容器設(shè)計應(yīng)該是分層的底層提供穩(wěn)定、安全、高性能的內(nèi)核封裝中間層提供離線包、請求攔截、Cookie 管理等通用能力上層由具體業(yè)務(wù)定制加載策略和交互邏輯。保持每一層的職責(zé)清晰才能在快速迭代中避免牽一發(fā)而動全身。展望未來隨著 Android 與 ChromeOS 的逐步融合WebView 的能力還將進(jìn)一步增強(qiáng)。WebAssembly、WebAuthn、Trusted Web ActivityTWA等新技術(shù)正在把 Web 容器的應(yīng)用邊界推向更遠(yuǎn)的地方。掌握好 WebView 的底層原理才能在這些新浪潮中游刃有余。希望這篇文章能成為你 Android 開發(fā)路上的手邊參考如果覺得有幫助歡迎收藏、轉(zhuǎn)發(fā)并在實(shí)際項目中檢驗(yàn)這些實(shí)踐。