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

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

• ثبِّت محرّرًا أو بيئة تطوير متكاملة من اختيارك.

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

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

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

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

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

1. ثبِّت واجهة سطر الأوامر (CLI) في Firebase إذا لم يسبق لك ذلك.

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، ثم تهيئة 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.