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

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

إذا لم يكن لديك تطبيق Flutter بالفعل ، يمكنك إكمال Get Started: Test Drive لإنشاء تطبيق 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.

الإضافات المتوفرة

منتج اسم البرنامج المساعد iOS ذكري المظهر الويب أبل أخرى
(macOS ، إلخ.)
تحليلات firebase_analytics
بيتا
التحقق من التطبيق firebase_app_check
بيتا
المصادقة firebase_auth
بيتا
سحابة Firestore cloud_firestore
بيتا
وظائف السحابة cloud_functions
بيتا
المراسلة السحابية firebase_messaging
بيتا
سحابة التخزين firebase_storage
بيتا
Crashlytics firebase_crashlytics
بيتا
روابط ديناميكية firebase_dynamic_links
المراسلة داخل التطبيق firebase_in_app_messaging
منشآت Firebase firebase_app_installations
بيتا
ML Model Downloader 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. انقر فوق DebugView . قم بتمكين الميزة لمشاهدة جميع الأحداث التي تم إنشاؤها بواسطة برنامج المثال.

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

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