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

news2025/4/6 2:12:29

在移动应用开发中，数据存储是一个至关重要的环节。对于使用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/，以避免权限问题。
错误处理：在实际应用中，建议添加更多的错误处理逻辑，例如处理文件不存在、读写失败等情况。
数据格式：确保写入和读取的数据格式一致，避免因格式不匹配导致的数据解析错误。