Installation & Einrichtung auf Apple-Plattformen

Die Firebase Realtime Database ist eine in der Cloud gehostete Datenbank. Die 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 Kunden eine Echtzeitdatenbankinstanz und erhalten automatisch Updates mit den neuesten Daten.

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

Voraussetzungen

  1. Installieren Sie das Firebase SDK .
  2. Fügen Sie Ihre App zu 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. Befolgen Sie den Workflow zur Datenbankerstellung.

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

    Testmodus

    Gut für den Einstieg in die Mobil- und Web-Client-Bibliotheken, ermöglicht aber jedem, Ihre Daten zu lesen und zu überschreiben. Lesen Sie nach dem Testen unbedingt den Abschnitt „Verstehen der Firebase-Echtzeitdatenbankregeln“ .

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

    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 eine der folgenden Formen:

    • 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 die Echtzeitdatenbank aktivieren, wird auch die API im Cloud API Manager aktiviert.

Fügen Sie Ihrer App die Firebase-Echtzeitdatenbank 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 Platforms SDK-Repository hinzu:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. Wählen Sie die Bibliothek „Echtzeitdatenbank“.
  4. Wenn Sie fertig sind, beginnt Xcode automatisch mit der Auflösung und dem Herunterladen Ihrer Abhängigkeiten im Hintergrund.

Konfigurieren Sie Echtzeit-Datenbanksicherheitsregeln

Die Echtzeitdatenbank bietet eine deklarative Regelsprache, mit der Sie definieren können, wie Ihre Daten strukturiert sein sollen, 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. Um beispielsweise Cloud Firestore und Authentifizierung zu verwenden:

    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 gemeinsam genutzte FirebaseApp Instanz in der application(_:didFinishLaunchingWithOptions:) Methode Ihres App-Delegierten:

    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 anhängen. Sie müssen auch das Swizzling von App-Delegierten 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