WebView HTML5 AppCache 方法的废弃与现代缓存策略

本文旨在解决Android WebView中setAppCachePath和setAppCacheEnabled方法在API 33及更高版本中不再可用的问题。我们将解释这些方法被移除的原因，并提供现代的替代方案，包括利用标准的HTTP缓存机制、Service Workers以及DOM存储，以实现Web内容的有效缓存和离线访问。

HTML5 AppCache 及其相关方法的废弃

在Android开发中，当尝试在WebView中配置HTML5 AppCache时，开发者可能会遇到setAppCachePath和setAppCacheEnabled方法编译报错，尤其是在Android API 33（或更高版本）上。错误信息通常指示“cannot find symbol”，这意味着这些方法已从WebSettings类中移除。

出现此问题的原因在于HTML5 AppCache规范本身已被废弃。Web社区已转向更强大、更灵活的Service Workers作为其替代方案。因此，Android WebView作为现代Web标准的遵循者，也相应地移除了对旧版AppCache功能的支持。这意味着，在较新的Android版本和WebView组件中，尝试使用这些方法将导致编译错误，并且即使在旧版本中，其功能也可能不再稳定或推荐使用。

现代 WebView 缓存策略

鉴于HTML5 AppCache的废弃，开发者需要转向现代的Web内容缓存策略。以下是几种推荐的方法：

立即学习“前端免费学习笔记（深入）”；

1. 标准 HTTP 缓存机制

WebView默认支持标准的HTTP缓存机制。这意味着，如果Web服务器配置了正确的HTTP响应头（如Cache-Control、Expires、ETag和Last-Modified），WebView将自动遵循这些指令来缓存Web资源。这是最基础也是最常用的缓存方式，无需在Android代码中进行特殊处理，只需确保Web服务器端配置得当。

开发者可以通过WebSettings.setCacheMode()方法来调整WebView的缓存行为，以更好地利用HTTP缓存：

• WebSettings.LOAD_DEFAULT: 这是默认模式。如果缓存可用且未过期，则使用缓存；否则，从网络加载。
• WebSettings.LOAD_CACHE_ELSE_NETWORK: 优先使用缓存。如果缓存可用，即使已过期，也会使用缓存；只有在缓存不可用时才从网络加载。
• WebSettings.LOAD_NO_CACHE: 不使用缓存，总是从网络加载。这通常用于调试或需要最新内容的场景，但与启用缓存的初衷相反。
• WebSettings.LOAD_CACHE_ONLY: 仅使用缓存。不从网络加载，如果缓存不可用，则加载失败。适用于离线模式。

示例代码：

import android.webkit.WebSettings;
import android android.webkit.WebView;

public class MyWebViewActivity extends AppCompatActivity {

    private WebView webView;

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

        webView = findViewById(R.id.my_webview);
        WebSettings webSettings = webView.getSettings();

        // 启用DOM存储，支持LocalStorage/SessionStorage
        webSettings.setDomStorageEnabled(true);

        // 设置缓存模式，优先使用缓存，如果缓存过期则从网络加载
        // 对于大多数场景，LOAD_DEFAULT 是一个好的起点
        webSettings.setCacheMode(WebSettings.LOAD_DEFAULT); 

        // 或者，如果希望在离线时尽可能使用缓存：
        // webSettings.setCacheMode(WebSettings.LOAD_CACHE_ELSE_NETWORK);

        // 注意：setAppCachePath 和 setAppCacheEnabled 已被废弃并移除，
        // 不应再使用，尝试使用会导致编译错误。
        // webSettings.setAppCachePath("/data/data/" + getPackageName() + "/cache"); // 错误
        // webSettings.setAppCacheEnabled(true); // 错误

        webView.loadUrl("https://your-web-app.com");
    }
}

2. Service Workers (服务工作线程)

Service Workers是现代Web应用实现离线功能、自定义缓存策略和拦截网络请求的核心技术。它们在Web页面和网络之间充当代理，允许开发者精细控制资源的缓存和加载方式。Service Workers是HTML5 AppCache的强大替代品，提供了更强的灵活性和性能。

存了个图

视频图片解析/字幕/剪辑，视频高清保存/图片源图提取

17

查看详情

特点：

• 离线访问： 能够缓存Web应用的核心资源，使用户在无网络连接时仍能访问应用。
• 自定义缓存策略： 开发者可以编写JavaScript代码来定义复杂的缓存策略，例如“网络优先”、“缓存优先”或“仅缓存”等。
• 拦截网络请求： Service Workers可以拦截所有网络请求，并决定如何响应（从缓存中获取、从网络获取、生成响应等）。
• 后台同步与推送通知： 允许在后台执行任务和接收推送通知。

