شارك المقالة
شرح RouteObserver وRouteAware في Flutter لمراقبة الرجوع

شرح RouteObserver وRouteAware في Flutter لمراقبة الرجوع

استخدام RouteObserver وRouteAware في Flutter لملاحظة تغطية الصفحة والرجوع إليها، مع ربط observer الصحيح وإلغاء الاشتراك وفهم الفرق عن دورة…

استخدام RouteObserver وRouteAware في Flutter لملاحظة تغطية الصفحة والرجوع إليها، مع ربط observer الصحيح وإلغاء الاشتراك وفهم الفرق عن دورة حياة التطبيق.

ماذا نراقب؟

قد تحتاج الصفحة معرفة أن صفحة تفاصيل غطتها أو أن المستخدم عاد إليها، مثل تحديث عنوان أو مراجعة بيانات تغيرت. RouteAware يصف علاقة المسار بالمسارات التي تمر عبر observer المختار، ولا يراقب تلقائيًا كل ما يحدث في التطبيق. انتقال التطبيق للخلفية وقفل الجهاز وتغير الاتصال أحداث مختلفة تحتاج أدواتها الخاصة. تبديل فهرس داخل IndexedStack لا يدفع مسارًا جديدًا بالضرورة، ولذلك لن يتحول كل تبديل تبويب إلى didPush أو didPopNext.

ربط المراقب بالمتصفح الصحيح

أنشئ RouteObserver ثابتًا لعمر Navigator واربطه داخل navigatorObservers. الاشتراك في كائن غير الموجود على المتصفح الذي يدير الصفحة لن ينتج الإشعارات المتوقعة. عند وجود Navigator مستقل لكل تبويب لا تجعل كائن observer واحدًا يتنقل بين عدة متصفحات متزامنة؛ حدد مالكًا مستقلًا لكل واحد. لا تحتاج Bloc أو Cubit لاستخدام RouteAware، ويمكن إضافة تنسيق مع إدارة الحالة لاحقًا إذا كان هناك سبب واضح، بدل جعل أصناف غير موجودة شرطًا لفهم المثال.

معنى callbacks وحدود النوع

didPush يخبر المشترك بإضافة مساره، وdidPushNext بتغطية مساره بمسار تال مناسب، وdidPopNext بإزالة التالي والعودة إليه، وdidPop بإزالة مساره. اختيار PageRoute يحدد أنواع الانتقالات التي يراقبها المثال؛ فتح حوار ليس هو نفسه دفع صفحة MaterialPageRoute في كل إعداد. إذا احتجت مراقبة أنواع ModalRoute أخرى فاختر النوع المناسب واختبر السيناريو المطلوب. لا تكتب رسالة مغادرة نهائية للحساب لمجرد أن صفحة غطت الأخرى مؤقتًا.

الاشتراك وإلغاء الاشتراك

يمكن الحصول على ModalRoute من didChangeDependencies لأنه يعتمد على سياق الشجرة. قارن المسار بالمسار المشترك سابقًا لتجنب أعمال إعداد متكررة إذا تغير اعتماد آخر، ثم ألغِ الاشتراك القديم عند الحاجة. في dispose ألغِ الاشتراك دائمًا. المثال يغير نص حالة بسيطًا، ويتيح didPush تحديث القيمة مباشرة خلال الاشتراك الأول؛ بقية الأحداث تحدث بعد اكتمال البناء فتستدعي setState عند بقاء State حيًا. تجنب إدخال طلب شبكة أو فتح حوار عشوائي داخل مرحلة بناء الواجهة.

تحديث البيانات بعد العودة

يمكن استخدام didPopNext لإطلاق تحديث، لكن لا ترسل طلبًا غير محدود كلما أُغلق مسار. افصل التحميل عن build، ومنع تداخل الطلبات والردود القديمة ومعالجة الفشل سيظل مطلوبًا. إذا كانت صفحة التفاصيل تعيد نتيجة واضحة عبر Navigator.pop فقد يكون انتظار نتيجة push أبسط من مراقبة كل عودة. لا تجمع الآليتين لتحديث المصدر نفسه مرتين دون سبب. كذلك لا تسجل مسارات تحوي معرّفات حساسة أو تفاصيل شخصية لمجرد أنك تبني سجلًا للتنقل.

تجربة المثال ومراجعته

افتح التفاصيل ثم ارجع وراقب تحول النص إلى Returned to page. كرر العملية وتأكد أن الاشتراك لا يتضاعف، ثم أزل الصفحة وافحص عدم وجود تحديث بعد dispose. اختبر متصفحًا داخليًا منفصلًا إذا استعملته في مشروعك، وحوارًا وتبديل تبويب حتى تفهم الأحداث التي لا يغطيها المثال. قياس ظهور الصفحة فعليًا للمستخدم أو إرسال analytics يحتاج تعريفًا أدق للحدث والخصوصية، ولا يستنتج بالكامل من callback واحد. المثال محلي ولا يتصل بخادم ولا يرسل تتبعًا.

مثال مستقل للتجربة

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

import 'package:flutter/material.dart';
final routeObserver = RouteObserver<PageRoute<dynamic>>();
void main() => runApp(MaterialApp(navigatorObservers: [routeObserver], home: const DemoPage()));
class DemoPage extends StatefulWidget {
  const DemoPage({super.key});
  @override
  State<DemoPage> createState() => _DemoPageState();
}
class _DemoPageState extends State<DemoPage> with RouteAware {
  PageRoute<dynamic>? _route;
  String _status = 'Ready';
  @override
  void didChangeDependencies() {
    super.didChangeDependencies();
    final next = ModalRoute.of(context);
    if (next is PageRoute<dynamic> && next != _route) {
      routeObserver.unsubscribe(this);
      _route = next;
      routeObserver.subscribe(this, next);
    }
  }
  @override
  void didPush() { _status = 'Page opened'; }
  @override
  void didPushNext() { if (mounted) setState(() { _status = 'Covered by details'; }); }
  @override
  void didPopNext() { if (mounted) setState(() { _status = 'Returned to page'; }); }
  @override
  void dispose() { routeObserver.unsubscribe(this); super.dispose(); }
  @override
  Widget build(BuildContext context) => Scaffold(
    appBar: AppBar(title: const Text('Route observation')),
    body: ListView(padding: const EdgeInsets.all(16), children: [
      Text(_status),
      ElevatedButton(onPressed: () => Navigator.of(context).push<void>(MaterialPageRoute<void>(
        builder: (_) => Scaffold(appBar: AppBar(title: const Text('Details')), body: const Center(child: Text('Go back to observe'))),
      )), child: const Text('Open details')),
    ]),
  );
}

مرجع الواجهة البرمجية

راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.

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

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