flutter_secure_storage يتيح تخزين قيم حساسة عبر آليات المنصة بدل حفظها كنص في تفضيلات عامة. لا يعني ذلك أن التطبيق صار غير قابل للاختراق أو أن من الآمن طباعة رموز الجلسات. يركز المثال على حفظ قائمة نصية وقراءتها بشكل متين، مع فصل سياسة المسح عن واجهة المستخدم.
ما البيانات المناسبة؟
احفظ الحد الأدنى اللازم مثل رمز جلسة قابل للإلغاء، ولا تنقل أسرار الخادم أو مفاتيح حساب التاجر إلى التطبيق. اعتمد صلاحية قصيرة وتحققًا في الخادم؛ التشفير المحلي ليس بديلًا عن التحكم في الوصول. تفضيلات اللون واللغة لا تحتاج بالضرورة المسار نفسه.
تسلسل البيانات وفحصها
الحزمة تقرأ وتكتب قيمًا نصية. يحول المثال List
أخطاء المنصة وتسجيل الخروج
عمليات القراءة والكتابة غير متزامنة وقد تفشل؛ أظهر حالة مناسبة دون تسريب القيمة في logs. يحذف clearAccount مفتاح المثال فقط، فلا يمسح بيانات تخص ميزة أخرى. عند وجود مفاتيح متعددة للحساب احتفظ بسجل واضح لها وامسحها وفق سياسة تسجيل الخروج.
النسخ الاحتياطي وتغيير الإصدارات
اختُبر المثال مع flutter_secure_storage 10.3.4. راجع دليل الهجرة عند اختيار إصدار رئيسي مختلف، وإعدادات Keychain والنسخ الاحتياطي على Android. قد تبقى بيانات أو تستعاد بعد إعادة التثبيت بحسب المنصة والإعداد؛ افحص ذلك على جهاز فعلي بدل افتراض أن الحذف يمحو كل أثر.
الإعداد
flutter pub add flutter_secure_storageمثال تطبيقي
المقطع التالي مستقل في ملف Dart. اختُبر منطق Dart والواجهات المشار إليها، وتبقى إعدادات المنصة والتجربة على جهاز فعلي مطلوبة قبل النشر.
import 'dart:convert';
import 'package:flutter_secure_storage/flutter_secure_storage.dart';
List<String>? decodeLabels(String? raw) {
if (raw == null) return null;
try {
final decoded = jsonDecode(raw);
if (decoded is! List || decoded.any((v) => v is! String)) return null;
return List<String>.unmodifiable(decoded.cast<String>());
} on FormatException {
return null;
}
}
class PrivateStore {
PrivateStore({FlutterSecureStorage? storage})
: _storage = storage ?? const FlutterSecureStorage();
final FlutterSecureStorage _storage;
static const _key = 'account_labels_v1';
Future<void> saveLabels(List<String> values) =>
_storage.write(key: _key, value: jsonEncode(values));
Future<List<String>?> readLabels() async => decodeLabels(await _storage.read(key: _key));
Future<void> clearAccount() => _storage.delete(key: _key);
}
تطبيق flutter_secure_storage في مشروعك
التخزين الآمن يقلل التعرض لكنه لا يجعل التطبيق غير قابل للاختراق؛ لا تطبع الرموز، وحدد سياسة المسح عند تسجيل الخروج.
مراجع الموضوع: pub.dev — flutter_secure_storage
اختيار التخزين في سلسلة قواعد البيانات
هذا المثال يركز على القيم الحساسة ويختلف عن حفظ تفضيلات المظهر أو قائمة أسماء عامة. لا تنقل كل بيانات SQLite إلى التخزين الآمن لمجرد اسمه؛ حدّد حجم البيانات وطريقة البحث وسياسة المسح. المثال السابق اختُبر مع إصدار الحزمة المذكور داخله؛ راجع دليل الهجرة قبل الانتقال إلى إصدار رئيسي أحدث. احذف نسخة الرمز القديمة من التفضيلات بعد نجاح نقلها، ولا تطبع القيمة للتأكد من الحذف.
لإكمال هذا الجزء، انتقل إلى حفظ حالة Onboarding ورمز الجلسة في Flutter بطريقة صحيحة، ثم طبّق الربط الذي يناسب بنية مشروعك.






