ابدأ مع مراقبة الأداء لـ Flutter

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

قبل ان تبدأ

إذا لم تكن قد قمت بذلك بالفعل، فقم بتكوين Firebase وتهيئته في مشروع Flutter الخاص بك.

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

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

    flutter pub add firebase_performance
    
  2. من الدليل الجذر لمشروع Flutter، قم بتشغيل الأمر التالي:

    flutterfire configure
    

    يضمن تشغيل هذا الأمر أن يكون تكوين Firebase الخاص بتطبيق Flutter محدثًا، وبالنسبة لنظام التشغيل Android، فإنه يضيف المكون الإضافي Performance Monitoring 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
    • أندرويد: FirebasePerformance
  2. تحقق من أنواع السجلات التالية التي تشير إلى أن مراقبة الأداء تقوم بتسجيل أحداث الأداء:

    • Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL
  3. انقر على عنوان URL لعرض بياناتك في وحدة تحكم Firebase. قد يستغرق الأمر بضع دقائق حتى يتم تحديث البيانات في لوحة المعلومات.

الخطوة 4 : (اختياري) أضف مراقبة مخصصة لرمز محدد

لمراقبة بيانات الأداء المرتبطة بتعليمات برمجية محددة في تطبيقك، يمكنك استخدام أدوات تتبع التعليمات البرمجية المخصصة .

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

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

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

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

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

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

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