התקנה & הגדרה בפלטפורמות של Apple

Firebase Realtime Database הוא מסד נתונים שמתארח בענן. הנתונים מאוחסנים בפורמט JSON ולסנכרן בזמן אמת לכל לקוח מחובר. כשבונים ב- בפלטפורמות שונות עם ערכות ה-SDK ל-Android, ל-iOS ו-JavaScript, כל לקוחות משתפים מופע Realtime Database אחד ומקבלים עדכונים באופן אוטומטי עם את הנתונים החדשים ביותר.

Firebase Realtime Database זמין בכל הפלטפורמות של Apple, כולל iOS, macOS, macOS Catalyst, tvOS ו-watchOS. האפשרות הזו לא זמינה לקליפים של אפליקציות. הוראות ההגדרה בדף הזה מתייחסות ל-iOS בדוגמאות ספציפיות, אבל כלליים ועובדים עבור כל יעד פלטפורמה של Apple.

דרישות מוקדמות

  1. מתקינים את Firebase SDK.
  2. מוסיפים את האפליקציה לפרויקט Firebase במסוף Firebase.

ליצור מסד נתונים

  1. עוברים לקטע Realtime Database מסוף Firebase. תתבקשו לבחור פרויקט Firebase קיים. לפעול לפי תהליך העבודה ליצירת מסד נתונים.

  2. צריך לבחור מצב התחלה עבור Firebase Security Rules:

    מצב בדיקה

    מתאימים לתחילת העבודה עם ספריות לקוח לנייד ולאינטרנט, אבל הוא מאפשר לכל אחד לקרוא ולהחליף את הנתונים שלכם. לאחר הבדיקה, מבצעים חשוב לקרוא את הכללים בנושא מסדי נתונים בזמן אמת ב-Firebase .

    כדי להתחיל לעבוד עם ה-SDK לאינטרנט, ל-Apple או ל-Android, צריך לבחור באפשרות 'מצב בדיקה'.

    מצב נעילה

    דחייה של כל פעולות הקריאה והכתיבה מלקוחות בנייד ומלקוחות אינטרנט. שרתי האפליקציות המאומתים עדיין יכולים לגשת למסד הנתונים שלכם.

  3. בוחרים את המיקום למסד הנתונים.

    בהתאם לתרחיש לדוגמה למיקום של מסד הנתונים, כתובת ה-URL של מסד הנתונים החדש תהיה באחת מהצורות הבאות:

    • DATABASE_NAME.firebaseio.com (למשך מסדי נתונים בus-central1)

    • DATABASE_NAME.REGION.firebasedatabase.app (למסדי נתונים בכל שאר המיקומים)

  4. לוחצים על סיום.

כשמפעילים את Realtime Database, ה-API מופעל גם במנהל Cloud API.

הוספה של Firebase Realtime Database לאפליקציה

שימוש ב-Swift Package Manager כדי להתקין ולנהל יחסי תלות של Firebase.

  1. ב-Xcode, כשפרויקט האפליקציה פתוח, עוברים אל File > (קובץ >) הוספת חבילות.
  2. כשמופיעה בקשה, מוסיפים את המאגר של Firebase SDK לפלטפורמות של Apple:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. בוחרים את הספרייה Realtime Database.
  4. מוסיפים את הדגל -ObjC לקטע סימונים של מקשר אחר בהגדרות ה-build של היעד.
  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, עליך ליצור נציג מורשה לאפליקציה ולצרף אותו למבנה App שלך דרך UIApplicationDelegateAdaptor או NSApplicationDelegateAdaptor. צריך גם להשבית את החלפת הקוד של נציג האפליקציה. עבור לקבלת מידע נוסף, קראו את ההוראות של 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];

השלבים הבאים