شارك المقالة
Bindings في GetX: ربط Controller بمسار Flutter وإدارة عمره

Bindings في GetX: ربط Controller بمسار Flutter وإدارة عمره

تعلّم Bindings في GetX لتسجيل Controller عند فتح المسار، والوصول إليه عبر GetView وتنظيم عمره دون إنشاء اعتماديات متكررة داخل…

تعلّم Bindings في GetX لتسجيل Controller عند فتح المسار، والوصول إليه عبر GetView وتنظيم عمره دون إنشاء اعتماديات متكررة داخل build.

لماذا نستخدم Binding؟

Bindings في GetX تجمع تسجيل اعتماديات الشاشة في مكان معروف عند الدخول إلى مسارها. بدل أن تبحث في عدة Widgets عن Get.put، يصبح واضحًا ما الذي تحتاجه صفحة الإعدادات قبل عرضها. لا يعني ذلك أن Binding تحفظ البيانات على القرص أو أنها مدير قاعدة بيانات. هي وسيلة لتنظيم الاعتماديات ودورة حياتها، وتبقى مسؤولية منطق الحالة والتخزين في الكائنات المناسبة.

إنشاء Controller للصفحة

يحتوي SettingsController على قيمة enabled تفاعلية ودالة toggle. أبقِ سلوك الصفحة هنا بدل وضع كل تغيير داخل الزر، لكن لا تنقل تفاصيل العرض كلها إلى المتحكم. إذا ملك Controller موارد مثل StreamSubscription أو TextEditingController فأغلقها في onClose. عمر الشاشة قد ينتهي قبل انتهاء طلب غير متزامن، لذلك تحتاج أيضًا تجاهل النتائج المتأخرة أو إلغاء العمل الذي تملكه.

تسجيل الاعتماد في dependencies

تستخدم SettingsBinding دالة dependencies لتسجيل مصنع Get.lazyPut<SettingsController>. ينشأ المتحكم عندما يطلبه المستهلك لأول مرة، وليس بالضرورة في لحظة تسجيل المصنع. هذا يختلف عن إنشاء المتحكم مباشرة ثم تمريره إلى Get.put. راجع الفروق بين put وlazyPut وfind قبل اختيار permanent أوfenix حتى لا تستخدم عمرًا عالميًا لحالة خاصة بصفحة عابرة.

توصيل Binding إلى GetPage

يعرف GetMaterialApp مسار /settings ويعطيه binding: SettingsBinding(). افتح المسار عبر Get.toNamed حتى يجري تفعيل الاعتماديات المرتبطة به. إذا عرضت SettingsView مباشرة خارج هذا المسار، فلن يصبح التسجيل موجودًا تلقائيًا لمجرد أن اسم الكلاس ينتهي بـView. يمكن تسجيله صراحة في اختبار معزول أو استخدام نطاق مناسب، لكن ينبغي أن يكون سبب التسجيل ظاهرًا.

الوصول عبر GetView وObx

يوفر GetView<SettingsController> الوصول إلى الاعتماد بالـcontroller getter، ويعيد Obx بناء الجزء الذي يقرأ enabled.value عند تغيرها. GetView لا ينشئ المتحكم بنفسه، ووجوده لا يغني عن Binding. لا تنشئ Controller جديدًا داخل build لمعالجة خطأ Get.find؛ قد يؤدي ذلك إلى واجهة تقرأ نسخة وأزرار تحدث نسخة أخرى، مع سلوك يبدو غير ثابت بين التنقلات.

إغلاق الصفحة وإعادة فتحها

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

التسجيلات المتعددة والوسوم

إذا احتجت أكثر من نسخة من النوع نفسه، صمم tags ثابتة ومرر الوسم نفسه عند التسجيل والبحث. تجنب استخدام اسم عشوائي جديد كل مرة فتفقد القدرة على العثور على النسخة المقصودة. كما لا تسجل اعتمادًا عالميًا دائمًا ثم تتوقع أن Binding صفحة أخرى تستبدله دون مراجعة. وضوح الهوية والعمر يمنع أخطاء يصعب حلها بتكرار Get.put في كل شاشة.

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

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

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

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

flutter pub add get

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

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

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

class SettingsController extends GetxController {
  final enabled=false.obs;
  void toggle() => enabled.toggle();
}
class SettingsBinding extends Bindings {
  @override
  void dependencies() => Get.lazyPut<SettingsController>(()=>SettingsController());
}
class SettingsView extends GetView<SettingsController> {
  const SettingsView({super.key});
  @override
  Widget build(BuildContext context) => Scaffold(
    appBar: AppBar(title: const Text('Settings')),
    body: Obx(()=>SwitchListTile(title: const Text('Enabled'),
      value:controller.enabled.value,onChanged:(_)=>controller.toggle())),
  );
}
class BindingDemo extends StatelessWidget {
  const BindingDemo({super.key});
  @override
  Widget build(BuildContext context) => GetMaterialApp(
    initialRoute:'/',getPages:[
      GetPage(name:'/',page:()=>Scaffold(body: Center(child:ElevatedButton(
        onPressed:()=>Get.toNamed('/settings'),child:const Text('Open settings'))))),
      GetPage(name:'/settings',page:()=>const SettingsView(),binding:SettingsBinding()),
    ],
  );
}

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

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

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