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

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

قبل البدء

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

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

  1. من دليل جذر مشروع Flutter، نفِّذ الأمر التالي لتثبيت مكوّن Flutter الإضافي لميزة "مراقبة الأداء":

    flutter pub add firebase_performance

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

    flutterfire configure

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

  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".

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