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

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

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

پیش‌نیازها

  1. فایربیس SDK را نصب کنید .
  2. برنامه خود را به پروژه Firebase خود در کنسول Firebase اضافه کنید.

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

  1. به بخش Realtime Database در کنسول Firebase بروید. از شما خواسته می‌شود که یک پروژه Firebase موجود را انتخاب کنید. مراحل ایجاد پایگاه داده را دنبال کنید.

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

    حالت تست

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

    برای شروع کار با وب، اپل یا اندروید SDK، حالت آزمایشی (testmode) را انتخاب کنید.

    حالت قفل شده

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

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

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

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

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

  4. روی انجام شد کلیک کنید.

وقتی Realtime Database فعال می‌کنید، API را نیز در Cloud API Manager فعال می‌کند.

Firebase Realtime Database به برنامه خود اضافه کنید

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

  1. در Xcode، با باز کردن پروژه برنامه خود، به File > Add Packages بروید.
  2. وقتی از شما خواسته شد، مخزن SDK پلتفرم‌های اپل فایربیس را اضافه کنید: 
    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 دیگری که app delegate شما از آن استفاده می‌کند. به عنوان مثال، برای استفاده از Cloud Firestore و Authentication :

    سویفت‌یو‌آی 

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

    سویفت 

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    هدف-سی 

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

    سویفت‌یو‌آی 

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

    سویفت 

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

    هدف-سی 

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

    سویفت‌یو‌آی 

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

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

    سویفت

    توجه: این محصول Firebase در App Clip target در دسترس نیست. 
    var ref: DatabaseReference!

ref = Database.database().reference()

    هدف-سی

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

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

مراحل بعدی