افهم الفرق بين Get.put وGet.lazyPut وGet.find في Flutter، ومتى تستخدم tags وfenix وpermanent، ولماذا لا تعني بقاء الحالة حفظها بعد إغلاق التطبيق.
التسجيل ليس هو البحث
Get.put وGet.lazyPut وGet.find تنظم الوصول إلى الاعتماديات في GetX، لكنها ليست ثلاث صيغ متطابقة لإنشاء Controller. put يسجل كائنًا متاحًا مباشرة، وlazyPut يسجل مصنعًا مؤجلًا، وfind يطلب اعتمادًا مسجلًا. تحديد الدور بدقة يمنع خطأ شائعًا مثل تخزين نتيجة lazyPut في متغير ثم استعمالها كأنها Controller؛ التسجيل المؤجل ليس هو الكائن الذي ستطلبه لاحقًا.
متى يناسب Get.put؟
استخدم put عندما تكون النسخة جاهزة وتحتاج تسجيلها في النطاق المناسب. أنشئها في نقطة تهيئة واضحة أو Binding، لا في كل مرور على build. إذا كانت النسخة تعتمد على تهيئة غير متزامنة، فقد تحتاج putAsync وانتظار اكتمالها بدل حقل late يقرأه العرض مبكرًا. يشرح درس GetxService مثالًا لخدمة إعدادات تُقرأ قبل بناء واجهة تعتمد عليها.
متى يناسب Get.lazyPut؟
lazyPut يحتفظ بدالة إنشاء إلى أن تطلب النسخة عبر find. قد يقلل ذلك الإنشاء غير الضروري عندما لا يصل المستخدم إلى الشاشة، لكنه لا يحل مشاكل التهيئة غير المتزامنة تلقائيًا. لا تضع عمليات شبكة ذات أثر جانبي داخل مصنع يَفترض أنه سينفذ مرة واحدة طوال عمر التطبيق؛ راجع متى يمكن إزالة النسخة وإعادة تكوينها، وما البيانات التي ينبغي تحميلها من مستودع مستقل.
التعامل الصحيح مع Get.find
يحتاج find نوعًا مسجلًا ووسمًا مطابقًا إن استخدمت tags. إذا كانت GetX تقول إن الاعتماد غير موجود، افحص ترتيب التسجيل والمسار والنوع والوسم قبل إضافة put جديد عشوائي. في المثال نسجل ItemController بوسمين مختلفين للسلة والمسودة، ثم نطلب كل نسخة صراحة. مشاركة النوع نفسه لا تعني مشاركة النسخة نفسها عندما تختلف هويتها في سجل الاعتماديات.
ما معنى fenix؟
يسمح fenix بإبقاء مصنع مناسب لإعادة إنشاء الاعتماد بعد إزالة نسخته وفق سياسة GetX، لكنه لا يعيد تلقائيًا القيم السابقة في الذاكرة. إذا وصل العداد إلى خمسة ثم أزيل وأعيد إنشاؤه من منشئ يبدأ بصفر، فقد يعود بصفر. لا تصفه بأنه طريقة لحفظ البيانات بعد الرجوع أو بعد إغلاق التطبيق. اختبر الإزالة وإعادة البحث وتوقع نسخة جديدة، لا استعادة تخزين لم تنفذه أصلًا.
ما معنى permanent؟
permanent يتعلق بمنع الإزالة التلقائية المعتادة للاعتماد داخل تشغيل التطبيق، وليس كتابة البيانات على القرص. استعماله بكثرة قد يبقي موارد وشاشات منطقية أطول من الحاجة، خاصة إذا نسيت إغلاق مستمعين أو ربطت بيانات مستخدم داخل كائن عالمي. إذا كانت الحالة تحتاج الاستعادة بعد إنهاء العملية فراجع HydratedBloc أو وسيلة تخزين أخرى مناسبة، مع الانتباه لاختلاف أدوات إدارة الحالة.
ترتيب الكود مع Bindings
تجميع التسجيل داخل Binding خاص بالمسار يجعل سبب وجود الاعتماد وعمره أوضح. لا تجعل Widgets مختلفة تتنافس على تسجيل النوع نفسه دون tags. أبقِ مصدر الحقيقة للقيم في نسخة واحدة يقرأها العرض وتحدثها الأزرار. وإذا كانت الصفحة تعرض عدادًا، فإن صحة التسجيل وحدها لا تكفي لتحديث النص؛ يلزم استخدام Obx أو GetBuilder وفق نوع الحالة.
اختبار الهوية والعمر
اختبر أن استدعاء find مرتين يعيد النسخة المسجلة نفسها، وأن الوسمين cart وdraft لا يختلطان. غيّر قيمة نسخة المسودة ثم أزلها وأعد طلبها لتفحص أثر fenix. نظف سجل GetX بين الاختبارات حتى لا يمر اختبار اعتمادًا على تسجيل سابق، لكن لا تنقل سياسة تنظيف الاختبارات الشامل إلى زر عادي في المنتج. الوضوح في الملكية أهم من إخفاء الخطأ بتسجيلات إضافية.
الإعداد أو عقد التكامل المطلوب
طبّق الجزء المناسب على مشروعك بعد مراجعة إصدار الحزمة والمنصة؛ قيم الإعداد هنا توضيحية وليست مفاتيح صالحة أو خدمة خلفية منشورة.
flutter pub add getالمثال التطبيقي المراجع
احفظ المثال في ملف مستقل داخل مشروع تجريبي مع الحزم المذكورة. يوضح الكود نطاق الدرس؛ أضف إعدادات مشروعك واختبر المنصة المستهدفة قبل الاعتماد عليه في تطبيق قائم.
import 'package:get/get.dart';
class ItemController extends GetxController {
final count=0.obs;
void increment()=>count.value++;
}
void registerControllers() {
Get.put<ItemController>(ItemController(),tag:'cart');
Get.lazyPut<ItemController>(()=>ItemController(),tag:'draft',fenix:true);
}
ItemController cartController()=>Get.find<ItemController>(tag:'cart');
ItemController draftController()=>Get.find<ItemController>(tag:'draft');






