بدء استخدام قاعدة بيانات الوقت الفعلي

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

  1. ثبِّت firebase_core وأضِف رمز الإعداد إلى تطبيقك إذا لم يسبق لك ذلك.
  2. أضِف تطبيقك إلى مشروعك على Firebase في وحدة تحكّم Firebase.

إنشاء قاعدة بيانات

  1. في وحدة تحكّم Firebase، انتقِل إلى قواعد البيانات ومساحة التخزين > قاعدة بيانات الوقت الفعلي.

  2. انقر على إنشاء قاعدة بيانات.

  3. اختَر وضع البدء لجهاز Firebase Security Rules:

    وضع الاختبار

    هذا الوضع مناسب للبدء في استخدام مكتبات برامج الأجهزة الجوّالة والويب، ولكنّه يسمح لأي مستخدم بقراءة بياناتك واستبدالها. بعد الاختبار، احرص على مراجعة قسم فهم قواعد "قاعدة بيانات Firebase في الوقت الفعلي".

    للبدء، اختَر testmode.

    وضع القفل

    يتم رفض جميع عمليات القراءة والكتابة من برامج الأجهزة الجوّالة والويب. سيظل بإمكان خوادم التطبيقات التي تمت مصادقتها الوصول إلى قاعدة بياناتك.

  4. اختَر منطقة لقاعدة البيانات. استنادًا إلى المنطقة التي تختارها، ستكون مساحة اسم قاعدة البيانات على شكل <databaseName>.firebaseio.com أو <databaseName>.<region>.firebasedatabase.app. لمزيد من المعلومات، يُرجى الاطّلاع على اختيار المواقع الجغرافية لمشروعك.

  5. انقر على تم.

عند تفعيل قاعدة بيانات الوقت الفعلي، يتم أيضًا تفعيل واجهة برمجة التطبيقات في Cloud API Manager.

إضافة "قاعدة بيانات Firebase في الوقت الفعلي" إلى تطبيقك

  1. من جذر مشروع Flutter، نفِّذ الأمر التالي لتثبيت المكوّن الإضافي:

    flutter pub add firebase_database

  2. بعد الانتهاء، أعِد إنشاء تطبيق Flutter:

    flutter run

ضبط قواعد قاعدة البيانات

توفّر قاعدة بيانات الوقت الفعلي لغة قواعد توضيحية تتيح لك تحديد كيفية تنظيم بياناتك وفهرستها، ومتى يمكن قراءة بياناتك والكتابة فيها.

إعداد حزمة "قاعدة بيانات Firebase في الوقت الفعلي"

لبدء استخدام حزمة قاعدة بيانات الوقت الفعلي ضمن مشروعك، عليك استيرادها في أعلى ملفات المشروع:

import 'package:firebase_database/firebase_database.dart';

لاستخدام مثيل قاعدة البيانات التلقائي، يمكنك استدعاء دالة الحصول على القيمة instance في FirebaseDatabase:

FirebaseDatabase database = FirebaseDatabase.instance;

إذا أردت استخدامها مع تطبيق Firebase ثانوي، استخدِم الإجراء الثابت instanceFor:

FirebaseApp secondaryApp = Firebase.app('SecondaryApp');
FirebaseDatabase database = FirebaseDatabase.instanceFor(app: secondaryApp);

إذا أردت استخدام مثيل RTDB مختلف في المشروع نفسه، يمكنك تمرير databaseUrl باستخدام طريقة instanceFor الثابتة:

final firebaseApp = Firebase.app();
final rtdb = FirebaseDatabase.instanceFor(app: firebaseApp, databaseURL: 'https://your-realtime-database-url.firebaseio.com/');

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