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

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

לפני שתתחיל

כדי להשתמש ב-Firebase Realtime Database, צריך:

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

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

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

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

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

  1. עוברים לקטע Realtime Database במסוף Firebase. תתבקשו לבחור פרויקט קיים ב-Firebase. פועלים לפי תהליך העבודה ליצירת מסד נתונים.

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

    מצב בדיקה

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

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

    מצב נעילה

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

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

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

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

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

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

כשמפעילים את Realtime Database, ה-API מופעל גם במנהל Cloud API.

יצירת אובייקט 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 אין תמיכה במצב אופליין או בשימור.