簡介
local_cache_sync是一個非常簡單易用的Flutter本地儲存庫,適用於在本地儲存一列輕量數據(例如用戶保存在本地的設備信息,或者緩存一系列用戶信息)
local_cache_sync的所有方法,包括保存與讀取,都是同步的,而不是異步的。
同步存取意味着你不需要使用await就可以獲取和保存數據。在flutter中,這可以顯著減少StatefulWidget的數量,大量減少代碼的復雜度。
例子
使用local_cache_sync保存與讀取參數都是同步的,這意味着賦值即是保存,而且在StatelessWidget中,可以立即使用數據,而不是異步請求數據再刷新。
下面這個Switch組件的值會被緩存到本地,即使重新啟動App也會保留:
Switch( value: LocalCacheSync.userDefault.getWithKey<bool>('switch-A'), onChanged: (v) { setState(() { LocalCacheSync.userDefault.setWithKey<bool>('switch-A', v); }); }, ),
安裝
添加你的pubspec.yaml
path_provider: ^1.4.5 local_cache_sync: ^1.1.0
初始化設置路徑
getTemporaryDirectory().then((uri) {
LocalCacheSync.instance.setCachePath(uri.path);
});
用戶偏好設置緩存
使用local_cache_sync實現保存用戶自定義設置非常簡單,只需要賦值與取值,無需異步等待,即可保存參數到本地。
讀取參數也是同步的,這意味着你可以在StatelessWidget中立即使用數據。
使用函數調用:
保存數據
LocalCacheSync.userDefault.setWithKey<bool>('isDarkMode',true); LocalCacheSync.userDefault.setWithKey<String>('token','aabbccdd'); LocalCacheSync.userDefault.setWithKey<Map>('x-config',{'id':1243});
讀取數據
var res = LocalCacheSync.userDefault.getWithKey<bool>('isDarkMode'); var res = LocalCacheSync.userDefault.getWithKey<String>('token'); var res = LocalCacheSync.userDefault.getWithKey<Map>('x-config');
使用操作符:
保存數據
LocalCacheSync.userDefault['isDarkMode'] = true; LocalCacheSync.userDefault['token'] = 'aabbccdd'; LocalCacheSync.userDefault['x-config'] = {'id':1243};
讀取數據
bool res = LocalCacheSync.userDefault['isDarkMode']; String res = LocalCacheSync.userDefault['token']; Map res = LocalCacheSync.userDefault['x-config'];
廣州包裝設計公司http://www.maiqicn.com 電腦刺綉綉花廠 ttp://www.szhdn.com
管理一組數據緩存
如果你需要管理一系列值,請使用LocalCacheLoader,只需要一個channel標志,你就可以管理一系列值。
懶加載
LocalCacheLoader在內部實現了懶加載的效果:只有取value屬性時數據才真正被加載。
在應用中,加入你有1-100號設備顯示在Listview.builder中,只有100號設備即將進入屏幕中時,100號設備的緩存參數才會被真正加載。也就是說LocalCacheLoader不會導致長列表卡頓。
Model例子
我推薦你這樣創建你的model:
class Device { final String uuid; final String name; final int type; Device({ this.uuid, this.name, this.type, }); Device.formjson(Map<String, dynamic> map) : this( uuid: map['uuid'], name: map['name'], type: map['type'], ); static LocalCacheLoader get _loader => LocalCacheLoader('device'); static List<Device> all() { return _loader.all .map<Device>( (cache) => Device.fromjson(cache), ) .toList(); } LocalCacheObject save() { return Device._loader.saveById(uuid, jsonMap); } Map<String, dynamic> get jsonMap => { 'uuid': uuid, 'name': name, 'type': type, }; }
你也可以另外封裝loader來讀寫其他信息,對於輕量級的儲存,以上是非常簡單易用的。
警告
不要在io密集型場景使用local_cache_sync,例如即時儲存每秒10次的掃描結果。
雖然flutter中阻塞主線程不會導致UI卡頓,但是你仍不應當在io密集型場景使用,這超出了local_cache_sync設計的工作范圍。
倉庫與Pub地址
如果有問題,可以在github上issue或者pr。
PUB地址(可以贊一下)
Github倉庫
