شارك المقالة
مراقبة نوع الشبكة في Flutter باستخدام connectivity_plus

مراقبة نوع الشبكة في Flutter باستخدام connectivity_plus

نوع الشبكة في Flutter: وجود Wi-Fi أو شبكة خلوية لا يضمن وصول طلبك إلى الإنترنت.

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

نوع الشبكة ليس ضمانًا لوصول الخدمة

قد يتصل الهاتف بشبكة Wi-Fi تحتاج صفحة تسجيل دخول، أو بشبكة محلية دون منفذ للإنترنت، وقد ينجح الوصول إلى موقع بينما تفشل واجهة تطبيقك. لذلك اجعل مراقبة النوع إشارة تساعد الواجهة والتشخيص، واستمر في معالجة أخطاء الطلب الحقيقي. نجاح DNS لاسم نطاق لا يثبت أن خادم API يعمل أو أن الجلسة صالحة. لا تستخدم الوصول إلى google.com بوصفه حكمًا نهائيًا على كل الخدمات، ولا تمنع المستخدم من مشاهدة البيانات المحفوظة بمجرد تغير الإشارة.

تثبيت الحزمة ومطابقة واجهتها

أضف connectivity_plus عبر flutter pub add connectivity_plus مع مراجعة متطلبات النسخة المتوافقة مع Flutter وAndroid وiOS لديك. الإصدارات التي يستخدمها المثال تعيد List لأن الجهاز قد يملك أكثر من نوع متاح، وليست قيمة enum مفردة كما في شروحات قديمة. استخدم أسماء القيم ولا تعتمد أرقام index؛ ترتيب enum ليس عقدًا لمنطق التطبيق. لا تنقل متطلبات بناء أحدث نسخة إلى مشروع قديم دون فحص توافق Gradle وJDK والمنصات.

القراءة الأولى وتغيّر الحالة

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

إغلاق الاشتراك وعدم إغلاق صفحات أخرى

احفظ StreamSubscription وألغِه عند dispose إذا كانت الصفحة تملكه. افحص mounted قبل تحديث State بعد await. إظهار شريط حالة داخل الصفحة أبسط من دفع صفحة انقطاع على Navigator عالمي ثم تنفيذ pop عند عودة الشبكة؛ فقد يكون المستخدم فتح صفحة مختلفة فتغلقها بالخطأ. لا تربط وجود شبكة بتغيير صلاحيات الحساب أو اعتباره مسجل الدخول. إذا احتجت نافذة تنبيه فحدد ملكيتها وكيف تمنع التكرار بدل تنفيذ تنقل في كل حدث اتصال.

سياسة فشل مفهومة

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

سيناريوهات تحقق واقعية

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

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

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

import 'dart:async';
import 'package:flutter/material.dart';
import 'package:connectivity_plus/connectivity_plus.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> {
  final _connectivity = Connectivity();
  StreamSubscription<List<ConnectivityResult>>? _subscription;
  int _revision = 0;
  String _label = 'Unknown';
  void _show(List<ConnectivityResult> values) {
    if (!mounted) return;
    setState(() { _label = values.map((value) => value.name).join(', '); });
  }
  @override
  void initState() {
    super.initState();
    _subscription = _connectivity.onConnectivityChanged.listen((values) {
      ++_revision;
      _show(values);
    }, onError: (Object error) {
      ++_revision;
      if (mounted) setState(() { _label = 'Could not read connection type'; });
    });
    unawaited(_readInitial());
  }
  Future<void> _readInitial() async {
    final revision = _revision;
    try {
      final values = await _connectivity.checkConnectivity();
      if (mounted && revision == _revision) _show(values);
    } catch (_) {
      if (mounted && revision == _revision) {
        setState(() { _label = 'Could not read connection type'; });
      }
    }
  }
  @override
  void dispose() { unawaited(_subscription?.cancel()); super.dispose(); }
  @override
  Widget build(BuildContext context) => Scaffold(
    appBar: AppBar(title: const Text('Network type')),
    body: Center(child: Text('Available network types: $_label')),
  );
}

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

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

تطبيق نوع الشبكة في Flutter في مشروعك

وجود Wi-Fi أو شبكة خلوية لا يضمن وصول طلبك إلى الإنترنت. عالِج مهلة الطلب وفشل الخدمة حتى عندما تبدو الشبكة متصلة.

عند مراجعة صفحة connectivity_plus كان الإصدار المنشور 7.3.2. أرقام الإصدارات في المثال الأصلي قد تختلف؛ قارِن دليل الهجرة وإعدادات المنصة قبل التحديث، ولا ترفع قيد الاعتماد وحده مع إبقاء استدعاءات واجهة قديمة.

مراجع الموضوع: pub.dev — connectivity_plus

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

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