萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android WebView 完整配置指南:從基礎加載到 JavaScript 交互的最佳實踐

WebView 是 Android 應用內嵌網頁的核心組件。本文提供一個生產級可用的 WebViewActivity 完整實現,涵蓋基礎配置、HTML 數據加載、JavaScript 支持、混合內容適配、生命週期管理、安全防範等關鍵點,並附帶佈局 XML,開箱即用。

一、 佈局文件 res/layout/webview.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:id="@+id/webview_ll"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="WebView 測試頁面"
        android:textColor="#000000"
        android:textSize="18sp"
        android:background="#00FF00"
        android:gravity="center"
        android:padding="16dp"/>

    <WebView
        android:id="@+id/webview"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1"/>

</LinearLayout>

二、 核心 Activity 實現 WebViewActivity.java

public class WebViewActivity extends AppCompatActivity {

    private WebView webView;
    private static final String MIME_TYPE = "text/html";
    private static final String ENCODING = "utf-8";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.webview);

        webView = findViewById(R.id.webview);
        initWebViewSettings();
        loadTestContent();
    }

    private void initWebViewSettings() {
        WebSettings settings = webView.getSettings();
        // 核心功能開關
        settings.setJavaScriptEnabled(true);           // 支持 JS
        settings.setDomStorageEnabled(true);           // 支持 LocalStorage
        settings.setDatabaseEnabled(true);             // 支持 Web SQL DB (已棄用但兼容)
        settings.setAllowFileAccess(true);             // 允許文件訪問
        settings.setAllowContentAccess(true);          // 允許 Content Provider 訪問

        // 緩存與渲染優化
        settings.setCacheMode(WebSettings.LOAD_DEFAULT);
        settings.setAppCacheEnabled(true);
        settings.setRenderPriority(WebSettings.RenderPriority.HIGH);
        settings.setLoadWithOverviewMode(true);        // 自適應屏幕
        settings.setUseWideViewPort(true);             // 支持 viewport 標籤

        // 混合內容適配 (Android 5.0+)
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
            settings.setMixedContentMode(WebSettings.MIXED_CONTENT_ALWAYS_ALLOW);
        }

        // 設置 User-Agent (可選)
        // settings.setUserAgentString(settings.getUserAgentString() + " MyApp/1.0");

        // 關鍵:設置 WebViewClient 處理頁面跳轉、錯誤、SSL
        webView.setWebViewClient(new WebViewClient() {
            @Override
            public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
                // API 24+ 使用此方法
                return handleUrlLoading(view, request.getUrl());
            }

            @Override
            public boolean shouldOverrideUrlLoading(WebView view, String url) {
                // API 24- 使用此方法
                return handleUrlLoading(view, url);
            }

            private boolean handleUrlLoading(WebView view, Object urlObj) {
                String url = urlObj.toString();
                if (url.startsWith("https://") || url.startsWith("https://")) {
                    view.loadUrl(url);
                    return true; // 由 WebView 內部處理
                }
                // 處理 scheme: tel:, mailto:, intent:, market: 等
                try {
                    Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
                    startActivity(intent);
                } catch (ActivityNotFoundException e) {
                    Log.w("WebView", "無法處理鏈接: " + url);
                }
                return true;
            }

            @Override
            public void onReceivedSslError(WebView view, SslErrorHandler handler, SslError error) {
                // 生產環境嚴禁 handler.proceed()!此處僅演示
                Log.e("WebView", "SSL 錯誤: " + error.getPrimaryError());
                handler.cancel(); // 安全做法:取消加載
            }

            @Override
            public void onPageFinished(WebView view, String url) {
                super.onPageFinished(view, url);
                // 頁面加載完成,可注入 JS、隱藏進度條等
            }
        });

        // 設置 WebChromeClient 處理 JS 對話框、標題、進度、權限請求
        webView.setWebChromeClient(new WebChromeClient() {
            @Override
            public boolean onJsAlert(WebView view, String url, String message, JsResult result) {
                return super.onJsAlert(view, url, message, result);
            }

            @Override
            public void onProgressChanged(WebView view, int newProgress) {
                super.onProgressChanged(view, newProgress);
                // 更新進度條
            }

            @Override
            public void onPermissionRequest(PermissionRequest request) {
                // Android 6.0+ 處理攝像頭/麥克風/定位權限請求
                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
                    request.grant(request.getResources());
                }
            }
        });
    }

    private void loadTestContent() {
        String html = "<a href='https://blog.csdn.net/xys289187120'>歡迎訪問博客</a>";
        // loadDataWithBaseURL: baseUrl 為 null 時相對路徑無效,historyUrl 為 null 不記入歷史
        webView.loadDataWithBaseURL(null, html, MIME_TYPE, ENCODING, null);
    }

    @Override
    public void onBackPressed() {
        if (webView.canGoBack()) {
            webView.goBack();
        } else {
            super.onBackPressed();
        }
    }

    @Override
    protected void onDestroy() {
        if (webView != null) {
            webView.loadUrl("about:blank"); // 清空內容
            webView.stopLoading();
            webView.setWebViewClient(null);
            webView.setWebChromeClient(null);
            webView.destroy(); // 釋放內存,防洩漏
            webView = null;
        }
        super.onDestroy();
    }
}

三、 AndroidManifest.xml 權限聲明

<uses-permission android:name="android.permission.INTERNET" />
<!-- 若需訪問文件/地理位置/攝像頭等,按需添加 -->

四、 關鍵最佳實踐總結

  1. 生命週期綁定:onDestroy 中徹底銷毀 WebView,防內存洩漏 (WebView 內部 Handler 持有 Context 引用)。
  2. 返回鍵處理:優先 goBack(),提升用戶體驗。
  3. HTTPS 與混合內容:API 21+ 默認阻擋 HTTP 混合內容,按需開啟 MIXED_CONTENT_ALWAYS_ALLOW (僅開發/受信環境)。
  4. SSL 錯誤:生產環境**絕不** handler.proceed(),應引導用戶或降級。
  5. JavaScript 交互:addJavascriptInterface 暴露 Java 物件給 JS,**僅暴露必要方法**,API 17+ 需加 @JavascriptInterface 註解,防反射攻擊。
  6. 硬件加速:Manifest android:hardwareAccelerated="true" (默認開啟),複雜頁面可提升渲染幀率。

這份配置模板覆蓋了 90% 以上的 WebView 使用場景,可直接作為項目基礎組件擴展。

copyright © 萬盛學電腦網 all rights reserved