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

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

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

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

  1. إذا لم تكن قد فعلت ذلك بالفعل، تثبيت واجهة سطر الأوامر في Firebase

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

    firebase login

  3. ثبِّت واجهة سطر الأوامر FlutterFire من خلال تنفيذ الأمر التالي من أي الدليل:

    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 وAuthentication و"إحصاءات Google" وما إلى ذلك).

بما أنّ 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.

المكونات الإضافية المتاحة

Product اسم المكوِّن الإضافي iOS Android الويب Apple آخر
(macOS، إلخ.)		 Windows
إحصاءات Google firebase_analytics
تجريبي
فحص التطبيقات firebase_app_check
تجريبي
المصادقة firebase_auth
تجريبي تجريبي
Cloud Firestore cloud_firestore
تجريبي تجريبي
الوظائف السحابية cloud_functions
تجريبي
المراسلة عبر السحابة الإلكترونية firebase_messaging
تجريبي
التخزين في السحابة الإلكترونية firebase_storage
تجريبي تجريبي
Crashlytics firebase_crashlytics
تجريبي
الروابط الديناميكية firebase_dynamic_links
المراسلة داخل التطبيق firebase_in_app_messaging
عمليات تثبيت Firebase firebase_app_installations
تجريبي
أداة تنزيل نماذج تعلُّم الآلة firebase_ml_model_downloader
تجريبي
مراقبة الأداء firebase_performance
قاعدة بيانات الوقت الفعلي firebase_database
تجريبي
الإعداد عن بُعد firebase_remote_config
تجريبي
Vertex AI لبرنامج Firebase firebase_vertexai
تجريبي

تجربة نموذج تطبيق مع "إحصاءات Google"

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

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

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

  3. من "إحصاءات Google" مثال لمستودع البرامج انسخ الملفين التاليَين والصقهما في دليل lib على تطبيقك:

    • main.dart
    • tabs_page.dart

  4. شغِّل تطبيق Flutter.

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

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

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

لمزيد من المعلومات عن إعداد "إحصاءات Google"، انتقِل إلى قسم "البدء" أدلة +iOS، Android الويب

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