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

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

  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 getter في 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/');

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