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

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

قبل البدء

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

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

  1. من الدليل الجذري لمشروع Flutter، نفِّذ الأمر التالي لتثبيت المكوّن الإضافي 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 بالكامل بشكل أصلي، لذا فإنّ حزمة 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.

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