بدء استخدام ميزة "مراقبة الأداء" في Flutter

يوضّح هذا الدليل السريع كيفية إعداد خدمة "مراقبة الأداء في Firebase" لمساعدتك في التعرّف على خصائص أداء تطبيقات Flutter.

قبل البدء

إذا لم يسبق لك إجراء ذلك، عليك إعداد Firebase وتهيئة في مشروع Flutter.

الخطوة 1: إضافة خدمة "مراقبة الأداء" إلى تطبيقك

  1. من دليل الجذر لمشروع Flutter، نفِّذ الأمر التالي لتثبيت المكوّن الإضافي Performance Monitoring Flutter:

    flutter pub add firebase_performance

  2. من دليل الجذر لمشروع Flutter، نفِّذ الأمر التالي:

    flutterfire configure

    يضمن تنفيذ هذا الأمر أنّ إعدادات Firebase في تطبيق Flutter محدّثة، كما يضيف لنظام التشغيل Android المكوّن الإضافي Gradle المطلوب في Performance Monitoring إلى تطبيقك.

  3. بعد اكتمال العملية، أعِد إنشاء مشروع Flutter باتّباع الخطوات التالية:

    flutter run

بعد إضافة حزمة تطوير البرامج (SDK) الخاصة بخدمة Performance Monitoring، يبدأ Firebase تلقائيًا في جمع البيانات المتعلّقة بدورة حياة تطبيقك (مثل وقت بدء تشغيل التطبيق) وبيانات طلبات شبكة HTTP/S.

في Flutter، لا يمكن مراقبة أداء عرض الشاشة التلقائي لشاشات Flutter الفردية. يغلّف عنصر التحكّم في العرض الفردي تطبيق Flutter بأكمله بشكل أصلي، وبالتالي لا تكون حزمة تطوير البرامج (SDK) الأصلية الأساسية لمنصة Firebase على دراية بعمليات الانتقال بين الشاشات.

الخطوة 2: إنشاء أحداث الأداء لعرض البيانات الأوّلية

يبدأ Firebase في معالجة الأحداث عند إضافة حزمة تطوير البرامج (SDK) إلى تطبيقك بنجاح. إذا كنت لا تزال في مرحلة التطوير على جهازك، تفاعَل مع تطبيقك لإنشاء أحداث من أجل جمع البيانات ومعالجتها في البداية.

  1. واصِل تطوير تطبيقك باستخدام محاكي أو جهاز اختباري.

  2. يمكنك إنشاء أحداث من خلال التبديل بين تشغيل تطبيقك في الخلفية وفي المقدّمة عدة مرات، والتفاعل مع تطبيقك من خلال التنقّل بين الشاشات، و/أو تشغيل طلبات الشبكة.

  3. انتقِل إلى لوحة بيانات الأداء في وحدة تحكّم Firebase. من المفترض أن تظهر البيانات الأولية في غضون بضع دقائق.

    إذا لم تظهر لك بياناتك الأولية، راجِع نصائح تحديد المشاكل وحلّها.

الخطوة 3: (اختياري) عرض رسائل السجلّ لأحداث الأداء

  1. راجِع رسائل السجلّ بحثًا عن أي رسائل خطأ.

    تضع ميزة "مراقبة الأداء" العلامات التالية على رسائل السجلّ لتتمكّن من فلترة رسائل السجلّ:

    • نظام التشغيل iOS والإصدارات الأحدث: Firebase/Performance
    • ‫Android: FirebasePerformance

  2. ابحث عن أنواع السجلّات التالية التي تشير إلى أنّ خدمة Performance Monitoring تسجّل أحداث الأداء:

    • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL

  3. انقر على عنوان URL لعرض بياناتك في وحدة تحكّم Firebase. قد يستغرق تعديل البيانات في لوحة البيانات بضع لحظات.

الخطوة 4: (اختياري) إضافة مراقبة مخصّصة لرمز معيّن

لمراقبة بيانات الأداء المرتبطة برمز معيّن في تطبيقك، يمكنك تسجيل عمليات تتبُّع الرموز المخصّصة.

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

في الرمز البرمجي، يمكنك تحديد بداية ونهاية عملية تتبُّع رمز مخصّص (وإضافة أي مقاييس مخصّصة مرغوبة) باستخدام واجهة برمجة التطبيقات التي توفّرها حزمة تطوير البرامج (SDK) الخاصة بخدمة Performance Monitoring.

انتقِل إلى إضافة مراقبة لرمز معيّن للاطّلاع على مزيد من المعلومات حول هذه الميزات وكيفية إضافتها إلى تطبيقك.

الخطوة 5: نشر تطبيقك ثم مراجعة النتائج

بعد التحقّق من صحة أداة "مراقبة الأداء" باستخدام محاكي وجهاز اختبار واحد أو أكثر، يمكنك نشر الإصدار المعدَّل من تطبيقك للمستخدمين.

يمكنك مراقبة بيانات الأداء في لوحة بيانات الأداء في وحدة تحكّم Firebase.

الخطوات التالية