أضف Firebase إلى تطبيق Flutter

المتطلبات الأساسية

إذا لم يكن لديك تطبيق Flutter بالفعل، فيمكنك إكمال البدء: اختبار القيادة لإنشاء تطبيق Flutter جديد باستخدام المحرر المفضل لديك أو IDE.

الخطوة 1 : تثبيت أدوات سطر الأوامر المطلوبة

  1. إذا لم تكن قد قمت بذلك بالفعل، فقم بتثبيت Firebase CLI .

  2. قم بتسجيل الدخول إلى Firebase باستخدام حساب Google الخاص بك عن طريق تشغيل الأمر التالي:

    firebase login
    
  3. قم بتثبيت FlutterFire CLI عن طريق تشغيل الأمر التالي من أي دليل:

    dart pub global activate flutterfire_cli
    

الخطوة 2 : قم بتكوين تطبيقاتك لاستخدام Firebase

استخدم FlutterFire CLI لتكوين تطبيقات Flutter للاتصال بـ Firebase.

من دليل مشروع Flutter، قم بتشغيل الأمر التالي لبدء سير عمل تكوين التطبيق:

flutterfire configure


الخطوة 3 : تهيئة Firebase في تطبيقك

  1. من دليل مشروع Flutter، قم بتشغيل الأمر التالي لتثبيت المكون الإضافي الأساسي:

    flutter pub add firebase_core
    
  2. من دليل مشروع Flutter، قم بتشغيل الأمر التالي للتأكد من تحديث تكوين Firebase لتطبيق Flutter:

    flutterfire configure
    
  3. في ملف lib/main.dart الخاص بك، قم باستيراد المكون الإضافي الأساسي لـ Firebase وملف التكوين الذي قمت بإنشائه مسبقًا:

    import 'package:firebase_core/firebase_core.dart';
    import 'firebase_options.dart';
    
  4. أيضًا في ملف lib/main.dart ، قم بتهيئة Firebase باستخدام كائن DefaultFirebaseOptions الذي تم تصديره بواسطة ملف التكوين:

    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    
  5. إعادة إنشاء تطبيق Flutter الخاص بك:

    flutter run
    

الخطوة 4 : إضافة مكونات Firebase الإضافية

يمكنك الوصول إلى Firebase في تطبيق Flutter الخاص بك من خلال مكونات Firebase Flutter الإضافية المتنوعة، واحدة لكل منتج من منتجات Firebase (على سبيل المثال: Cloud Firestore، والمصادقة، والتحليلات، وما إلى ذلك).

نظرًا لأن Flutter عبارة عن إطار عمل متعدد المنصات، فإن كل مكون إضافي لـ Firebase قابل للتطبيق على منصات Apple وAndroid والويب. لذلك، إذا قمت بإضافة أي مكون إضافي لـ Firebase إلى تطبيق Flutter، فسيتم استخدامه بواسطة إصدارات Apple وAndroid وإصدارات الويب من تطبيقك.

إليك كيفية إضافة مكون إضافي لـ Firebase Flutter:

  1. من دليل مشروع Flutter، قم بتشغيل الأمر التالي:

    flutter pub add PLUGIN_NAME
  2. من دليل مشروع Flutter، قم بتشغيل الأمر التالي:

    flutterfire configure
    

    يضمن تشغيل هذا الأمر أن يكون تكوين Firebase الخاص بتطبيق Flutter محدثًا، وبالنسبة لـ Crashlytics ومراقبة الأداء على Android، فإنه يضيف مكونات Gradle الإضافية المطلوبة إلى تطبيقك.

  3. بمجرد الانتهاء، أعد بناء مشروع Flutter الخاص بك:

    flutter run
    

أنت جاهز تمامًا! تم تسجيل تطبيقات Flutter وتكوينها لاستخدام Firebase.

الإضافات المتاحة

منتج اسم البرنامج المساعد دائرة الرقابة الداخلية ذكري المظهر ويب أبل أخرى
(ماك، الخ.)
التحليلات firebase_analytics
بيتا
فحص التطبيق firebase_app_check
بيتا
المصادقة firebase_auth
بيتا
سحابة فايرستور cloud_firestore
بيتا
وظائف السحابة cloud_functions
بيتا
المراسلة السحابية firebase_messaging
بيتا
سحابة التخزين firebase_storage
بيتا
Crashlytics firebase_crashlytics
بيتا
الروابط الديناميكية firebase_dynamic_links
المراسلة داخل التطبيق firebase_in_app_messaging
منشآت Firebase firebase_app_installations
بيتا
تنزيل نموذج ML firebase_ml_model_downloader
بيتا
مراقبة الاداء firebase_performance
قاعدة بيانات الوقت الحقيقي firebase_database
بيتا
التكوين عن بعد firebase_remote_config
بيتا

جرّب تطبيقًا نموذجيًا باستخدام Analytics

مثل جميع الحزم، يأتي المكون الإضافي firebase_analytics مع مثال للبرنامج .

  1. افتح تطبيق Flutter الذي قمت بتكوينه بالفعل لاستخدام Firebase (راجع الإرشادات الموجودة في هذه الصفحة).

  2. قم بالوصول إلى دليل lib الخاص بالتطبيق، ثم احذف ملف main.dart الموجود.

  3. من مستودع برنامج Google Analytics النموذجي ، انسخ والصق الملفين التاليين في دليل lib الخاص بتطبيقك:

    • main.dart
    • tabs_page.dart
  4. قم بتشغيل تطبيق Flutter الخاص بك.

  5. انتقل إلى مشروع Firebase الخاص بتطبيقك في وحدة تحكم Firebase ، ثم انقر على Analytics في شريط التنقل الأيمن.

    1. انقر فوق لوحة المعلومات . إذا كان Analytics يعمل بشكل صحيح، فستعرض لوحة المعلومات مستخدمًا نشطًا في لوحة "المستخدمون النشطون في آخر 30 دقيقة" (قد يستغرق هذا بعض الوقت لملء هذه اللوحة).

    2. انقر فوق عرض التصحيح . تمكين الميزة لرؤية جميع الأحداث التي تم إنشاؤها بواسطة البرنامج النموذجي.

لمزيد من المعلومات حول إعداد Analytics، تفضل بزيارة أدلة البدء لأنظمة التشغيل iOS+ و Android والويب .

الخطوات التالية