当前位置：首页 > news >正文

【uniapp】在UniApp中实现持久化存储：安卓--生成写入数据为jsontxt

news 2025/9/13 19:29:27

在移动应用开发中，数据存储是一个至关重要的环节。对于使用UniApp开发的Android应用来说，缓存（Cache）是一种常见的数据存储方式，它能够提高应用的性能和用户体验。然而，缓存数据在用户清除缓存或清除应用数据后会被删除。如果你的应用需要在这些操作后仍然保留某些关键数据，就需要考虑其他持久化存储方案。

uniapp调用示例传送门

本文将介绍如何利用H5plus的native功能，通过引入Java类，将数据存储到本地文件中，从而实现数据的持久化。

为什么选择本地文件存储？

在UniApp中，数据通常以缓存的形式存储在本地。这种方式虽然简便且高效，但存在一个明显的缺点：缓存数据容易被用户清除。当用户在应用设置中清除缓存或清除应用数据时，所有缓存的数据都会丢失。如果你的应用需要保留一些关键数据，例如用户设置、配置信息或重要的用户数据，那么就需要一种更持久的数据存储方式。

本地文件存储提供了一种可靠的解决方案。通过将数据写入设备的文件系统中，即使缓存被清除，这些文件依然存在，数据得以保留。

实现步骤

1. 引入必要的Java类

由于我们需要在Android环境中操作文件系统，因此需要使用Java的IO类。通过H5plus的plus.android.importClass方法，我们可以导入这些类：

const File = plus.android.importClass('java.io.File');
const BufferedReader = plus.android.importClass('java.io.BufferedReader');
const FileReader = plus.android.importClass('java.io.FileReader');
const FileWriter = plus.android.importClass('java.io.FileWriter');

2. 读取本地文件

以下是一个读取本地JSON文件的函数：

function readJsonByFile(fileNamePath) {const readFr = new File(fileNamePath);try {const reader = new BufferedReader(new FileReader(readFr));let txt;let retxt = '';let flag = true;while (flag) {txt = reader.readLine(); // 读取文件if (txt == null) {flag = false;break;}retxt += txt;}return retxt;} catch (e) {console.log(e);return '';}
}

使用示例：

const settingJsonPath = '/storage/emulated/0/Download/你的文件夹/配置.json';
const jsonData = readJsonByFile(settingJsonPath);
console.log(jsonData);

3. 写入本地文件

以下是一个写入本地JSON文件的函数：

function writeJsonToFile(json, fileNamePath) {try {// 创建目录const n = fileNamePath.lastIndexOf('/');if (n !== -1) {const fileDirs = fileNamePath.substring(0, n);console.log(fileDirs);const directory = new File(fileDirs);if (!directory.exists()) {const a = directory.mkdirs(); // 不存在创建目录console.log(a);}}// 创建文件const file = new File(fileNamePath);if (!file.exists()) {file.createNewFile(); // 创建文件}// 写入文件const fos = new FileWriter(fileNamePath, false);fos.write(json);fos.close();return true;} catch (e) {console.log(e);return false;}
}

使用示例：

const settingJsonPath = '/storage/emulated/0/Download/你的文件夹/配置.json';
const jsonData = {"主键": "值","数组": [1, 2, 3],"嵌套对象": {"子键": "子值"}
};
const success = writeJsonToFile(JSON.stringify(jsonData), settingJsonPath);
if (success) {console.log("文件写入成功");
} else {console.log("文件写入失败");
}

4. 权限设置

在Android 6.0（API 23）及以上版本，存储权限需要动态申请。即使你在manifest中声明了存储权限，用户仍然需要在运行时授予权限。以下是申请存储权限的示例：

// 请求存储权限
plus.android.requestPermissions(["android.permission.READ_EXTERNAL_STORAGE", "android.permission.WRITE_EXTERNAL_STORAGE"],function(e) {if (e.granted) {console.log("权限已授予");} else {console.log("权限被拒绝");}},function(e) {console.log("请求权限失败");}
);

在这里插入图片描述

注意事项：

路径选择：从Android 11（API 30）开始，访问外部存储的规则有所变化。建议使用应用专属的目录，例如/storage/emulated/0/Android/data/你的包名/files/，以避免权限问题。
错误处理：在实际应用中，建议添加更多的错误处理逻辑，例如处理文件不存在、读写失败等情况。
数据格式：确保写入和读取的数据格式一致，避免因格式不匹配导致的数据解析错误。