ربط Flutter مع Firebase باستخدام FlutterFire CLI، وتوليد firebase_options.dart وحل أخطاء PATH والمشروع والمنصات دون نسخ إعدادات قديمة.
أداتان وخطوة تهيئة واحدة
ابدأ بتثبيت Firebase CLI وتسجيل الدخول لحساب يملك المشروع، ثم ثبت FlutterFire CLI باستخدام Dart. شغل الأوامر من جذر مشروع Flutter الذي يحتوي pubspec.yaml. Firebase CLI لإدارة المشروع والخدمات، وFlutterFire CLI لربط المنصات وتوليد خيارات التطبيق. لا يكفي تثبيت Node.js وحده ولا إضافة ملف google-services.json من مشروع آخر لإتمام الربط الصحيح.
اختيار المشروع والمنصات
نفذ flutterfire configure مع معرف المشروع المقصود واختر Android وiOS وWeb التي ستدعمها فعلًا. تحقق من applicationId وBundle ID قبل تأكيد الربط حتى لا تنشئ تطبيقات Firebase مكررة بأسماء غير مطابقة. إذا أضفت flavor أو بيئة إنتاج مستقلة، اجعل التهيئة لكل بيئة واضحة ولا تستبدل ملف التطوير في الخفاء. راجع تغييرات Git بعد الأمر لتعرف الملفات التي أضيفت أو عدلت.
تهيئة التطبيق قبل استدعاء الخدمات
أضف firebase_core ثم استورد firebase_options.dart الناتج في نقطة الدخول. استخدم WidgetsFlutterBinding.ensureInitialized قبل await Firebase.initializeApp. خطأ default-app غالبًا يشير إلى ترتيب التهيئة أو خيارات المنصة، بينما permission-denied في Firestore يحدث بعد الاتصال وله علاقة بالقواعد. فرّق بين الخطأين بدل إعادة إنشاء المشروع كله. لا تضع service account خاصًا على الهاتف؛ خيارات Flutter العامة ليست صلاحيات Admin.
تشخيص أخطاء التثبيت والبناء
عند command not found افحص PATH ومجلد Dart global، وعند عدم ظهور المشروع افحص الحساب والصلاحيات. عند فشل Gradle أو CocoaPods اقرأ أول خطأ فعلي في سجل البناء وراجع متطلبات نسخ الإضافات المثبتة. لا تنسخ أرقام Gradle أو minSdk أو تعليمات multidex قديمة لكل مشروع دون سبب. بعد تغيير إعداد أصلي أعد بناء التطبيق، ولا تتوقع أن hot reload يعيد تشغيل تهيئة المنصة.
اختبار الربط قبل توسيع المزايا
شغل كل منصة مختارة على حدة، وتأكد من استخدام مشروع الاختبار المقصود. بعد التهيئة أضف خدمة واحدة في كل خطوة مع قواعد مناسبة، ثم انتقل للمصادقة والتخزين والإشعارات. عند إضافة خدمة أو منصة تتطلب إعدادًا إضافيًا أعد تنفيذ configure وفق دليلها. المقطع أوامر إعداد فقط؛ يجب أيضًا إضافة initializeApp في main كما يوضح درس ربط Android وiOS المرتبط أسفل المقال.
المثال التطبيقي وحدوده
firebase login
firebase projects:list
dart pub global activate flutterfire_cli
flutter pub add firebase_core
flutterfire configure --project=YOUR_PROJECT_ID
# Review generated changes, then rebuild each selected platform.
flutter runالصور والفيديو من الشرح
المواد المرئية الأصلية محفوظة للرجوع إليها. قد تعرض إصدارًا قديمًا؛ عند الاختلاف اتبع النص والأمثلة المصححة أعلاه، خاصة في خدمات الإشعارات والروابط التي تغيرت.






