شارك المقالة
دورة حياة تطبيق Flutter باستخدام AppLifecycleListener

دورة حياة تطبيق Flutter باستخدام AppLifecycleListener

شرح دورة حياة Flutter وحالات التطبيق باستخدام AppLifecycleListener، مع إغلاق المستمع وفهم حدود إشعارات الخلفية وحفظ البيانات.

شرح دورة حياة Flutter وحالات التطبيق باستخدام AppLifecycleListener، مع إغلاق المستمع وفهم حدود إشعارات الخلفية وحفظ البيانات.

التطبيق والصفحة مستويان مختلفان

وجود State داخل Widget لا يعني أن أحداثه تصف حياة التطبيق كله. initState وdispose يتعلقان بعمر ذلك الكائن في الشجرة، بينما resumed وinactive وhidden وpaused وdetached تعبر عن حالات التطبيق بحسب المنصة. التنقل من صفحة لأخرى قد يبقي التطبيق resumed، والانتقال للخلفية قد يبقي State موجودًا دون dispose. افصل المفهومين عند تصميم حفظ النماذج أو إيقاف الفيديو أو إعادة مزامنة البيانات حتى لا تعتمد وظيفة مهمة على حدث لا يخصها.

لا تفترض تسلسلًا مضمونًا

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

اختيار المستمع وإدارة ملكيته

يوفر AppLifecycleListener واجهة للاستماع لحالات التطبيق في الإصدارات الداعمة. يمكن أيضًا استخدام WidgetsBindingObserver في مشروع مناسب، لكن يجب إزالة observer الذي أضفته عند انتهاء مالكه. المثال ينشئ listener واحدًا داخل initState ويتخلص منه في dispose. لا تنشئه داخل build، ولا تفترض أن إلغاء المستمع يوقف الخدمات والاشتراكات الأخرى التي يملكها التطبيق. كل مورد له مالك واضح وطريقة إغلاق خاصة به.

متى تعيد تحميل البيانات؟

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

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

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

سيناريوهات الاختبار

جرّب الضغط على Home وقفل الشاشة وفتح منتقي ملفات واستقبال نافذة نظام والتبديل بين التطبيقات ثم العودة. سجّل أسماء الحالات فقط في نسخة تشخيصية وقارن النتيجة بين Android وiOS حيث يلزم. اختبر إعادة إنشاء الصفحة للتأكد أن listener القديم لم يعد يستدعى، وافصل هذا عن اختبار قتل العملية واستعادة الحالة. المثال يغيّر نصًا فقط ولا ينفذ تحميلًا أو تسجيل خروج، كي تستطيع ملاحظة الأحداث دون آثار جانبية على بيانات أو جلسات حقيقية.

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

المثال التطبيقي

المثال مستقل للتعلم. شغّله داخل مشروع تجريبي، ثم بدّل مصدر البيانات المحلي بخدمة مشروعك بعد اختبار حالات النجاح والفشل. لا تنسخ أكثر من دالة main إلى الملف نفسه.

import 'package:flutter/material.dart';
void main() => runApp(const MaterialApp(home: DemoPage()));
class DemoPage extends StatefulWidget {
  const DemoPage({super.key});
  @override
  State<DemoPage> createState() => _DemoPageState();
}
class _DemoPageState extends State<DemoPage> {
  late final AppLifecycleListener _listener;
  String _state = WidgetsBinding.instance.lifecycleState?.name ?? 'unknown';
  @override
  void initState() {
    super.initState();
    _listener = AppLifecycleListener(onStateChange: (state) {
      if (!mounted) return;
      setState(() { _state = state.name; });
    });
  }
  @override
  void dispose() { _listener.dispose(); super.dispose(); }
  @override
  Widget build(BuildContext context) => Scaffold(
    appBar: AppBar(title: const Text('App lifecycle')),
    body: Center(child: Text('Application state: $_state')),
  );
}

التوثيق والتجربة

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

الصور والفيديو من الشرح السابق

الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.

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

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