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

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

قبل البدء

في حال لم يسبق لك إجراء ذلك، اضبط Firebase وأعده في مشروع Flutter .

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

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

    flutter pub add firebase_performance

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

    flutterfire configure

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

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

    flutter run

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

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

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

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

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

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

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

    إذا لم يتم عرض بياناتك الأولية، راجع أداة تحري الخلل وإصلاحه النصائح.

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

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

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

    • iOS+: Firebase/Performance
    • نظام التشغيل Android: FirebasePerformance

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

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

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

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

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

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

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

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

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

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

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

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