افهم GetxService في Flutter والفرق بين الخدمة والمتحكم، مع Get.putAsync وانتظار التهيئة وحفظ تفضيلات العرض دون خلطها بالذاكرة الدائمة.
ما دور الخدمة؟
GetxService في Flutter مناسب لكائن يقدم وظيفة مشتركة مثل الوصول إلى إعدادات التطبيق أو مستودع بيانات على مستوى أوسع من صفحة واحدة. الخدمة ليست مرادفًا تلقائيًا لطلب شبكة، ولا قاعدة بيانات تحفظ كل ما يوضع في حقولها. اسأل أولًا من يحتاج الكائن ومن يملك دورة حياته، ثم اختر هل نطاقه خدمة تطبيق أم متحكم شاشة مرتبط بمسار معين.
الخدمة تختلف عن GetxController
عادة يُربط GetxController بسلوك واجهة أو مسار ويمكن إزالته وفق إدارة GetX للاعتماديات. GetxService مصمم للبقاء عبر التنقل ولا تتعامل معه الحزمة كاعتماد صفحة عادي قابل للإزالة التلقائية. هذا البقاء داخل العملية لا يعني أن قيمة المتغير ستبقى بعد إنهاء التطبيق. للحفظ الفعلي تحتاج تخزينًا مناسبًا، وتقرأه مجددًا عند تهيئة الخدمة التالية.
تهيئة غير متزامنة يمكن انتظارها
يعيد init كائن الخدمة بعد تحميل القيمة من SharedPreferencesAsync، ويسجله registerAppSettings باستخدام Get.putAsync مع await. نفذ التسجيل بعد تهيئة Flutter وقبل بناء واجهة تعتمد عليه. لا تجعل init يعيد void ثم تحاول استعمال الخدمة فورًا قبل انتهاء قراءة التخزين. انتظار التهيئة يسمح بعرض خطأ مفهوم أو سياسة قيمة افتراضية بدل late حقل غير جاهز.
تحديث التفضيل والتعامل مع الفشل
تحفظ setDark القيمة أولًا ثم تحدث RxBool عند نجاح العملية. هذا يجعل حالة المثال تعكس نجاح كتابة التفضيل، لكنه قد يحتاج مؤشر انتظار في الواجهة. إن اخترت تحديثًا متفائلًا فاحتفظ بإمكانية الرجوع عند الفشل. لا تبتلع الاستثناء وتعرض رسالة تم الحفظ في كل الحالات، ولا تطلق عمليات كتابة متعارضة بسرعة دون تنظيم إذا كان إعدادك قابلًا للتغيير المتكرر.
الوصول إلى النسخة نفسها
بعد التسجيل استخدم Get.find<AppSettingsService>() بدل إنشاء AppSettingsService جديد في كل صفحة. البحث يجد اعتمادًا مسجلًا، ولا ينشئ التخزين تلقائيًا إذا نسيت التسجيل. ضع التسجيل في نقطة تشغيل واضحة؛ يشرح Get.put وlazyPut وfind الفرق بين التسجيل الفوري والمصنع المؤجل. تجنب وجود نسختين تحملان الإعداد نفسه وتختلف قيمتهما حسب الصفحة المفتوحة.
التنظيف وتبديل الحسابات
لا تستخدم Get.reset في التطبيق كحل روتيني لإغلاق متحكم شاشة؛ قد يؤثر على خدمات واعتماديات أخرى. عند تسجيل الخروج صمم تنظيف البيانات المرتبطة بالحساب داخل المستودعات المعنية، وافصل تفضيل الوضع الداكن عن بيانات المستخدم الحساسة. الخدمة ذات العمر الطويل يمكن أن تصبح مصدر ذاكرة قديمة إذا احتفظت ببيانات حساب سابق دون مسحها أو إعادة تحميلها في الوقت الصحيح.
متى لا تحتاج خدمة عالمية؟
حقل بحث مؤقت أو حالة نموذج لا يتشاركه أحد قد يناسبه Controller محدود النطاق عبر Binding خاص بالشاشة. أما اللغة والثيم فلهما عادة نطاق تطبيق، ويمكن تنظيم تغيير اللغة على نهج قريب من المثال. لا تجعل الخدمة العالمية مكانًا لكل متغير جديد؛ تقسيم المسؤوليات يحسن الاختبار ويمنع الترابط بين ميزات لا تحتاج معرفة تفاصيل بعضها.
اختبارات التهيئة والعمر
اختبر تهيئة ناجحة وقيمة غير موجودة وفشل القراءة والكتابة، ثم تأكد أن Get.find يعيد النسخة المتوقعة. استخدم تخزينًا بديلًا أو adapter في الاختبار حتى لا تغير تفضيلات جهاز المستخدم. لا تعتمد على خدمة سابقة تركها اختبار آخر في سجل GetX؛ نظف السجل بين الاختبارات فقط. إذا احتجت حفظ حالات Bloc فراجع HydratedBloc بدل خلط نمطي التخزين دون سبب.
الإعداد أو عقد التكامل المطلوب
طبّق الجزء المناسب على مشروعك بعد مراجعة إصدار الحزمة والمنصة؛ قيم الإعداد هنا توضيحية وليست مفاتيح صالحة أو خدمة خلفية منشورة.
flutter pub add get shared_preferencesالمثال التطبيقي المراجع
احفظ المثال في ملف مستقل داخل مشروع تجريبي مع الحزم المذكورة. يوضح الكود نطاق الدرس؛ أضف إعدادات مشروعك واختبر المنصة المستهدفة قبل الاعتماد عليه في تطبيق قائم.
import 'package:get/get.dart';
import 'package:shared_preferences/shared_preferences.dart';
class AppSettingsService extends GetxService {
AppSettingsService(this.preferences);
final SharedPreferencesAsync preferences;
final dark = false.obs;
Future<AppSettingsService> init() async {
dark.value = await preferences.getBool('dark') ?? false;
return this;
}
Future<void> setDark(bool value) async {
await preferences.setBool('dark',value);
dark.value=value;
}
}
Future<void> registerAppSettings() async {
await Get.putAsync<AppSettingsService>(() =>
AppSettingsService(SharedPreferencesAsync()).init());
}






