Installation & Einrichtung auf Apple-Plattformen

Die Firebase Realtime Database ist eine in der Cloud gehostete Datenbank. Daten werden im JSON-Format gespeichert und in Echtzeit mit jedem verbundenen Client synchronisiert. Wenn Sie plattformübergreifenden Apps mit unseren Android-, iOS- und JavaScript-SDKs nutzen, Clients gemeinsam eine Realtime Database-Instanz und erhalten automatisch Updates mit immer auf dem neuesten Stand.

Firebase Realtime Database ist auf allen Apple-Plattformen verfügbar, einschließlich iOS, macOS, macOS Catalyst, tvOS und watchOS. Sie ist nicht für App Clips verfügbar. Die Einrichtungsanleitung auf dieser Seite bezieht sich in bestimmten Beispielen auf iOS, ist aber und für jede Apple-Plattform geeignet.

Vorbereitung

  1. Installieren Sie das Firebase SDK.
  2. Fügen Sie die App Ihrem Firebase-Projekt in der Firebase Console hinzu.

Datenbank erstellen

  1. Gehen Sie zum Abschnitt Realtime Database des Firebase-Konsole. Sie werden aufgefordert, ein vorhandenes Firebase-Projekt auszuwählen. Folgen Sie dem Workflow zur Datenbankerstellung.

  2. Wähle einen Startmodus für dein Firebase Security Rules aus:

    Testmodus

    Gut für den Einstieg in die Mobil- und Web-Clientbibliotheken, ermöglicht aber jedem, Ihre Daten zu lesen und zu überschreiben. Machen Sie nach dem Testen lesen Sie die Informationen zu Firebase Realtime Database-Regeln. .

    Wenn du das Web-, Apple- oder Android SDK verwenden möchtest, wähle „testmode“ aus.

    Sperrmodus

    Alle Lese- und Schreibvorgänge über Mobil- und Webclients werden abgelehnt. Ihre authentifizierten Anwendungsserver können weiterhin auf Ihre Datenbank zugreifen.

  3. Wählen Sie einen Speicherort für die Datenbank aus.

    Je nach Speicherort der Datenbank, der Die URL für die neue Datenbank hat eines der folgenden Formate:

    • DATABASE_NAME.firebaseio.com (für Datenbanken in us-central1)

    • DATABASE_NAME.REGION.firebasedatabase.app (für Datenbanken an allen anderen Standorten)

  4. Klicken Sie auf Fertig.

Wenn Sie Realtime Database aktivieren, wird auch die API im Cloud API Manager

Firebase Realtime Database zu deiner App hinzufügen

Verwenden Sie Swift Package Manager, um Firebase-Abhängigkeiten zu installieren und zu verwalten.

  1. Gehen Sie in Xcode bei geöffnetem App-Projekt zu File > Pakete hinzufügen.
  2. Fügen Sie bei entsprechender Aufforderung das Firebase Apple Platforms SDK-Repository hinzu:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Wählen Sie die Realtime Database-Bibliothek aus.
  5. Fügen Sie in den Build-Einstellungen des Ziels im Bereich Other Linker Flags das Flag -ObjC hinzu.
  6. Wenn Sie fertig, beginnt Xcode automatisch, Ihre Abhängigkeiten im Hintergrund aufzulösen und herunterzuladen.

Realtime Database Security Rules konfigurieren

Die Realtime Database stellt eine deklarative Regelsprache bereit, mit der Sie Folgendes tun können: definieren Sie, wie Ihre Daten strukturiert, wie sie indexiert werden und wann aus denen Ihre Daten gelesen und geschrieben werden können.

Firebase Realtime Database einrichten

Sie müssen Firebase initialisieren, bevor eine Firebase-App-Referenz erstellt wird. verwendet. Wenn Sie dies bereits für eine andere Firebase-Funktion getan haben, können Sie diesen Schritt überspringen für diesen Schritt.

  1. Importieren Sie das Modul FirebaseCore in Ihr UIApplicationDelegate sowie alle anderen Firebase-Module, die Ihr App-Delegate verwendet. So verwenden Sie beispielsweise Cloud Firestore und 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. Konfigurieren Sie ein FirebaseApp freigegebene Instanz im Methode 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. Wenn Sie SwiftUI verwenden, müssen Sie einen Anwendungsdelegierten erstellen und diesen anhängen. zu deiner App-Struktur über UIApplicationDelegateAdaptor oder NSApplicationDelegateAdaptor Außerdem müssen Sie das App-Delegate-Swizzling deaktivieren. Für Weitere Informationen finden Sie in der SwiftUI-Anleitung.

    SwiftUI

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          
  4. Erstellen Sie eine Referenz auf Ihre Datenbank und geben Sie den Speicherort an, an den Sie schreiben möchten.

    Swift

    Hinweis: Dieses Firebase-Produkt ist nicht im App Clip-Ziel verfügbar.
    var ref: DatabaseReference!
    
    ref = Database.database().reference()

    Objective-C

    Hinweis: Dieses Firebase-Produkt ist nicht im App Clip-Ziel verfügbar.
    @property (strong, nonatomic) FIRDatabaseReference *ref;
    
    self.ref = [[FIRDatabase database] reference];

Nächste Schritte