شارك المقالة
Firebase Crashlytics في Flutter: تسجيل الأخطاء وفحص نسخة Release

Firebase Crashlytics في Flutter: تسجيل الأخطاء وفحص نسخة Release

إعداد Firebase Crashlytics في Flutter لالتقاط أخطاء Flutter والأخطاء غير المعالجة، واختبار تقرير Release وملفات الرموز دون إرسال بيانات حساسة.

إعداد Firebase Crashlytics في Flutter لالتقاط أخطاء Flutter والأخطاء غير المعالجة، واختبار تقرير Release وملفات الرموز دون إرسال بيانات حساسة.

تمييز نوع الخطأ قبل تسجيله

تلتقط FlutterError أخطاء إطار Flutter، بينما يعالج PlatformDispatcher أخطاء Dart غير الملتقطة المناسبة لمساره. لا تعني إضافة callback أن كل مشكلة في التطبيق ستظهر؛ أخطاء شبكة عولجت داخل catch تحتاج قرارًا صريحًا بشأن تسجيلها non-fatal، وأخطاء أصلية تعتمد على إعداد المنصة. لا تحوّل كل فشل تسجيل دخول عادي إلى crash قاتل، حتى تبقى التقارير قابلة للفرز والمتابعة.

تركيب الإضافة والتهيئة

أضف firebase_crashlytics وراجع تهيئة FlutterFire للمنصات المطلوبة ثم هيئ Firebase قبل ربط callbacks. المثال يوضح التوصيل في main ويحتاج firebase_options.dart الناتج من FlutterFire CLI. إذا لديك معالج سابق للأخطاء فادمجه دون تسجيل الحدث مرتين أو إخفاء المعالجة الضرورية. اترك المعالج العلوي قصيرًا، ولا تنفذ داخله طلبات متكررة أو تحديثات واجهة قد ترمي استثناءً جديدًا.

اختبار حقيقي وملفات الرموز

أنشئ عطلًا تجريبيًا في نسخة اختبار ثم أعد فتح التطبيق وانتظر إرسال التقرير وفق دورة الخدمة. لا تترك زر التعطيل في النسخة العامة. راجع إعداد رفع رموز iOS وملفات فك التعتيم الخاصة بإصدارات Android وDart عند استخدام obfuscation؛ وصول تقرير دون رموز صحيحة قد يخفي موضع الخطأ. سجّل رقم الإصدار والبناء المناسبين، وقارن الخطأ بنسخة التطبيق التي أنتجته بدل الاكتفاء باسم الجهاز.

سياق مفيد دون بيانات خاصة

استخدم مفاتيح محدودة مثل اسم الشاشة وحالة العملية، ولا ترسل كلمة مرور أو توكن جلسة أو النص الخاص للمستخدم. قد تحتوي رسالة الاستثناء على URL أو قيمة أدخلها المستخدم، فراجع ما يسجل قبل تفعيله في الإنتاج. إن كانت سياسة منتجك تتطلب موافقة على التشخيص، اضبط جمع التقارير وفقها بدل افتراض أنها متاحة دائمًا. بعد إصلاح الخطأ راقب النسخة الجديدة واختبر المسار نفسه، فإغلاق issue في اللوحة لا يصلح الكود.

المثال التطبيقي وحدوده

أضف الحزم المستوردة بإصدارات متوافقة، وهيئ Firebase قبل استخدام خدماته. المقطع يوضح الجزء المذكور في الشرح؛ إعدادات المنصة والقواعد وواجهة الحالات تظل مسؤولية المشروع المستضيف.

import 'dart:ui';
import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_crashlytics/firebase_crashlytics.dart';
import 'firebase_options.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);
  FlutterError.onError = FirebaseCrashlytics.instance.recordFlutterFatalError;
  PlatformDispatcher.instance.onError = (error, stack) {
    FirebaseCrashlytics.instance.recordError(error, stack, fatal: true);
    return true;
  };
  runApp(const MaterialApp(home: Scaffold(body: Text('Crashlytics ready'))));
}

مراجع التنفيذ

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع