ابدأ مع مراقبة الأداء للرفرفة

يصف هذا البدء السريع كيفية إعداد مراقبة أداء 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.

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

• تعرف على المزيد حول البيانات التي تم جمعها تلقائيًا بواسطة مراقبة الأداء:

  • البيانات المتعلقة بدورة حياة التطبيق ، مثل وقت بدء التطبيق
  • بيانات طلبات شبكة HTTP / S الصادرة عن تطبيقك

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

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

• استخدم السمات لتصفية بيانات الأداء .