إضافة 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

إذا كنت تفضّل استخدام مشروع تجريبي، يمكنك بدء محاكي Firebase في ملف lib/main.dart، قم بإعداد Firebase باستخدام demoProjectId (من المفترض أن يبدأ بـ demo-):

  await Firebase.initializeApp(
    demoProjectId: "demo-project-id",
  );

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

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

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

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

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

    flutter pub add PLUGIN_NAME

  2. من دليل مشروع Flutter، شغِّل الأمر التالي:

    flutterfire configure

    يضمن تشغيل هذا الأمر ضبط إعدادات Firebase لتطبيق Flutter محدّث، وسيضيف تحديثًا في نظامَي التشغيل Crashlytics وPerformance Monitoring على نظام التشغيل Android مكونات إضافية من Gradle المطلوبة إلى تطبيقك.

  3. بعد اكتمال عملية الإنشاء، أعِد إنشاء مشروع Flutter:

    flutter run

اكتملت عملية الإعداد. تم تسجيل تطبيقات Flutter وإعدادها لاستخدام Firebase.

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

Product اسم المكوِّن الإضافي iOS Android الويب Apple آخر
(macOS، إلخ.)		 Windows
Analytics firebase_analytics
تجريبي
App Check firebase_app_check
تجريبي
Authentication firebase_auth
تجريبي تجريبي
Cloud Firestore cloud_firestore
تجريبي تجريبي
Cloud Functions cloud_functions
تجريبي
Cloud Messaging firebase_messaging
تجريبي
Cloud Storage firebase_storage
تجريبي تجريبي
Crashlytics firebase_crashlytics
تجريبي
Dynamic Links firebase_dynamic_links
In-App Messaging firebase_in_app_messaging
Firebase عملية تثبيت firebase_app_installations
تجريبي
أداة تنزيل نماذج تعلُّم الآلة firebase_ml_model_downloader
تجريبي
Performance Monitoring firebase_performance
Realtime Database firebase_database
تجريبي
Remote Config firebase_remote_config
تجريبي
Vertex AI in Firebase firebase_vertexai
تجريبي

تجربة نموذج تطبيق مع "Analytics"

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

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

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

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

    • main.dart
    • tabs_page.dart

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

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

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

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

لمزيد من المعلومات حول إعداد Analytics، يمكنك الانتقال إلى صفحة البدء. أدلة +iOS، Android الويب.

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