实现方式：

Service Workers主要通过Web内容（JavaScript）来实现，而不是通过Android Java代码直接启用。WebView本身（从Android 5.0 Lollipop及更高版本）就支持Service Workers。因此，要利用Service Workers，您需要在您的Web应用中编写并注册Service Worker脚本。

示例（Web端 JavaScript）：

// 在您的Web应用的主JavaScript文件中注册Service Worker
if ('serviceWorker' in navigator) {
  window.addEventListener('load', function() {
    navigator.serviceWorker.register('/service-worker.js').then(function(registration) {
      // 注册成功
      console.log('ServiceWorker registration successful with scope: ', registration.scope);
    }, function(err) {
      // 注册失败
      console.log('ServiceWorker registration failed: ', err);
    });
  });
}

// service-worker.js 示例
const CACHE_NAME = 'my-app-cache-v1';
const urlsToCache = [
  '/',
  '/index.html',
  '/styles.css',
  '/script.js',
  '/images/logo.png'
];

self.addEventListener('install', function(event) {
  // 安装时缓存所有必要的资源
  event.waitUntil(
    caches.open(CACHE_NAME)
      .then(function(cache) {
        console.log('Opened cache');
        return cache.addAll(urlsToCache);
      })
  );
});

self.addEventListener('fetch', function(event) {
  // 拦截网络请求，尝试从缓存中获取，否则从网络获取
  event.respondWith(
    caches.match(event.request)
      .then(function(response) {
        // 缓存中有，则返回缓存的响应
        if (response) {
          return response;
        }
        // 缓存中没有，则从网络获取
        return fetch(event.request);
      })
  );
});

self.addEventListener('activate', function(event) {
  // 激活时清理旧的缓存
  event.waitUntil(
    caches.keys().then(function(cacheNames) {
      return Promise.all(
        cacheNames.filter(function(cacheName) {
          return cacheName.startsWith('my-app-cache-') && cacheName !== CACHE_NAME;
        }).map(function(cacheName) {
          return caches.delete(cacheName);
        })
      );
    })
  );
});

3. DOM Storage (LocalStorage/SessionStorage)

对于存储少量结构化数据（如用户偏好、会话信息等），可以使用HTML5的localStorage和sessionStorage。这些数据直接存储在WebView的本地存储中，并可以在页面加载之间持久化（localStorage）或在会话期间保持（sessionStorage）。

在Android WebView中启用DOM存储，只需设置：

webSettings.setDomStorageEnabled(true);

实现与注意事项

1. 服务器配置： 确保您的Web服务器为静态资源配置了适当的Cache-Control和Expires HTTP响应头。这对于利用HTTP缓存至关重要。
2. Web 内容开发： 如果您的Web应用需要高级的离线功能或自定义缓存逻辑，请在Web应用内部实现Service Workers。Service Workers的调试通常通过Chrome浏览器的开发者工具进行。
3. WebView 配置： 除了上述缓存设置，确保WebSettings中的其他相关配置（如JavaScript启用）也正确设置，以支持现代Web应用。

   webSettings.setJavaScriptEnabled(true); // 启用JavaScript是现代Web应用的基础
   // webSettings.setAllowFileAccess(true); // 如果需要访问本地文件系统

   登录后复制
4. 调试： 使用Chrome的远程调试功能（通过USB连接Android设备，并在Chrome浏览器中访问chrome://inspect/#devices）可以检查WebView的缓存状态、Service Worker注册情况和网络请求。
5. 权限： 通常，启用WebView的标准缓存功能不需要特殊的Android权限。但如果您的Web内容涉及地理位置、摄像头等，则需要在Android应用中请求相应的运行时权限。

总结

HTML5 AppCache及其相关的setAppCachePath和setAppCacheEnabled方法已在现代Android WebView中被废弃并移除。开发者应转向利用标准的HTTP缓存机制、Service Workers以及DOM Storage来管理Web内容的缓存。其中，Service Workers是实现高级离线功能和自定义缓存策略的推荐方案，它要求Web应用本身实现相应的JavaScript逻辑。通过正确配置Web服务器和WebView，并利用Service Workers的强大功能，您可以为用户提供高效、可靠的Web体验，包括在离线状态下访问应用。

以上就是WebView HTML5 AppCache 方法的废弃与现代缓存策略的详细内容，更多请关注php中文网其它相关文章！