إضافة 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 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 محدَّثة، ويضيف إلى تطبيقك المكوّنات الإضافية Gradle المطلوبة لنظامَي التشغيل Crashlytics وPerformance Monitoring على Android.

  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
تجريبي
ML Model Downloader 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 الويب.

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