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

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

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

الخطوة 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، والمصادقة، و"إحصاءات Google"، وغير ذلك).

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

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

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

    flutter pub add PLUGIN_NAME

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

    flutterfire configure

    يضمن تنفيذ هذا الأمر أن تكون إعدادات Firebase في تطبيق Flutter محدَّثة

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

    flutter run

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

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

Product اسم المكوِّن الإضافي iOS Android الويب نظام تشغيل Apple آخر
(نظام التشغيل macOS وما إلى ذلك)		 شبابيك
إحصاءات 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 for Firebase firebase_vertexai
تجريبي

تجربة مثال على تطبيق باستخدام "إحصاءات Google"

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

  1. افتح تطبيق Flutter الذي سبق لك إعداده لاستخدام Firebase (اطّلِع على التعليمات الواردة في هذه الصفحة).

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

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

    • main.dart
    • tabs_page.dart

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

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

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

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

لمزيد من المعلومات حول إعداد "إحصاءات Google"، يُرجى زيارة أدلة البدء الخاصة بتطبيقات iOS+ وAndroid والويب.

الخطوات اللاحقة