شارك المقالة
MultiBlocProvider في Flutter: توفير أكثر من Cubit بنطاق واضح

MultiBlocProvider في Flutter: توفير أكثر من Cubit بنطاق واضح

شرح MultiBlocProvider في Flutter لتوفير أكثر من Cubit، مع ترتيب الاعتماديات وفصل إعادة البناء وفهم الفرق بين create وBlocProvider.value.

شرح MultiBlocProvider في Flutter لتوفير أكثر من Cubit، مع ترتيب الاعتماديات وفصل إعادة البناء وفهم الفرق بين create وBlocProvider.value.

ما الذي يغيره MultiBlocProvider؟

MultiBlocProvider في Flutter يجعل تسجيل عدة BlocProvider أكثر وضوحًا بدل تداخل Widgets كثيرة، لكنه لا يدمج الحالات أو يجعل كل Cubit يعرف الآخرين تلقائيًا. في المثال حالة للثيم وأخرى لعدد عناصر السلة. يظل لكل كائن نوعه ومسؤوليته، ويختار المستهلك أي حالة يقرأ. هذا الفصل يساعدك على فهم ما يعاد بناؤه عندما يتغير إعداد عرض أو بيانات عمل.

تحديد نطاق المزودات

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

ترتيب الاعتماديات داخل القائمة

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

create وملكية الإغلاق

عند استخدام BlocProvider(create:…) تكون النسخة التي ينشئها المزود تحت ملكيته المعتادة ويغلقها عند إزالة النطاق. BlocProvider.value مخصص لتوفير نسخة موجودة إلى فرع آخر ولا يغلقها تلقائيًا، لذلك لا تستخدمه لإنشاء كائن جديد دون مالك واضح. كما أن الإنشاء افتراضيًا كسول؛ إن احتجت التهيئة المبكرة فاختر lazy:false عن قصد وراجع تكلفة التشغيل.

فصل إعادة البناء بين الحالات

يلف BlocBuilder الخاص بالثيم MaterialApp لأنه يغير إعداد المظهر، بينما يقرأ جزء السلة CartCubit وحده. لا تضع قائمة سلة كاملة داخل حالة الثيم لمجرد أنها متاحة. يمكنك استخدام BlocSelector لاختيار جزء مناسب عندما تصبح الحالة أكبر، لكن ابدأ بقياس الحاجة. الشكل الأقصر للكود لا يضمن تلقائيًا بناء أقل؛ حدود المستهلك وما يقرؤه هي ما يحدد السلوك.

أخطاء الأنواع المتكررة

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

ربط التحميل والأخطاء

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

اختبارات النطاق والعزل

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

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

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

flutter pub add flutter_bloc

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

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

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

class ThemeCubit extends Cubit<bool>{ThemeCubit():super(false);void toggle()=>emit(!state);}
class CartCubit extends Cubit<int>{CartCubit():super(0);void add()=>emit(state+1);}
class MultiCubitDemo extends StatelessWidget {
  const MultiCubitDemo({super.key});
  @override
  Widget build(BuildContext context)=>MultiBlocProvider(providers:[
    BlocProvider(create:(_)=>ThemeCubit()),BlocProvider(create:(_)=>CartCubit()),
  ],child:BlocBuilder<ThemeCubit,bool>(builder:(context,dark)=>MaterialApp(
    theme:ThemeData.light(),darkTheme:ThemeData.dark(),themeMode:dark?ThemeMode.dark:ThemeMode.light,
    home:const MultiCubitPage(),
  )));
}
class MultiCubitPage extends StatelessWidget {
  const MultiCubitPage({super.key});
  @override
  Widget build(BuildContext context)=>Scaffold(body:Column(children:[
    BlocBuilder<CartCubit,int>(builder:(context,count)=>Text('Cart: $count')),
    ElevatedButton(onPressed:context.read<CartCubit>().add,child:const Text('Add')),
    ElevatedButton(onPressed:context.read<ThemeCubit>().toggle,child:const Text('Theme')),
  ]));
}

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

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

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