شارك المقالة
HydratedBloc في Flutter: حفظ الحالة واستعادتها بعد إغلاق التطبيق

HydratedBloc في Flutter: حفظ الحالة واستعادتها بعد إغلاق التطبيق

شرح HydratedBloc في Flutter وتهيئة التخزين في الإصدار 11، مع HydratedCubit typed وفحص JSON وترحيل البيانات والتمييز بين الذاكرة والحفظ…

شرح HydratedBloc في Flutter وتهيئة التخزين في الإصدار 11، مع HydratedCubit typed وفحص JSON وترحيل البيانات والتمييز بين الذاكرة والحفظ الدائم.

متى تحتاج إلى HydratedBloc؟

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

الفرق بين الحفظ وقاعدة البيانات

الحالة المحفوظة ليست بديلًا تلقائيًا عن قاعدة مهام أو مزامنة مع خادم. للبيانات التي تحتاج استعلامات وسجلات متعددة وعلاقات قد تكون SQLite أو طبقة بيانات أخرى أنسب. لا تحفظ كلمات المرور أو رموز الجلسات داخل JSON عادي لمجرد أن الحزمة توفر التخزين. التشفير وإدارة مفاتيحه قرار مستقل، ولا يتحققان بمجرد كتابة اسم أداة التخزين في pubspec.

تهيئة التخزين في واجهة الإصدار 11

يستخدم المثال HydratedStorage.build مع HydratedStorageDirectory، ويختار فرع الويب أو مسار دعم التطبيق على المنصات المحلية. نفذ configureStorage بعد تهيئة Flutter وقبل إنشاء أول HydratedCubit ثم شغّل واجهتك. نسخ مثال قديم يمرر Directory مباشرة قد لا يناسب واجهة الإصدار الحالي. دليل النظام المؤقت قد يُمسح؛ اختر مسارًا يلائم نوع الحالة بدل افتراض أن كل مجلد يضمن الاحتفاظ الدائم.

حالة typed ومخطط JSON واضح

يمتد SavedCounter من HydratedCubit<int> حتى يكون نوع الحالة محددًا. يحفظ toJson رقم schema مع count، ويتحقق fromJson من النسخة ونوع العدد وحدوده قبل قبوله. عودة null تعني عدم استعادة بيانات غير مناسبة والبدء بالحالة الابتدائية، بدل cast غير آمن قد يعطل الإنشاء. عند تطوير بنية الحالة لاحقًا ضع خطة ترحيل أو مسح صريحة للبيانات القديمة.

مفاتيح التخزين وتعدد الحسابات

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

المسح وإعادة التهيئة

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

التكامل مع الواجهة والاختبارات

أنشئ الكائن عبر BlocProvider كما تفعل مع Cubit عادي، ثم اقرأ الحالة من BlocBuilder. يمكن حقن Storage في المنشئ لاختبار التحويل والاستعادة دون الاعتماد على ملفات الجهاز. افحص حالة JSON صحيحة وأخرى قديمة وقيمًا من نوع خاطئ، ثم اختبر إعادة إنشاء الكائن. إذا كان لديك عدة مديرات حالة، فراجع تنظيمها باستخدام MultiBlocProvider بدل تكرار التهيئة في كل شاشة.

حدود يجب مراعاتها

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

الإعداد أو عقد التكامل المطلوب

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

flutter pub add hydrated_bloc path_provider flutter_bloc

المثال التطبيقي المراجع

احفظ المثال في ملف مستقل داخل مشروع تجريبي مع الحزم المذكورة. يوضح الكود نطاق الدرس؛ أضف إعدادات مشروعك واختبر المنصة المستهدفة قبل الاعتماد عليه في تطبيق قائم.

import 'package:flutter/foundation.dart';
import 'package:flutter/widgets.dart';
import 'package:hydrated_bloc/hydrated_bloc.dart';
import 'package:path_provider/path_provider.dart';

Future<void> configureStorage() async {
  WidgetsFlutterBinding.ensureInitialized();
  HydratedBloc.storage = await HydratedStorage.build(
    storageDirectory: kIsWeb ? HydratedStorageDirectory.web
      : HydratedStorageDirectory((await getApplicationSupportDirectory()).path),
  );
}
class SavedCounter extends HydratedCubit<int> {
  SavedCounter({Storage? storage}) : super(0,storage:storage);
  @override
  String get storagePrefix => 'geecoders_counter_v1';
  void increment() => emit(state+1);
  @override
  int? fromJson(Map<String,dynamic> json) =>
      json['schema']==1 && json['count'] is int && (json['count'] as int)>=0
          ? json['count'] as int : null;
  @override
  Map<String,dynamic> toJson(int state) => {'schema':1,'count':state};
}

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

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

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