شارك المقالة
no image

حذف بيانات SharedPreferences في Flutter وتسجيل الخروج بأمان

احذف مفاتيح SharedPreferences المطلوبة فقط في Flutter، وافصل تفضيلات الواجهة عن رمز الجلسة والتخزين الآمن عند تسجيل الخروج.

حذف بيانات SharedPreferences في Flutter يجب أن يستهدف المفاتيح التي تريد إزالتها فعلًا. استدعاء clear عند تسجيل الخروج قد يمسح اللغة والوضع الليلي وإعدادات لا تخص الحساب. كما أن حذف مفتاح اسمه token من التفضيلات لا يحذف رمزًا مخزنًا في FlutterSecureStorage ولا يبطل الجلسة لدى الخادم.

إزالة مفتاح واحد مع انتظار العملية

NamesStore.remove في المثال التالي يستخدم SharedPreferencesAsync.remove. هذه الواجهة تعيد Future<void>، لذلك لا تختبر ناتجها كأنه bool مثل واجهة SharedPreferences القديمة. عند نجاح await انتقل للخطوة التالية، وعند فشل التخزين دع المستدعي يعرض الخطأ أو يعيد المحاولة وفق سياسة التطبيق.

import 'dart:convert';
import 'package:shared_preferences/shared_preferences.dart';

class UserProfile {
  const UserProfile(this.name, this.age);
  final String name;
  final int age;
  Map<String, Object> toJson() => {'name': name, 'age': age};
  static UserProfile fromJson(Map<String, dynamic> json) {
    final name = json['name'];
    final age = json['age'];
    if (name is! String || age is! int || age < 0) {
      throw const FormatException('Invalid profile');
    }
    return UserProfile(name, age);
  }
}

class ProfileStore {
  ProfileStore(this.prefs);
  final SharedPreferencesAsync prefs;
  static const key = 'profile_v1';
  Future<void> save(UserProfile profile) => prefs.setString(
      key, jsonEncode({'schema': 1, 'profile': profile.toJson()}));
  Future<UserProfile?> read() async {
    final raw = await prefs.getString(key);
    if (raw == null) return null;
    try {
      final value = jsonDecode(raw);
      if (value is! Map<String, dynamic> || value['schema'] != 1) return null;
      final profile = value['profile'];
      if (profile is! Map<String, dynamic>) return null;
      return UserProfile.fromJson(profile);
    } on FormatException {
      return null;
    }
  }
}

class NamesStore {
  NamesStore(this.prefs);
  final SharedPreferencesAsync prefs;
  static const key = 'saved_names_v1';
  Future<void> save(List<String> names) => prefs.setStringList(key, names);
  Future<List<String>> read() async => await prefs.getStringList(key) ?? [];
  Future<void> remove() => prefs.remove(key);
}

مسح بيانات الحساب دون تدمير التفضيلات

أنشئ قائمة واضحة بالمفاتيح المرتبطة بالحساب، مثل ملف المستخدم وبيانات البحث المحلية، واحذفها بأسمائها. أبقِ تفضيلات الجهاز التي يرغب المستخدم بالاحتفاظ بها. إذا استُخدمت مفاتيح تتضمن معرّف الحساب فلا تتركها قابلة للقراءة بعد التبديل إلى حساب آخر.

بالنسبة إلى المصادقة، استخدم SessionStore.signOut في الدرس المرتبط لحذف رمز التخزين الآمن، وامسح نسخة الذاكرة ورؤوس الطلبات المشتقة منه. لا تطبع الرمز للتأكد من حذفه؛ اختبر غياب المفتاح أو حالة الجلسة بدل إظهار قيمة حساسة في السجل.

متى تنتقل إلى شاشة الدخول؟

انتظر المسح المطلوب قبل التنقل، ثم تحقق من context.mounted إذا كنت تستخدم سياق الشاشة بعد await. أوقف الطلبات التي قد تعيد ملء كاش الحساب بعد الخروج. إذا كان هناك طلب شبكة جارٍ من حساب قديم فلا تسمح لوصوله المتأخر بإعادة عرض معلوماته في الحساب الجديد.

لا تخلط بين فشل اتصال إلغاء الجلسة وفشل الحذف المحلي. قد تحتاج إلى إكمال الخروج من الجهاز حتى لو تعذر الاتصال، مع اعتماد سياسة يحددها المنتج. أما ضمان إبطال الرمز في جميع الأجهزة فيحتاج دعم الخادم ولا يمكن إنجازه بحذف قيمة من الهاتف وحده.

اختبار المسح والترحيل

اختبر حذف مفتاح غير موجود، والخروج مرتين، والعودة إلى التطبيق بعد إغلاقه، وبقاء اللغة والمظهر كما اختارهما المستخدم. إذا غيرت واجهة التفضيلات أو backend التخزين، تأكد من حذف المفتاح من مخزنه الفعلي؛ وجود الاسم نفسه في واجهتين لا يعني أنهما تقرآن المكان نفسه. راجع ترحيل المفاتيح القديمة بدل ترك نسخة حساسة منسية.

مراجع التنفيذ

لإكمال هذا الجزء، انتقل إلى حفظ حالة Onboarding ورمز الجلسة في Flutter بطريقة صحيحة، ثم طبّق الربط الذي يناسب بنية مشروعك.

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع