本文详解如何在 cordova 混合应用中，将 axios 或 $http 获取的二进制响应数据（resp.data）封装为 blob，并通过 cordova-plugin-file 安全、可靠地写入 android 设备的本地应用私有目录（如 datadirectory）。
本文详解如何在 cordova 混合应用中，将 axios 或 $http 获取的二进制响应数据（resp.data）封装为 blob，并通过 cordova-plugin-file 安全、可靠地写入 android 设备的本地应用私有目录（如 datadirectory）。
在基于 Cordova 的 Hybrid App（尤其是 Ionic/Angular 项目）中，常需将服务端返回的文件（PDF、Excel、图片等）持久化保存至 Android 本地。常见误区是直接调用 $cordovaFile.writeFile 传入 Blob 对象——但该方法仅接受 String 或 ArrayBuffer，不支持原生 Blob，导致写入失败或内容损坏。
正确做法是：利用 Cordova File Plugin 提供的底层 FileWriter API，将 Blob 流式写入设备文件系统。关键步骤如下：
✅ 正确实现流程（ES6+ Promise 风格）
// 假设 resp 是 HTTP 响应对象（如来自 $http 或 axios）
const blob = new Blob([resp.data], {
type: resp.headers?.('Content-Type') || 'application/octet-stream'
});
const fileName = 'downloaded_file.pdf'; // 建议根据 Content-Disposition 或 MIME 类型动态生成
const pathToFile = cordova.file.dataDirectory; // ✅ 推荐：应用私有目录，无需额外权限（Android 10+ 兼容）
document.addEventListener('deviceready', async () => {
try {
// 1. 解析目标目录路径为 FileSystem 对象
const fileSystem = await new Promise((resolve, reject) => {
window.resolveLocalFileSystemURL(pathToFile, resolve, err =>
reject(new Error(`Failed to resolve directory: ${err.message}`))
);
});
// 2. 创建或获取目标文件条目（create: true 确保文件存在）
const fileEntry = await new Promise((resolve, reject) => {
fileSystem.getFile(fileName, { create: true, exclusive: false }, resolve, err =>
reject(new Error(`Failed to get file entry: ${err.message}`))
);
});
// 3. 获取文件写入器
const fileWriter = await new Promise((resolve, reject) => {
fileEntry.createWriter(resolve, err =>
reject(new Error(`Failed to create writer: ${err.message}`))
);
});
// 4. 设置写入回调
fileWriter.onwriteend = () => {
console.log('✅ 文件保存成功！路径:', fileEntry.nativeURL);
// 可选：通知用户、打开文件或跳转至文件管理器
// 示例：cordova.plugins.fileOpener2.open(fileEntry.nativeURL);
};
fileWriter.onerror = (error) => {
console.error('❌ 文件写入失败:', error);
alert('文件保存失败，请检查存储权限或重试');
};
// 5. 执行写入（自动处理 Blob → Uint8Array 转换）
fileWriter.write(blob);
} catch (error) {
console.error('? 文件系统操作异常:', error);
alert('保存文件时发生错误：' + error.message);
}
}, false);⚠️ 关键注意事项
-
权限配置：确保
config.xml中已添加必要权限（Android 12+ 需显式声明）：<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
? 注：
cordova.file.dataDirectory属于应用私有目录，Android 10+ 默认无需运行时请求存储权限；若改用externalRootDirectory则必须适配 Scoped Storage 并申请MANAGE_EXTERNAL_STORAGE（不推荐）。 MIME 类型容错：
resp.headers('Content-Type')在部分环境可能为undefined，务必提供 fallback（如'application/octet-stream'），避免 Blob 创建失败。
Android Remote Control下载远程控制 Android 设备，支持截图、自动化操作手机 App 等功能。本应用使用 uiautomator2 作为底层框架，通过 ADB 连接设备，用户无需 Root（1）查看手机屏幕；（2）自动化操作手机 App；（3）远程安装/卸载应用……
-
文件名安全：避免直接使用服务端提供的原始文件名（含路径遍历风险），建议清洗后缀并限制长度，例如：
const safeName = (fileName || 'untitled').replace(/[^a-z0-9._-]/gi, '_').slice(0, 128);
调试技巧：可通过
fileEntry.toURL()或fileEntry.nativeURL获取可访问路径；在 Android Studio Logcat 中搜索FileWriter日志定位问题。
✅ 替代方案（更简洁，需插件 v6.0.0+）
若使用较新版本 cordova-plugin-file，可直接调用 writeFile 的 ArrayBuffer 重载（需先转换 Blob）：
const arrayBuffer = await blob.arrayBuffer();
$cordovaFile.writeFile(cordova.file.dataDirectory, fileName, arrayBuffer, { replace: true })
.then(() => console.log('Saved via writeFile'))
.catch(err => console.error(err));但注意：此方式会将整个 Blob 加载进内存，对大文件（>50MB）存在 OOM 风险，生产环境强烈推荐首推 FileWriter.write(blob) 流式写入方案。
掌握上述模式后，你即可稳定、高效地在 Android Cordova 应用中实现服务端文件的本地持久化，兼顾兼容性、安全性和用户体验。
