أضف Firebase إلى تطبيق Flutter
المتطلبات الأساسية
قم بتثبيت المحرر أو IDE المفضل لديك.
قم بتثبيت Flutter لنظام التشغيل المحدد لديك، بما في ذلك ما يلي:
- رفرفة SDK
- دعم المكتبات
- البرامج الخاصة بالمنصة ومجموعات SDK
قم بتسجيل الدخول إلى Firebase باستخدام حساب Google الخاص بك.
إذا لم يكن لديك تطبيق Flutter بالفعل، فيمكنك إكمال البدء: اختبار القيادة لإنشاء تطبيق 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 وWeb) المدعومة في تطبيق 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.
الإضافات المتاحة
منتج | اسم البرنامج المساعد | دائرة الرقابة الداخلية | ذكري المظهر | ويب | أبل أخرى (ماك، الخ.) |
---|---|---|---|---|---|
التحليلات | 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
مع مثال للبرنامج .
افتح تطبيق Flutter الذي قمت بتكوينه بالفعل لاستخدام Firebase (راجع الإرشادات الموجودة في هذه الصفحة).
قم بالوصول إلى دليل
lib
الخاص بالتطبيق، ثم احذف ملفmain.dart
الموجود.من مستودع برنامج Google Analytics النموذجي ، انسخ والصق الملفين التاليين في دليل
lib
الخاص بتطبيقك:-
main.dart
-
tabs_page.dart
-
قم بتشغيل تطبيق Flutter الخاص بك.
انتقل إلى مشروع Firebase الخاص بتطبيقك في وحدة تحكم Firebase ، ثم انقر على Analytics في شريط التنقل الأيمن.
انقر فوق لوحة المعلومات . إذا كان Analytics يعمل بشكل صحيح، فستعرض لوحة التحكم مستخدمًا نشطًا في لوحة "المستخدمون النشطون في آخر 30 دقيقة" (قد يستغرق هذا بعض الوقت لملء هذه اللوحة).
انقر فوق عرض التصحيح . تمكين الميزة لرؤية جميع الأحداث التي تم إنشاؤها بواسطة البرنامج النموذجي.
لمزيد من المعلومات حول إعداد Analytics، تفضل بزيارة أدلة البدء لأنظمة التشغيل iOS+ و Android والويب .
الخطوات التالية
احصل على خبرة عملية مع Firebase Flutter Codelab .
الاستعداد لإطلاق تطبيقك:
- قم بإعداد تنبيهات الميزانية لمشروعك في Google Cloud Console.
- راقب لوحة تحكم الاستخدام والفوترة في وحدة تحكم Firebase للحصول على صورة شاملة لاستخدام مشروعك عبر خدمات Firebase المتعددة.
- قم بمراجعة القائمة المرجعية لإطلاق Firebase .