شروع به کار با «پایگاه داده بی‌درنگ Firebase» برای C++‎

«پایگاه داده بی‌درنگ Firebase» داده‌ها را بااستفاده از پایگاه داده ابری NoSQL ذخیره و همگام‌سازی می‌کند. داده‌ها در همه کارخواه‌ها به‌صورت هم‌زمان همگام‌سازی می‌شود و وقتی برنامه‌تان آفلاین می‌شود همچنان دردسترس می‌ماند.

قبل‌از شروع

پیش‌از اینکه بتوانید از Firebase Realtime Database استفاده کنید، باید:

  • پروژه C++ خود را ثبت کنید و آن را برای استفاده از Firebase پیکربندی کنید.

    اگر پروژه C++ شما ازقبل از Firebase استفاده می‌کند، پس ازقبل برای Firebase ثبت و پیکربندی شده است.

  • کیت توسعه نرم‌افزار Firebase C++ را به پروژه C++ خود اضافه کنید.

توجه داشته باشید که افزودن Firebase به پروژه C++ شما شامل وظایفی هم در Firebase کنسول و هم در پروژه C++ باز شما می‌شود (برای مثال، فایل‌های پیکربندی Firebase را از کنسول بارگیری می‌کنید، سپس آن‌ها را به پروژه C++ خود منتقل می‌کنید).

ایجاد پایگاه داده

  1. در کنسول Firebase، به پایگاه‌های داده و فضای ذخیره‌سازی > پایگاه داده هم‌زمان پیمایش کنید.

  2. روی ایجاد پایگاه داده کلیک کنید.

  3. حالت شروعی برای Firebase Security Rules انتخاب کنید:

    حالت آزمایش

    برای شروع کار با کتابخانه‌های کارخواه وب و تلفن همراه خوب است، اما به همه اجازه می‌دهد داده‌هایتان را بخوانند و رونویسی کنند. پس‌از آزمایش، حتماً بخش آشنایی با قوانین پایگاه داده بی‌درنگ Firebase را مرور کنید.

    برای شروع کار با کیت توسعه نرم‌افزار وب، Apple، یا Android، حالت آزمایش را انتخاب کنید.

    حالت قفل‌شده

    همه خواندن‌ها و نوشتن‌ها از کلاینت‌های تلفن همراه و وب را رد می‌کند. سرورهای برنامه اصالت‌سنجی‌شده شما همچنان می‌توانند به پایگاه داده شما دسترسی داشته باشند.

  4. مکانی را برای پایگاه داده انتخاب کنید.

    بسته به مکان پایگاه داده، نشانی وب پایگاه داده جدید به یکی از شکل‌های زیر خواهد بود:

    • DATABASE_NAME.firebaseio.com (برای پایگاه‌های داده در us-central1)

    • DATABASE_NAME.REGION.firebasedatabase.app (برای پایگاه‌های داده در همه مکان‌های دیگر)

  5. روی تمام کلیک کنید.

وقتی Realtime Database را فعال می‌کنید، میانای برنامه‌سازی کاربردی در مدیر میانای برنامه‌سازی کاربردی Cloud نیز فعال می‌شود.

ایجاد و مقداردهی اولیه firebase::App

قبل‌از اینکه بتوانید به Realtime Database دسترسی داشته باشید، باید firebase::App را ایجاد و مقداردهی اولیه کنید.

فایل سرایند را برای firebase::App اضافه کنید:

#include "firebase/app.h"

Android

‫firebase::App را ایجاد کنید و محیط JNI و مرجع jobject «فعالیت جاوا» را به‌عنوان آرگومان ارسال کنید:

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 Class

firebase::database::Database نقطه ورود برای کیت توسعه نرم‌افزار Firebase Realtime Database ++C است.

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

اگر انتخاب کرده‌اید که از دسترسی عمومی برای قوانین خود استفاده کنید، می‌توانید به بخش‌های مربوط به ذخیره و بازیابی داده‌ها بروید.

درحال راه‌اندازی «دسترسی محدودشده»

اگر نمی‌خواهید از دسترسی عمومی استفاده کنید، می‌توانید Firebase Authentication را به برنامه‌تان اضافه کنید تا دسترسی به پایگاه داده را کنترل کنید.

مراحل بعدی

مشکلات شناخته شده

  • در پلاتفرم‌های رایانه (Windows،‏ Mac،‏ Linux)، کیت توسعه نرم‌افزار Firebase C++ از REST برای دسترسی به پایگاه داده شما استفاده می‌کند. به‌همین دلیل، باید شاخص‌هایی را که استفاده می‌کنید با Query::OrderByChild() در رایانه تعریف کنید، درغیراین‌صورت شنوندگان شما ناموفق خواهند بود.
  • نسخه گردش کار رایانه Realtime Database از آفلاین یا ماندگاری پشتیبانی نمی‌کند.