شارك المقالة
شرح Bloc وCubit في Flutter مع مثال عداد وحالة typed

شرح Bloc وCubit في Flutter مع مثال عداد وحالة typed

مقدمة عملية لشرح Bloc وCubit في Flutter: فصل المنطق عن العرض، واستخدام emit وBlocProvider وBlocBuilder وفهم ملكية الكائن وإغلاقه.

مقدمة عملية لشرح Bloc وCubit في Flutter: فصل المنطق عن العرض، واستخدام emit وBlocProvider وBlocBuilder وفهم ملكية الكائن وإغلاقه.

الفكرة قبل الحزمة

شرح Bloc وCubit في Flutter يبدأ بفصل منطق التغيير عن Widget التي تعرضه. يحمل Cubit حالة حالية ويصدر حالات جديدة من خلال دوال واضحة، بينما يستخدم Bloc أحداثًا ومعالجاتها لإنتاج الحالات. كلاهما يمكن أن يندمج مع flutter_bloc، ولا يعني استعمال أحدهما أن التطبيق صار منظمًا تلقائيًا. تصميم مصدر البيانات وملكية الحالة واختبارات السلوك تبقى مسؤولية التطبيق.

استخدام الحالة كمصدر للحقيقة

يمتد CounterCubit من Cubit<int> ويبدأ بصفر، ثم يرسل emit(state + 1) أو emit(state – 1). لا نحتاج إلى حقل counter آخر وحالات Plus وMinus بلا قيمة تعتمد الشاشة بعدها على متغير جانبي. المثال الأبسط يوضح أن الحالة المنشورة هي نفسها ما يعرضه المستهلك. في حالة أعقد يمكنك استخدام نموذج غير قابل للتغيير يحتوي البيانات وحالة التحميل والخطأ.

لماذا إنشاء المزود خارج المستهلك؟

ينشئ BlocProvider الكائن ويضعه فوق CounterPage في شجرة Widgets. يقرأ المستهلك النسخة من سياق يقع تحت المزود، فلا يبحث عن اعتماد غير متاح في سياقه. يتولى provider الذي يستخدم create إغلاق الكائن الذي أنشأه عند إزالة النطاق. لا تغلق الكائن يدويًا من كل Widget تقرأه؛ الملكية الواضحة تمنع إغلاق حالة ما زالت أجزاء أخرى تستعملها.

متى يعاد بناء الواجهة؟

يعيد BlocBuilder بناء الجزء الذي يعرض الحالة عند التغييرات المناسبة. استخدم builder لإنتاج Widgets، ولا تجعل كل إعادة بناء تطلق طلب شبكة أو تنقلًا أو رسالة. للآثار التي يجب أن تحدث استجابة لتغيير استخدم BlocListener أو BlocConsumer وفق الحاجة. لا تجعل رسالة نجاح الحفظ تظهر مرارًا لأن الصفحة أعيد بناؤها لأسباب لا علاقة لها بالعملية.

الاختيار بين Cubit وBloc

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

المشاركة بين الشاشات

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

الحفظ ليس جزءًا تلقائيًا من Cubit

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

كيف تختبر المثال وتطوره؟

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

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

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

flutter pub add flutter_bloc

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

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

import 'package:flutter/material.dart';
import 'package:flutter_bloc/flutter_bloc.dart';

class CounterCubit extends Cubit<int> {
  CounterCubit():super(0);
  void increment()=>emit(state+1);
  void decrement()=>emit(state-1);
}
class BlocCounterDemo extends StatelessWidget {
  const BlocCounterDemo({super.key});
  @override
  Widget build(BuildContext context)=>BlocProvider(
    create:(_)=>CounterCubit(),child:const MaterialApp(home:CounterPage()));
}
class CounterPage extends StatelessWidget {
  const CounterPage({super.key});
  @override
  Widget build(BuildContext context)=>Scaffold(body:BlocBuilder<CounterCubit,int>(
    builder:(context,count)=>Row(mainAxisAlignment:MainAxisAlignment.center,children:[
      IconButton(onPressed:context.read<CounterCubit>().decrement,icon:const Icon(Icons.remove)),
      Text('$count',key:const ValueKey('count')),
      IconButton(onPressed:context.read<CounterCubit>().increment,icon:const Icon(Icons.add)),
    ])));
}

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

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

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