萬盛學電腦網

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

Android WebView 啟用 localStorage 完整配置指南

WebView 預設禁用 DOM Storage,導致 H5 頁面無法使用 localStorage / sessionStorage。本文給出最小化、可直接複製的配置代碼,解決「存不進、讀不出」的常見問題。

核心配置代碼(Kotlin/Java 通用)

WebView webView = findViewById(R.id.webview);
WebSettings settings = webView.getSettings();

// 1. 啟用 JavaScript(前提)
settings.setJavaScriptEnabled(true);

// 2. 關鍵:啟用 DOM Storage(localStorage/sessionStorage 依賴此項)
settings.setDomStorageEnabled(true);

// 3. 可選:啟用 Application Cache(HTML5 離線緩存)
settings.setAppCacheEnabled(true);
settings.setAppCacheMaxSize(8 * 1024 * 1024); // 8MB
String cacheDir = getCacheDir().getAbsolutePath();
settings.setAppCachePath(cacheDir);

// 4. 可選:允許文件訪問(部分舊設備需要)
settings.setAllowFileAccess(true);
settings.setAllowContentAccess(true);

// 5. 可選:資料庫存儲路徑(舊版 Web SQL Database 用)
settings.setDatabaseEnabled(true);
String dbPath = getDir("database", MODE_PRIVATE).getPath();
settings.setDatabasePath(dbPath);

// 6. 地理定位權限(如 H5 需用)
settings.setGeolocationEnabled(true);

常見坑點排查

  • 忘記 setDomStorageEnabled(true):90% 問題源於此,必須顯式開啟。
  • 跨域/文件協議限制:file:// 協議下 localStorage 共享受限,建議使用 WebViewAssetLoader 或本地 HTTP Server 方案。
  • 隱私模式/無痕模式:部分瀏覽器內核在隱私模式下禁用 Storage,無法繞過。
  • 存儲配額超限:單域名通常 5MB,超額拋出 QuotaExceededError,需捕獲處理。

驗證代碼(注入 JS 檢測)

webView.evaluateJavascript(
    "try { localStorage.setItem('test', '1'); localStorage.removeItem('test'); 'OK'; } catch(e) { e.message; }",
    value -> Log.d("WebView", "localStorage test: " + value)
);

配置上述項目後,WebView 即可完整支援 HTML5 本地存儲 API,滿足離線緩存、用戶偏好保存等場景需求。

copyright © 萬盛學電腦網 all rights reserved