Android 33中setAppCachePath与setAppCacheEnabled失效的替代方案及报错解决

在Android 33（API 33）中，WebSettings类的setAppCachePath()和setAppCacheEnabled()方法被官方移除，直接调用会触发编译错误，且即使绕过编译，这两个方法也不再生效。

一、解决编译错误的办法 #

通过API版本判断，仅在Android 33以下的版本中保留这两个方法的调用，33及以上版本直接移除相关代码：

private void enableHTML5AppCache() {
    webView.getSettings().setDomStorageEnabled(true);
    // 根据API版本判断是否调用已移除的方法
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) {
        webView.getSettings().setAppCachePath(getCacheDir().getAbsolutePath());
        webView.getSettings().setAppCacheEnabled(true);
    }
    webView.getSettings().setCacheMode(WebSettings.LOAD_DEFAULT);
}

注意：原来硬编码的"/data/data/" + getPackageName() + "/cache"可以替换为getCacheDir().getAbsolutePath()，这是更安全的获取应用缓存目录的方式，避免路径硬编码带来的适配问题。

二、替代方案 #

Android 33及以上版本，WebView的AppCache机制被系统自动接管，不需要手动设置缓存路径和启用开关：

• 系统会默认使用应用的缓存目录管理WebView缓存，无需开发者手动指定路径
• 若需要控制缓存策略，直接使用setCacheMode()即可，常用的模式包括：
  • WebSettings.LOAD_DEFAULT：默认策略，根据缓存可用性决定是否从网络加载
  • WebSettings.LOAD_CACHE_ELSE_NETWORK：优先使用缓存，缓存不存在时再从网络加载
  • WebSettings.LOAD_NO_CACHE：完全不使用缓存，只从网络加载
• 如果需要支持HTML5的DOM存储，仍需保留setDomStorageEnabled(true)的调用

修改后的简化代码（适配全版本）：

private void configureWebViewCache() {
    WebSettings settings = webView.getSettings();
    settings.setDomStorageEnabled(true);
    settings.setCacheMode(WebSettings.LOAD_DEFAULT);
    
    // 仅在Android 33以下版本兼容旧API
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) {
        settings.setAppCachePath(getCacheDir().getAbsolutePath());
        settings.setAppCacheEnabled(true);
    }
}

内容的提问来源于stack exchange，提问作者Hostrings