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


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

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

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

  1. إذا لم يسبق لك إجراء ذلك، ثبِّت Firebase CLI.

  2. سجِّل الدخول إلى Firebase باستخدام حسابك على Google من خلال تنفيذ الأمر التالي:

    firebase login

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

    dart pub global activate flutterfire_cli

الخطوة 2: ضبط تطبيقاتك لاستخدام Firebase

استخدِم واجهة سطر الأوامر FlutterFire لإعداد تطبيقات 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 الذي تم تصديره من ملف الإعداد:

    WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);
runApp(const MyApp());

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

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

    flutter run

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

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

المنتج اسم المكوّن الإضافي iOS Android الويب أجهزة Apple
الأخرى(macOS وما إلى ذلك)		 نظام التشغيل Windows
Firebase AI Logic 1 firebase_ai
تجريبي
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
تجريبي
Data Connect firebase_data_connect
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
تجريبي

1 كان اسم Firebase AI Logic سابقًا "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 وحدة التحكّم، ثم انقر على إحصاءات Google في شريط التنقّل الأيمن.

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

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

لمزيد من المعلومات حول إعداد Analytics، يُرجى الاطّلاع على أدلة البدء لكل من iOS+ وAndroid والويب.

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