如何在Cordova中启用CrossWalkWebView的缓存？

阿华AIGC实验室

2026-5-26

解决CrossWalkWebView在Cordova中的缓存启用问题

嘿，作为刚接触CrossWalk和Cordova的新手，你已经迈出了正确的第一步——成功集成CrossWalkWebView并运行起来，这很棒！先给你吃个定心丸：添加CrossWalkWebView插件和缓存插件这个操作本身没毛病，但可能你还没针对性地配置CrossWalkWebView的缓存参数，所以没看到预期的缓存效果。下面给你详细说正确的配置步骤：

一、直接配置CrossWalkWebView的缓存参数

CrossWalkWebView有自己的专属配置类，你可以通过修改Cordova平台代码来设置缓存规则：

Android端配置
找到项目中platforms/android/src/[你的包名]/MainActivity.java文件，在初始化CrossWalkWebView的代码块中添加缓存相关配置：

import org.xwalk.core.XWalkSettings;
import org.xwalk.core.XWalkView;

// ... 保留原有初始化代码 ...
XWalkView xWalkView = (XWalkView) findViewById(R.id.xwalkview);
XWalkSettings settings = xWalkView.getSettings();

// 启用DOM存储API缓存（针对HTML5本地存储）
settings.setDomStorageEnabled(true);
// 启用应用缓存功能
settings.setAppCacheEnabled(true);
// 设置应用缓存的存储路径（需确保路径存在且应用有读写权限）
String appCachePath = getApplicationContext().getCacheDir().getAbsolutePath();
settings.setAppCachePath(appCachePath);
// 设置缓存加载模式，这里选默认模式：优先用缓存，缓存失效或不存在时请求网络
settings.setCacheMode(XWalkSettings.LOAD_DEFAULT);

你可以根据业务需求替换缓存模式：

LOAD_CACHE_ELSE_NETWORK：优先加载本地缓存，缓存无数据时再请求网络
LOAD_NO_CACHE：完全不使用缓存，所有资源都从网络获取
LOAD_CACHE_ONLY：仅加载本地缓存，不发起网络请求

iOS端配置
如果涉及iOS平台，修改platforms/ios/[你的项目名]/Classes/MainViewController.m文件，在初始化CrossWalkWebView的部分添加：

XWalkView* xwalkView = [[XWalkView alloc] initWithFrame:self.view.bounds];
[xwalkView.settings setDomStorageEnabled:YES];
[xwalkView.settings setAppCacheEnabled:YES];
[xwalkView.settings setAppCachePath:[[NSBundle mainBundle] bundlePath]];
[xwalkView.settings setCacheMode:WKCacheModeDefault];

二、配合Cordova缓存插件的优化操作

既然你已经添加了缓存插件，比如常用的cordova-plugin-cache，可以在前端JS代码里进一步管控缓存：

// 可选操作：清除旧缓存，确保新的缓存规则生效
window.cache.clear(
    function() { console.log('旧缓存清除成功'); },
    function() { console.log('旧缓存清除失败'); }
);

// 也可以在页面的<head>标签中添加HTTP缓存控制元标签，强化缓存策略
<meta http-equiv="Cache-Control" content="max-age=86400" />

三、容易踩坑的注意事项

权限验证：Android平台需要确保AndroidManifest.xml中添加了存储权限：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

Android 6.0及以上版本还需要动态申请这些权限。