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

تخزِّن قاعدة بيانات Firebase في الوقت الفعلي البيانات وتُزامنها باستخدام قاعدة بيانات سحابة تشكلت باستخدام لغة الاستعلامات البنيوية (NoSQL). تتم مزامنة البيانات على جميع العملاء في الوقت الفعلي، وتظل متاحة عند إيقاف اتصال تطبيقك بالإنترنت.

قبل البدء

لاستخدام Firebase Realtime Database، عليك إجراء ما يلي:

  • سجّل مشروع C++ الخاص بك واضبطه لاستخدام Firebase.

    إذا كان مشروعك على C++ يستخدم Firebase بالفعل، فإنه قد تم تسجيله وإعداده لـ Firebase.

  • أضِف حزمة تطوير البرامج (SDK) Firebase C++ إلى مشروعك على C++.

تجدر الإشارة إلى أنّ إضافة Firebase إلى مشروع C++ تتضمّن مهامًا في وحدة تحكُّم Firebase وفي مشروع C++ المفتوح (على سبيل المثال، يمكنك تنزيل ملفات إعداد Firebase من وحدة التحكّم، ثم نقلها إلى مشروع C++ ).

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

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

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

    وضع الاختبار

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

    لبدء استخدام حزمة تطوير البرامج (SDK) للويب أو Apple أو Android، اختَر وضع الاختبار.

    وضع القفل

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

  3. اختَر موقعًا لقاعدة البيانات.

    بناءً على موقع قاعدة البيانات، سيكون عنوان URL لقاعدة البيانات الجديدة بأحد الأشكال التالية:

    • DATABASE_NAME.firebaseio.com (لقاعدة بيانات في us-central1)

    • DATABASE_NAME.REGION.firebasedatabase.app (للقواعد البيانات في جميع المواقع الجغرافية الأخرى)

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

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

إنشاء عنصر firebase::App وإعداده

قبل أن تتمكّن من الوصول إلى Realtime Database، ع��يك ��نشاء ملف firebase::App وإعداده.

أدرِج ملف الرأس الخاص بـ firebase::App:

#include "firebase/app.h"

Android

أنشئ firebase::App، مع تمرير بيئة JNI وjobject إشارة إلى نشاط Java كوسيطات:

app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"), jni_env, activity);

iOS+

إنشاء firebase::App:

app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"));

الوصول إلى فئة firebase::database::Database

firebase::database::Database هي نقطة دخول حزمة C++ SDK لتطبيق Firebase Realtime Database.

::firebase::database::Database *database = ::firebase::database::Database::GetInstance(app);

إذا اخترت استخدام إذن الوصول العلني لقواعدك، يمكنك الانتقال إلى الأقسام حول حفظ البيانات واستردادها.

إعداد ميزة "الوصول المحدود"

إذا كنت لا تريد استخدام إذن الوصول العلني، يمكنك إضافة Firebase Authentication إلى تطبيقك للتحكّم في إمكانية الوصول إلى قاعدة البيانات.

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

المشاكل المعروفة

  • على منصات أجهزة الكمبيوتر المكتبي (Windows وMac وLinux)، تستخدم حزمة تطوير البرامج Firebase C++ بروتوكول REST للوصول إلى قاعدة بياناتك. ولهذا السبب، عليك تعريف الفهارس التي تستخدمها باستخدام Query::OrderByChild() على الكمبيوتر المكتبي وإلا لن تعمل أدوات الاستماع.
  • لا يتيح إصدار سير عمل سطح المكتب من Realtime Database بلا اتصال بالإنترنت أو الاستمرار في العمل.