התקנה & התקנה בפלטפורמות של אפל

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

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

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

  1. התקן את Firebase SDK .
  2. הוסף את האפליקציה שלך לפרויקט Firebase שלך ​​במסוף Firebase .

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

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

  2. בחר מצב התחלה עבור כללי האבטחה של Firebase:

    מצב מבחן

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

    כדי להתחיל בעבודה עם האינטרנט, Apple או Android SDK, בחר במצב test.

    מצב נעול

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

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

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

    • DATABASE_NAME .firebaseio.com (עבור מסדי נתונים ב- us-central1 )

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

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

כאשר אתה מפעיל את מסד הנתונים בזמן אמת, הוא גם מפעיל את ה-API ב- Cloud API Manager .

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

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

  1. ב-Xcode, כשפרויקט האפליקציה שלך פתוח, נווט אל קובץ > הוסף חבילות .
  2. כשתתבקש, הוסף את מאגר Firebase Apple platforms SDK:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. בחר את ספריית מסד הנתונים בזמן אמת.
  5. הוסף את הדגל -ObjC לקטע Other Linker Flags של הגדרות הבנייה של היעד שלך.
  6. בסיום, Xcode יתחיל באופן אוטומטי לפתור ולהוריד את התלות שלך ברקע.

הגדר את כללי האבטחה של מסדי נתונים בזמן אמת

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

הגדר את מסד נתונים בזמן אמת של Firebase

עליך לאתחל את Firebase לפני יצירה או שימוש בהפניה לאפליקציה של Firebase. אם כבר עשית זאת עבור תכונה אחרת של Firebase, תוכל לדלג על שלב זה.

  1. ייבא את מודול FirebaseCore ב- UIApplicationDelegate שלך, כמו גם כל מודולי Firebase אחרים שנציג האפליקציה שלך משתמש בו. לדוגמה, כדי להשתמש ב-Cloud Firestore ובאימות:

    SwiftUI

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

    מָהִיר

    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()

    מָהִיר

    // 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. צור הפניה למסד הנתונים שלך וציין את המיקום שאליו ברצונך לכתוב.

    מָהִיר

    הערה: מוצר 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];

הצעדים הבאים