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

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

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

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

  1. انتقِل إلى قسم قاعدة بيانات الوقت الفعلي في وحدة تحكُّم Firebase. سيُطلب منك اختيار مشروع حالي على Firebase. اتّبِع سير عمل إنشاء قاعدة البيانات.

  2. اختَر وضعًا لبدء قواعد الأمان:

    وضع الاختبار

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

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

    الوضع المحظور

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

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

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

عند تفعيل "قاعدة بيانات الوقت الفعلي"، يتم أيضًا تفعيل واجهة برمجة التطبيقات في الـ 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);

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

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

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