الفصل الثاني عشر: التكامل مع Firebase Chapter 12: Firebase Integration

فيربيز مش مجرد قاعدة بيانات، هي منظومة كاملة بتساعدنا في MRE CashBook بـ 3 حاجات أساسية:

يوضح الرسم التالي كيف يتفاعل التطبيق مع خدمات Firebase المختلفة:

التكامل ده بيتم في طبقة الـ Core بتاع التطبيق عشان يغطي جميع الـ Features في نفس الوقت.

واحدة من أكبر المشاكل في الأندرويد هي غياب خدمات جوجل (GMS) على بعض الأجهزة. لو حاولنا نشغل Firebase بدون حذر، التطبيق ممكن "يهنج" تماماً.

Future<void> initFirebase() async {
  try {
    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    ).timeout(
      const Duration(seconds: 3),
      onTimeout: () => throw TimeoutException('Firebase unreachable'),
    );
    
    // إعداد الـ Crashlytics في وضع الـ Release فقط
    await FirebaseCrashlytics.instance.setCrashlyticsCollectionEnabled(kReleaseMode);
  } catch (e) {
    AppLogger.error("Firebase init failed, but continuing app launch.");
  }
}

بدل ما نعتمد على كلام المستخدم الشفهي "التطبيق قفل"، Crashlytics بتبعت لنا الـ Stack Trace كامل.

الإشعارات في MRE CashBook بتشتغل على 3 مستويات بناءً على حالة التطبيق:

الإشعار مش مجرد رسالة، هو ممكن يوجه المستخدم لشاشة معينة (مثلاً شاشة إضافة معاملة جديدة).

// Handling notification click
FirebaseMessaging.onMessageOpenedApp.listen((RemoteMessage message) {
  if (message.data['screen'] == 'add_transaction') {
    navigator.pushNamed('/add');
  }
});

ده بيزود الـ Interactive Rate بتاع التطبيق وبيخلي المستخدم يوصل لهدفه أسرع.

كل جهاز له "عنوان بريدي" فريد في فيربيز اسمه Token. إحنا بنحتاج العنوان ده عشان نبعت رسالة للجهاز ده بالذات.

// Get the token for this device
String? token = await FirebaseMessaging.instance.getToken();
print("Device Token: $token");

أجهزة هواوي الحديثة مفهاش خدمات جوجل، وعشان كدة فيربيز مش هيشتغل عليها (Out of the box). كيف يتعامل MRE CashBook؟

زمان كان لازم نحط ملفات JSON و Plist في فولدرات Native. دلوقتي، الـ FlutterFire CLI بيعملنا ملف Dart فيه كل الإعدادات لكل المنصات (Android, iOS, Web).

static const FirebaseOptions android = FirebaseOptions(
  apiKey: 'AIzaSyA...',
  appId: '1:123456789:android:...',
  messagingSenderId: '123456789',
  projectId: 'mre-cashbook',
);

ده بيخلي الـ Source Control (Git) أنظف، وبنقدر نغير الـ Config بسهولة من مكان واحد.

أشهر المشاكل اللي بتقابل المطورين مع فيربيز وحلها:

flutter clean && flutter pub get

سياسة MRE CashBook صارمة جداً فيما يخص البيانات:

أيضاً، إحنا بنشفر الـ User ID المبعوت للـ Crashlytics بـ UUID عشوائي عشان محدش يقدر يربط الخطأ بشخص معين.

الإشعارات في أندرويد 13+ و iOS بتحتاج موافقة صريحة من المستخدم. إحنا بنطلبها بذكاء:

NotificationSettings settings = await FirebaseMessaging.instance.requestPermission(
  alert: true,
  badge: true,
  sound: true,
);

if (settings.authorizationStatus == AuthorizationStatus.authorized) {
  print('User granted permission');
} else {
  print('User declined or has not accepted permission');
}

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

// Example: Log report generation
await FirebaseAnalytics.instance.logEvent(
  name: 'generate_report',
  parameters: {'type': 'monthly'},
);

عشان نضمن أقصى درجة من الأمان، بنتبع القواعد دي:

دمج فيربيز بيحول تطبيقنا من مجرد كود محلي إلى تجربة مستخدم سحابية ناضجة، بتقدر تتعامل مع المشاكل وتتواصل مع المستخدمين باحترافية.