بدء استخدام Firebase في مشروع Flutter

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

• ثبِّت أداة التعديل أو حزمة تطوير البرامج المتكاملة (IDE) المفضّلة لديك.

• ثبِّت Flutter لنظام التشغيل الخاص بك، بما في ذلك ما يلي:

  • حزمة تطوير البرامج (SDK) من Flutter
  • المكتبات المتوافقة
  • البرامج وحِزم تطوير البرامج (SDK) الخاصة بمنصات معيّنة

المتطلبات الأساسية الخاصة بالمنصة:

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

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

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

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

   firebase login
   

3. ثبِّت FlutterFire CLI من خلال تنفيذ الأمر التالي من أي دليل:

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

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

   flutter run
   

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

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

^{1 كان اسم Firebase AI Logic سابقًا "Vertex AI in Firebase" مع المكوّن الإضافي firebase_vertexai.}

^{2 كان اسم Firebase SQL Connect في السابق "Firebase Data Connect".}

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

• يمكنك اكتساب خبرة عملية من خلال الدرس التطبيقي حول الترميز الخاص بمنصة Firebase عند تطوير التطبيقات باستخدام Flutter.

• استعِدّ لإطلاق تطبيقك باتّباع الخطوات التالية:

  • إعداد تنبيهات الميزانية لمشروعك في وحدة تحكّم Google Cloud
  • يمكنك مراقبة لوحة بيانات الاستخدام والفوترة في وحدة تحكّم Firebase للحصول على صورة شاملة عن استخدام مشروعك في عدة خدمات من Firebase.
  • راجِع قائمة التحقّق من إطلاق Firebase.