بدء استخدام ميزة "مراقبة الأداء" في 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 بالكامل في الأصل، لذا لا تكون حزمة تطوير البرامج (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.

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