在移動應用開發中，數據存儲是一個至關重要的環節。對于使用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/，以避免權限問題。
• 錯誤處理：在實際應用中，建議添加更多的錯誤處理邏輯，例如處理文件不存在、讀寫失敗等情況。
• 數據格式：確保寫入和讀取的數據格式一致，避免因格式不匹配導致的數據解析錯誤。

總結

通過將數據存儲在本地文件中，你可以確保關鍵數據在用戶清除緩存或清除應用數據后依然存在。這種方法不僅適用于UniApp，也適用于其他跨平臺開發框架。關鍵在于合理利用原生功能，處理好權限和文件路徑問題。

希望本文能幫助你更好地實現UniApp應用的持久化存儲，提升用戶體驗和數據安全性。如果你有任何疑問或建議，歡迎在評論區留言交流！