إضافة Firebase إلى تطبيقك المكتوب باستخدام Flutter


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

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

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

  1. ثبِّت Firebase CLI إذا لم يسبق لك تثبيته.

  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 الذي تم تصديره من ملف الإعدادات:

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

  5. إعادة إنشاء تطبيق Flutter:

    flutter run

إذا كنت تفضِّل استخدام مشروع تجريبي، يمكنك بدء محاكي Firebase وإعداد Firebase في ملف lib/main.dart باستخدام 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 aggiornata، ويضيف إلى تطبيقك المكوّنات الإضافية 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
تجريبي
Data Connect firebase_data_connect
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، ثم انقر على إحصاءات Google في شريط التنقّل الأيمن.

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

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

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

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