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

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

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

پیش‌نیازها

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

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

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

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

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

    حالت آزمایشی

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

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

    حالت قفل‌شده

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

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

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

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

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

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

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

افزودن Firebase Realtime Database به برنامه

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

  1. در Xcode، درحالی‌که پروژه برنامه‌تان باز است، به File (فایل) > Add Packages (افزودن بسته‌ها) بروید.
  2. وقتی خواسته شد، مخزن کیت توسعه نرم‌افزار Firebase برای پلاتفرم‌های Apple را اضافه کنید:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. کتابخانه Realtime Database را انتخاب کنید.
  4. پرچم -ObjC را به بخش Other Linker Flags (سایر پرچم‌های پیونددهنده) در تنظیمات ساخت هدف اضافه کنید.
  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 در هدف App Clip دردسترس نیست. 
    var ref: DatabaseReference!

ref = Database.database().reference()

    Objective-C

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

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

مراحل بعدی