نصب و راه‌اندازی در پلاتفرم‌های Apple

‫Firebase Realtime Database پایگاه داده‌ای است که در فضای ابری میزبانی می‌شود. داده‌ها به‌صورت JSON ذخیره می‌شوند و به‌صورت هم‌زمان با همه کارخواه‌های متصل همگام‌سازی می‌شوند. وقتی با کیت‌های توسعه نرم‌افزار Android،‏ iOS، و JavaScript ما برنامه‌های چندسکویی می‌سازید، همه مشتریان شما یک نمونه Realtime Database را هم‌رسانی می‌کنند و به‌طور خودکار به‌روزرسانی‌ها را با جدیدترین داده‌ها دریافت می‌کنند.

‫Firebase Realtime Database در همه پلاتفرم‌های Apple، ازجمله iOS،‏ macOS،‏ macOS Catalyst،‏ tvOS، و watchOS دردسترس است. این قابلیت برای «برش‌های برنامه» دردسترس نیست. دستورالعمل‌های راه‌اندازی در این صفحه در مثال‌های خاص به iOS اشاره می‌کند، اما کلی است و برای هر پلاتفرم هدف Apple کار می‌کند.

پیش‌نیازها

  1. کیت توسعه نرم‌افزار Firebase را نصب کنید.
  2. برنامه‌تان را در کنسول Firebase به پروژه Firebase اضافه کنید.

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

  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 Realtime Database به برنامه

از «مدیر بسته Swift» برای نصب و مدیریت وابستگی‌های Firebase استفاده کنید.

  1. در Xcode، با باز بودن پروژه برنامه، به File > Add Packages (فایل > افزودن بسته‌ها) پیمایش کنید.
  2. وقتی درخواست شد، مخزن کیت توسعه نرم‌افزار پلاتفرم‌های Firebase Apple را اضافه کنید:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. کتابخانه Realtime Database را انتخاب کنید.
  4. پرچم -ObjC را به بخش پرچم‌های پیونددهنده دیگر در تنظیمات ساخت هدف اضافه کنید.
  5. پس‌از اتمام، Xcode به‌طور خودکار شروع به حل و بارگیری وابستگی‌های شما در پس‌زمینه می‌کند.

پیکربندی Realtime Database Security Rules

Realtime Database زبان قوانین بیانی‌ای ارائه می‌دهد که به شما امکان می‌دهد تعریف کنید داده‌هایتان چگونه ساختاردهی شوند، چگونه نمایه‌گذاری شوند، و چه زمانی داده‌هایتان می‌توانند خوانده شوند و در آن‌ها نوشته شود.

راه‌اندازی Firebase Realtime Database

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

  1. واحد FirebaseCore را در UIApplicationDelegate و همچنین هر واحد Firebase دیگری که نماینده برنامه شما استفاده می‌کند وارد کنید. برای مثال، برای استفاده از Cloud Firestore و Authentication:

    SwiftUI

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. نمونه مشترکی را در FirebaseApp روش نماینده برنامه خود پیکربندی کنید: application(_:didFinishLaunchingWithOptions:)

    SwiftUI

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Swift

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. اگر از SwiftUI استفاده می‌کنید، باید نماینده برنامه ایجاد کنید و آن را ازطریق UIApplicationDelegateAdaptor یا NSApplicationDelegateAdaptor به ساختار App پیوست کنید. همچنین باید تغییرات در نماینده برنامه را غیرفعال کنید. برای اطلاعات بیشتر، دستورالعمل‌های SwiftUI را ببینید.

    SwiftUI

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
  4. مرجعی برای پایگاه داده‌تان ایجاد کنید و مکان موردنظرتان را برای نوشتن مشخص کنید.

    Swift

    توجه: این محصول Firebase در هدف «کلیپ برنامه» دردسترس نیست. 
    var ref: DatabaseReference!

ref = Database.database().reference()

    Objective-C

    توجه: این محصول Firebase در هدف «کلیپ برنامه» دردسترس نیست. 
    @property (strong, nonatomic) FIRDatabaseReference *ref;

self.ref = [[FIRDatabase database] reference];

مراحل بعدی