أضف Firebase إلى تطبيق Flutter
المتطلبات الأساسية
قم بتثبيت المحرر المفضل لديك أو IDE .
قم بتثبيت Flutter لنظام التشغيل الخاص بك ، بما في ذلك ما يلي:
- رفرفة SDK
- دعم المكتبات
- البرامج الخاصة بالمنصة ومجموعات SDK
سجّل الدخول إلى Firebase باستخدام حساب Google الخاص بك.
إذا لم يكن لديك تطبيق Flutter بالفعل ، يمكنك إكمال Get Started: Test Drive لإنشاء تطبيق Flutter جديد باستخدام المحرر المفضل لديك أو IDE.
الخطوة 1 : قم بتثبيت أدوات سطر الأوامر المطلوبة
ثبّت Firebase CLI إذا لم تكن قد قمت بذلك بالفعل.
سجّل الدخول إلى Firebase باستخدام حساب Google الخاص بك عن طريق تشغيل الأمر التالي:
firebase login
قم بتثبيت FlutterFire CLI عن طريق تشغيل الأمر التالي من أي دليل:
dart pub global activate flutterfire_cli
الخطوة 2 : هيئ تطبيقاتك لاستخدام Firebase
استخدم FlutterFire CLI لتكوين تطبيقات Flutter للاتصال بـ Firebase.
من دليل مشروع Flutter ، قم بتشغيل الأمر التالي لبدء سير عمل تكوين التطبيق:
flutterfire configure
يقوم سير عمل
flutterfire configure
بما يلي:
يطلب منك تحديد الأنظمة الأساسية (iOS ، Android ، الويب) المدعومة في تطبيق Flutter الخاص بك. لكل نظام أساسي محدد ، يقوم FlutterFire CLI بإنشاء تطبيق Firebase جديد في مشروع Firebase الخاص بك.
يمكنك تحديد إما استخدام مشروع Firebase حالي أو لإنشاء مشروع Firebase جديد. إذا كان لديك بالفعل تطبيقات مسجلة في مشروع Firebase حالي ، فسيحاول FlutterFire CLI مطابقتها بناءً على تكوين مشروع Flutter الحالي.
ينشئ ملف تكوين Firebase (
firebase_options.dart
) ويضيفه إلى دليلlib/
.(لـ Crashlytics أو مراقبة الأداء على Android) يضيف المكونات الإضافية الخاصة بالمنتج Gradle إلى تطبيق Flutter الخاص بك.
الخطوة 3 : تهيئة Firebase في تطبيقك
من دليل مشروع Flutter ، قم بتشغيل الأمر التالي لتثبيت المكون الإضافي الأساسي:
flutter pub add firebase_core
من دليل مشروع Flutter ، قم بتشغيل الأمر التالي للتأكد من تحديث تكوين Firebase لتطبيق Flutter:
flutterfire configure
في ملف
lib/main.dart
، قم باستيراد المكون الإضافي Firebase الأساسي وملف التكوين الذي أنشأته سابقًا:import 'package:firebase_core/firebase_core.dart'; import 'firebase_options.dart';
أيضًا في ملف
lib/main.dart
، قم بتهيئة Firebase باستخدام كائنDefaultFirebaseOptions
الذي تم تصديره بواسطة ملف التكوين:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );
أعد بناء تطبيق Flutter الخاص بك:
flutter run
الخطوة 4 : أضف مكونات Firebase الإضافية
يمكنك الوصول إلى Firebase في تطبيق Flutter من خلال المكونات الإضافية المختلفة لـ Firebase Flutter ، واحد لكل منتج من منتجات Firebase (على سبيل المثال: Cloud Firestore ، المصادقة ، التحليلات ، إلخ).
نظرًا لأن Flutter عبارة عن إطار عمل متعدد الأنظمة الأساسية ، فإن كل مكون إضافي لـ Firebase قابل للتطبيق على أنظمة تشغيل Apple و Android والويب. لذلك ، إذا قمت بإضافة أي مكون إضافي لـ Firebase إلى تطبيق Flutter ، فسيتم استخدامه بواسطة إصدارات Apple و Android والويب لتطبيقك.
إليك كيفية إضافة مكون Firebase Flutter الإضافي:
من دليل مشروع Flutter ، قم بتشغيل الأمر التالي:
flutter pub add PLUGIN_NAME
من دليل مشروع Flutter ، قم بتشغيل الأمر التالي:
flutterfire configure
يضمن تشغيل هذا الأمر أن تكون تهيئة Firebase الخاصة بتطبيق Flutter محدثة ، وبالنسبة إلى Crashlytics ومراقبة الأداء على Android ، فإنها تضيف الإضافات المطلوبة لتطبيق Gradle.
بمجرد الانتهاء ، أعد بناء مشروع 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
مع مثال على البرنامج .
افتح تطبيق Flutter الذي قمت بتكوينه بالفعل لاستخدام Firebase (راجع الإرشادات الواردة في هذه الصفحة).
قم بالوصول إلى دليل
lib
الخاص بالتطبيق ، ثم احذف ملفmain.dart
الحالي.من مستودع برنامج Google Analytics ، انسخ الملفين التاليين والصقهما في دليل
lib
لتطبيقك:-
main.dart
-
tabs_page.dart
-
قم بتشغيل تطبيق Flutter.
انتقل إلى مشروع Firebase لتطبيقك في وحدة تحكم Firebase ، ثم انقر على Analytics في التنقل الأيمن.
انقر فوق لوحة المعلومات . إذا كان برنامج Analytics يعمل بشكل صحيح ، فإن لوحة التحكم تعرض مستخدمًا نشطًا في لوحة "المستخدمون النشطون في آخر 30 دقيقة" (قد يستغرق هذا وقتًا لتعبئة هذه اللوحة).
انقر فوق DebugView . قم بتمكين الميزة لمشاهدة جميع الأحداث التي تم إنشاؤها بواسطة برنامج المثال.
لمزيد من المعلومات حول إعداد Analytics ، تفضل بزيارة أدلة البدء لنظام التشغيل iOS + و Android والويب .
الخطوات التالية
احصل على خبرة عملية مع Firebase Flutter Codelab .
استعد لإطلاق تطبيقك:
- قم بإعداد تنبيهات الميزانية لمشروعك في Google Cloud Console.
- راقب لوحة معلومات الاستخدام والفوترة في وحدة تحكم Firebase للحصول على صورة شاملة لاستخدام مشروعك عبر خدمات Firebase المتعددة.
- راجع قائمة التحقق الخاصة بإطلاق Firebase .