Firebase Crashlytics — الإبلاغ عن الأخطاء والتشخيص

# pubspec.yaml
dependencies:
  firebase_core: ^3.6.0
  firebase_crashlytics: ^4.1.3

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

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );

  // تمرير جميع أخطاء Flutter غير المعالجة إلى Crashlytics.
  FlutterError.onError =
      FirebaseCrashlytics.instance.recordFlutterFatalError;

  // تمرير جميع الأخطاء غير المتزامنة من المعزل الجذري
  // (مثل الأخطاء المُلقاة داخل runApp أو سلاسل Future).
  PlatformDispatcher.instance.onError = (error, stack) {
    FirebaseCrashlytics.instance.recordError(error, stack, fatal: true);
    return true; // إعادة true يُخمد معالج الأخطاء الافتراضي
  };

  // تشغيل التطبيق.
  runApp(const MyApp());
}

Future<void> loadUserProfile(String uid) async {
  try {
    final doc = await FirebaseFirestore.instance
        .collection('users')
        .doc(uid)
        .get();
    if (!doc.exists) throw Exception('User $uid not found');
    _profile = UserProfile.fromMap(doc.data()!);
  } catch (e, stack) {
    // غير فادح: يمكن للواجهة عرض بديل، لكننا لا نزال نريد تقريراً.
    await FirebaseCrashlytics.instance.recordError(
      e,
      stack,
      reason: 'loadUserProfile failed for uid=$uid',
      fatal: false,
    );
    _profile = UserProfile.empty();
  }
}

// إرفاق بيانات وصفية بمفاتيح وقيم (تُحدَّث مع تغير حالة التطبيق).
await FirebaseCrashlytics.instance.setCustomKey('user_role', 'premium');
await FirebaseCrashlytics.instance.setCustomKey('subscription_tier', 3);
await FirebaseCrashlytics.instance.setCustomKey('locale', 'ar_SA');

// كتابة فتات خبز مؤقتة إلى مخزن السجل.
FirebaseCrashlytics.instance.log('Navigated to checkout screen');
FirebaseCrashlytics.instance.log('Applied coupon: SAVE20');
FirebaseCrashlytics.instance.log('Payment provider: Stripe');

// تعريف المستخدم اختيارياً (استخدم معرفاً مبهماً، لا بيانات شخصية).
await FirebaseCrashlytics.instance.setUserIdentifier('user_8f3a91b');

// أضف زراً مؤقتاً أثناء التطوير فقط.
// احذفه قبل الإصدار للإنتاج.
ElevatedButton(
  onPressed: () => FirebaseCrashlytics.instance.crash(),
  child: const Text('Test Crash'),
),