套件概覽
CrossLocalStorage 是一個 Flutter/Dart 套件，為行動裝置（Android/iOS）、Web 與桌面平台（Windows、macOS、Linux）提供統一的永久儲存介面。它在行動與 Web 平台上封裝 SharedPreferences，而在桌面環境中則提供基於 JSON 檔案的儲存。此套件確保跨平台的資料存取一致性，簡化跨平台應用開發。支援鍵值儲存與結構化 JSON 檔案持久化，非常適合可靠地儲存使用者偏好、應用狀態或小型資料集。
適用情境
- 跨平台儲存使用者偏好
- 在多平台應用中持久化應用狀態
- 將設定檔儲存為 JSON
- 在網頁和桌面應用程式中管理本機資料
- 在行動裝置和桌面裝置之間共用簡單資料
- 啟用離線優先功能
主要特色
- 統一 API 適用於所有平台
- 桌面端的JSON檔案儲存
- SharedPreferences 在移動/web 上的回退
- 平台無關的資料存取
- 支援字串、整數、布林值和複雜類型
- 自動序列化/反序列化
適合對象
- 跨平台 Flutter 開發人員
- 需要在多個目標上進行本機持久化的應用
- 開發人員避免使用平台特定程式碼
- 使用 JSON 儲存本機資料的專案
- 優先考慮程式碼重用的團隊
- 需要輕量級本機儲存的應用
使用建議
- 不適用於大規模數據
- JSON 檔案儲存可能會影響桌面端的效能
- 限於簡單資料結構
- 無內建加密
- 在桌面端需要仔細處理檔案路徑
- 不適用於高頻率寫入