Installation & Einrichtung auf Apple-Plattformen

Die Firebase Realtime Database ist eine in der Cloud gehostete Datenbank. Daten werden als JSON gespeichert und in Echtzeit mit jedem verbundenen Client synchronisiert. Wenn Sie plattformübergreifende Apps mit unseren Android-, iOS- und JavaScript-SDKs erstellen, teilen sich alle Ihre Clients eine Realtime Database-Instanz und erhalten automatisch Updates mit den neuesten Daten.

Firebase Realtime Database ist auf allen Apple-Plattformen verfügbar, einschließlich iOS, macOS, macOS Catalyst, tvOS und watchOS. Es ist nicht für App-Clips verfügbar. Die Setup-Anweisungen auf dieser Seite beziehen sich in bestimmten Beispielen auf iOS, sind jedoch generisch und funktionieren für alle Apple-Plattformziele.

Voraussetzungen

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

Erstellen Sie eine Datenbank

  1. Navigieren Sie zum Abschnitt Echtzeitdatenbank der Firebase-Konsole . Sie werden aufgefordert, ein vorhandenes Firebase-Projekt auszuwählen. Folgen Sie dem Workflow zur Datenbankerstellung.

  2. Wählen Sie einen Startmodus für Ihre Firebase-Sicherheitsregeln aus:

    Testmodus

    Gut für den Einstieg in die mobilen und Web-Client-Bibliotheken, aber jeder kann Ihre Daten lesen und überschreiben. Lesen Sie nach dem Testen unbedingt den Abschnitt Grundlegendes zu Firebase-Echtzeitdatenbankregeln .

    Um mit dem Web-, Apple- oder Android-SDK zu beginnen, wählen Sie den Testmodus aus.

    Gesperrter Modus

    Verweigert alle Lese- und Schreibvorgänge von Mobil- und Web-Clients. Ihre authentifizierten Anwendungsserver können weiterhin auf Ihre Datenbank zugreifen.

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

    Abhängig vom Speicherort der Datenbank hat die URL für die neue Datenbank 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 aktiviert.

Fügen Sie Ihrer App Firebase Realtime Database hinzu

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

  1. Navigieren Sie in Xcode bei geöffnetem App-Projekt zu File > Add Packages .
  2. Wenn Sie dazu aufgefordert werden, fügen Sie das Firebase Apple-Plattform-SDK-Repository hinzu:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Wählen Sie die Realtime Database-Bibliothek.
  5. Wenn Sie fertig sind, beginnt Xcode automatisch mit dem Auflösen und Herunterladen Ihrer Abhängigkeiten im Hintergrund.

Konfigurieren Sie Echtzeit-Datenbanksicherheitsregeln

Die Realtime Database bietet eine deklarative Regelsprache, mit der Sie definieren können, wie Ihre Daten strukturiert, wie sie indiziert werden sollen und wann Ihre Daten gelesen und geschrieben werden können.

Richten Sie die Firebase-Echtzeitdatenbank ein

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

  1. Importieren Sie das FirebaseCore Modul in Ihr UIApplicationDelegate sowie alle anderen Firebase-Module, die Ihr App-Delegierter verwendet. So verwenden Sie beispielsweise Cloud Firestore und Authentifizierung:

    SwiftUI

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

    Schnell

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Ziel c

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Konfigurieren Sie eine freigegebene FirebaseApp Instanz in der Methode application(_:didFinishLaunchingWithOptions:) Ihres App-Delegaten:

    SwiftUI

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

    Schnell

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

    Ziel c

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Wenn Sie SwiftUI verwenden, müssen Sie einen Anwendungsdelegaten erstellen und ihn über UIApplicationDelegateAdaptor oder NSApplicationDelegateAdaptor an Ihre App Struktur anfügen. Sie müssen auch das Swizzling von App-Delegaten deaktivieren. Weitere Informationen finden Sie in den SwiftUI-Anweisungen .

    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 einen Verweis auf Ihre Datenbank und geben Sie den Speicherort an, an den Sie schreiben möchten.

    Schnell

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

    Ziel c

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

Nächste Schritte