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

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

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

پیش نیازها

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

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

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

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

    حالت تست

    برای شروع کار با کتابخانه های موبایل و کلاینت وب خوب است، اما به هر کسی اجازه می دهد داده های شما را بخواند و بازنویسی کند. پس از تست، حتما قسمت Understand Firebase Realtime Database Rules را مرور کنید.

    برای شروع کار با وب، اپل یا اندروید SDK، حالت تست را انتخاب کنید.

    حالت قفل شده

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

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

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

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

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

  4. روی Done کلیک کنید.

هنگامی که Realtime Database فعال می کنید، API را در Cloud API Manager نیز فعال می کند.

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

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

  1. در Xcode، با باز بودن پروژه برنامه، به File > Add Packages بروید.
  2. هنگامی که از شما خواسته شد، مخزن SDK پلتفرم های Apple Firebase را اضافه کنید: 
    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
// ...

    سویفت 

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    هدف-C 

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

    SwiftUI 

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

    سویفت 

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

    هدف-C 

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

    سویفت

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

ref = Database.database().reference()

    هدف-C

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

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

مراحل بعدی