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

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

قبل البدء

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

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

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

    flutter pub add firebase_performance

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

    flutterfire configure

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

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

    flutter run

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

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

الخطوة 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.

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