encrypt_shared_preferences
此套件為儲存在您應用程式中的敏感資訊(如使用者憑證、API 金鑰或其他機密資料)增加了額外的保護層。
非常適合重視安全性之開發者,加密共用偏好設定可輕鬆整合至您的專案中,提供安心保障並提升資料隱私。使用此不可或缺的加密解決方案來保護您的應用程式資料
{"sdk":"flutter"}^2.3.2^5.0.3^11.2.0{"sdk":"flutter"}^2.0.0以下為英文專案原文快照,最新內容請造訪 GitHub。
Shared preferences are a simple key-value storage mechanism that can be used to store small amounts of data. However, since shared preferences are stored in plain text, it is not suitable for storing sensitive information. To address this issue, you can use AES encryption to encrypt the data before saving it to shared preferences.
To use shared preferences with AES encryption support, you can add this package to your project as dependency.
Legacy EncryptedSharedPreferences
void main() async {
final key = "";
await EncryptedSharedPreferences.initialize(key: key);
var sharedPref = EncryptedSharedPreferences.getInstance();
await sharedPref.setString(
'user_token', 'xxxxxxxxxxxx', notify: true); ////notify = true by default
sharedPref.getString('user_token'); //xxxxxxxxxxxx
await sharedPref.setInt('age', 99, notify: true); //notify = true by default
sharedPref.getInt('age', defaultValue: 1001); //99
await sharedPref.setDouble('pi', 3.14, notify: true); //notify = true by default
sharedPref.getDouble('pi'); //3.14
await sharedPref.setBool('isPremium', true, notify: true); //notify = true by default
sharedPref.getBool('isPremium'); //true
await sharedPref.setStringList("stringList", ["apple", "orange", "boom"]);
sharedPref.getStringList("stringList");
await sharedPref.remove('user_token', notify: true); //notify = true by default
await sharedPref.clear(notify: true); //notify = true by default
await sharedPref.reload();
final badKeys = {
"key1"
"key2"
};
await sharedPref.removeWhere((key, value) => badKeys.contains(key));
sharedPref.observe(key: 'token').listen((event) {
// event = key
print(event);
});
sharedPref.observeSet(keys: {'key1', 'key2', 'keyN'}).listen((event) {
// event = key
print(event);
});
}
EncryptedSharedPreferencesAsync
void main() async {
final key = "";
await EncryptedSharedPreferencesAsync.initialize(key: key);
var sharedPref = EncryptedSharedPreferencesAsync.getInstance();
await sharedPref.setString(
'user_token', 'xxxxxxxxxxxx', notify: true); ////notify = true by default
await sharedPref.getString('user_token'); //xxxxxxxxxxxx
await sharedPref.setInt('age', 99, notify: true); //notify = true by default
await sharedPref.getInt('age', defaultValue: 1001); //99
await sharedPref.setDouble('pi', 3.14, notify: true); //notify = true by default
await sharedPref.getDouble('pi'); //3.14
await sharedPref.setBool('isPremium', true, notify: true); //notify = true by default
await sharedPref.getBool('isPremium'); //true
await sharedPref.setStringList("stringList", ["apple", "orange", "boom"]);
await sharedPref.getStringList("stringList");
await sharedPref.remove('user_token', notify: true); //notify = true by default
await sharedPref.clear(notify: true); //notify = true by default
await sharedPref.reload();
final badKeys = {
"key1"
"key2"
};
await sharedPref.removeWhere((key, value) =>
badKeys.contains(key));
sharedPref.observe(key: 'token').listen((event) {
// event = key
print(event);
});
sharedPref.observeSet(keys: {'key1', 'key2', 'keyN'}).listen((event) {
// event = key
print(event);
});
}
[Shared builder] Here is example of how to use SharedBuilder widget
class _MyAppState extends State<MyApp> {
@override
Widget build(BuildContext context) {
return MaterialApp(
home: Scaffold(
body: SharedBuilder(
listenKeys: const {"key1", "key2"}, //Optional
builder: (EncryptedSharedPreferences encryptedSharedPreferences, String? updatedKey) {
return Text("value : ${encryptedSharedPreferences.getString("key1")}");
},
),
floatingActionButton: FloatingActionButton(
onPressed: () async {
EncryptedSharedPreferences.getInstance()
.setString('key1', 'dataValue');
Future.delayed(const Duration(seconds: 3), () {
EncryptedSharedPreferences.getInstance()
.setString('key2', 'dataValue');
});
},
),
),
);
}
}
[Shared builder async] Here is example of how to use SharedBuilder widget
class _MyAppState extends State<MyApp> {
@override
Widget build(BuildContext context) {
return MaterialApp(
home: Scaffold(
body: SharedBuilderAsync(
listenKeys: const {"key1", "key2"}, //Optional
builder: (EncryptedSharedPreferencesAsync encryptedSharedPreferences,
String? updatedKey) {
return Text("value : $updatedKey");
},
),
floatingActionButton: FloatingActionButton(
onPressed: () async {
EncryptedSharedPreferencesAsync.getInstance()
.setString('key1', 'dataValue');
Future.delayed(const Duration(seconds: 3), () {
EncryptedSharedPreferencesAsync.getInstance()
.setString('key2', 'dataValue');
});
},
),
),
);
}
}
Also you can add custom external encryptor
class CustomEncryptor extends IEncryptor {
@override
String decrypt(String key, String encryptedData) {
//decryption logic
}
@override
String encrypt(String key, String plainText) {
//encryption logic
}
}
void main() {
final key = "";
await EncryptedSharedPreferences.initialize(key: key, encryptor: CustomEncryptor());
var sharedPref = EncryptedSharedPreferences.getInstance();
}
DevTools extension for inspecting values
alt text