قياس Firebase Performance في Flutter، وإضافة تتبع مخصص مع إيقافه في finally وتجنب تسجيل الطلب مرتين أو إرسال بيانات حساسة ضمن المقاييس.
تركيب الحزم وربط Dio
أضف firebase_performance وdio والتكامل firebase_performance_dio بإصدارات تتوافق مع مشروعك، ثم أعد FlutterFire configure عند طلب دليل الخدمة وراجع ملفات البناء. هيئ Firebase قبل إنشاء طلبات تعتمد على القياس. أنشئ Dio مشتركًا داخل طبقة الشبكة وأضف interceptor مرة واحدة. إذا أنشأت Dio آخر في مكان مختلف فلن يرث هذه الإضافة تلقائيًا. اختبر أيضًا الطلب الفاشل والمهلة والإلغاء بدل قياس استجابة ناجحة فقط.
ما الذي تقيسه الإضافة فعلًا؟
firebase_performance هي إضافة FlutterFire الرسمية، أما firebase_performance_dio فهي تكامل منفصل ينبغي مراجعة إصداره وناشره وتوافقه مع Dio. لا تفترض أن كل طلبات Dart أو كل منصة ستظهر تلقائيًا بمجرد تهيئة Firebase. اختبر طلبًا معروفًا وتأكد من ظهوره مرة واحدة في لوحة Performance قبل الاعتماد على النتائج. راقب إصدار التطبيق وحالة الشبكة وعدد العينات عند مقارنة تحسن الأداء.
أوقف القياس عند النجاح والخطأ
ابدأ trace حول العملية المطلوبة فقط، واستخدم finally لإيقافه حتى إذا رمى الطلب استثناءً. لا تضمّن وقت انتظار المستخدم داخل قياس يفترض أنه يقيس الشبكة. إذا أضاف interceptor مقياس HTTP فلا تنشئ المقياس نفسه يدويًا حول كل طلب، لأن ذلك يكرر القياس ويصعب تفسير النتائج. فرّق بين trace للعملية التجارية ومقياس نقل البيانات وبين مدة رسم الإطار في Flutter.
الخصوصية وحدود القياس
اجعل أسماء المقاييس ثابتة ومحدودة، وتجنب البريد ورقم الهاتف والتوكن ومعرف الطلب الفريد داخل الاسم أو الخصائص. لا تضع عنوان URL يحمل سرًا في query parameters. تقارير Performance تساعد على تحديد موضع البطء، لكنها لا تسرّع الطلب بذاتها؛ بعد اكتشاف المشكلة راجع حجم الاستجابة والصفحات والتخزين المؤقت. لا تحكم على النتيجة من تشغيل واحد بمحاكي وضع Debug؛ قارن قياسات متشابهة من نسخ مناسبة للاختبار.
قراءة النتائج وتحويلها لإصلاح
استخدم نسبة الحالات البطيئة وتوزيع الزمن لا المتوسط وحده، وقارن مجموعات ذات إصدار وشبكة متشابهين. إذا ظهر بطء في تحميل قائمة Firestore فابدأ بفحص كمية البيانات وعدد الاستعلامات بدل إضافة طبقة قياس جديدة. التقارير قد تتأخر حتى تجمع الخدمة عينات؛ غياب نقطة فور الطلب ليس دليلًا قاطعًا على الفشل. المقطع يجهز Dio ويقدم trace لعملية تختارها، ولا ينفذ طلبًا تلقائيًا عند استيراد الملف.
المثال التطبيقي وحدوده
أضف الحزم المستوردة بإصدارات متوافقة، وهيئ Firebase قبل استخدام خدماته. المقطع يوضح الجزء المذكور في الشرح؛ إعدادات المنصة والقواعد وواجهة الحالات تظل مسؤولية المشروع المستضيف.
import 'package:dio/dio.dart';
import 'package:firebase_performance/firebase_performance.dart';
import 'package:firebase_performance_dio/firebase_performance_dio.dart';
Dio createMeasuredDio() {
final dio = Dio();
dio.interceptors.add(DioFirebasePerformanceInterceptor());
return dio;
}
Future<T> measureOperation<T>(Future<T> Function() operation) async {
final trace = FirebasePerformance.instance.newTrace('catalog_load');
await trace.start();
try {
return await operation();
} finally {
await trace.stop();
}
}






