תחילת העבודה עם מסד נתונים בזמן אמת ב-Firebase עבור C++

מסד הנתונים בזמן אמת ב-Firebase מאחסן ומסנכרן נתונים באמצעות מסד נתונים בענן של NoSQL. הנתונים מסונכרנים עם כל הלקוחות בזמן אמת, ונשארים זמינים גם כשהאפליקציה עוברת למצב אופליין.

לפני שתתחיל

לפני שתוכלו להשתמש ב-Firebase Realtime Database, אתם צריכים:

  • רושמים את פרויקט C++‎ ומגדירים אותו לשימוש ב-Firebase.

    אם פרויקט ה-C++‎ שלכם כבר משתמש ב-Firebase, הוא כבר רשום ומוגדר ל-Firebase.

  • מוסיפים את Firebase C++ SDK לפרויקט C++‎.

שימו לב: כדי להוסיף את Firebase לפרויקט ב-C++‎, צריך לבצע משימות גם במסוף Firebase וגם בפרויקט הפתוח ב-C++‎ (לדוגמה, מורידים את קובצי התצורה של Firebase מהמסוף ומעבירים אותם לפרויקט ב-C++‎).

יצירת מסד נתונים

  1. במסוף Firebase, נכנסים אל Databases & Storage > מסד נתונים בזמן אמת.

  2. לוחצים על Create database.

  3. צריך לבחור מצב התחלה ל-Firebase Security Rules:

    מצב בדיקה

    מתאים לתחילת העבודה עם ספריות הלקוח לנייד ולאינטרנט, אבל מאפשר לכל אחד לקרוא את הנתונים שלכם ולשכתב אותם. אחרי הבדיקה, חשוב לעיין בקטע הסבר על כללי מסד הנתונים בזמן אמת ב-Firebase.

    כדי להתחיל להשתמש ב-SDK לאינטרנט, ל-Apple או ל-Android, בוחרים באפשרות testmode.

    מצב נעילה

    דוחה את כל פעולות הקריאה והכתיבה מלקוחות בנייד ובאינטרנט. שרתי האפליקציות המאומתים עדיין יכולים לגשת למסד הנתונים.

  4. בוחרים מיקום למסד הנתונים.

    בהתאם למיקום של מסד הנתונים, כתובת ה-URL של מסד הנתונים החדש תהיה באחת מהצורות הבאות:

    • ‫DATABASE_NAME.firebaseio.com (למסדי נתונים ב-us-central1)

    • DATABASE_NAME.REGION.firebasedatabase.app (למסדי נתונים בכל המיקומים האחרים)

  5. לוחצים על סיום.

כשמפעילים את Realtime Database, ה-API מופעל גם ב-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 הוא נקודת הכניסה ל-SDK של Firebase Realtime Database בשפת C++‎.

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

אם בחרתם להשתמש בגישה ציבורית לכללים, אתם יכולים להמשיך לקטעים שעוסקים בשמירה ובאחזור של נתונים.

הגדרת גישה מוגבלת

אם אתם לא רוצים להשתמש בגישה ציבורית, אתם יכולים להוסיף את Firebase Authentication לאפליקציה כדי לשלוט בגישה למסד הנתונים.

השלבים הבאים

בעיות ידועות

  • בפלטפורמות למחשב (Windows, ‏ Mac, ‏ Linux), ערכת ה-SDK של Firebase C++ משתמשת ב-REST כדי לגשת למסד הנתונים. לכן, אתם צריכים להצהיר על האינדקסים שבהם אתם משתמשים באמצעות Query::OrderByChild()‎ במחשב, אחרת המאזינים ייכשלו.
  • גרסת תהליך העבודה למחשב של Realtime Database לא תומכת במצב אופליין או בנתונים מתמידים.