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 Anwendungen mit unseren Android-, iOS- und JavaScript-SDKs erstellen, nutzen alle Ihre Clients dieselbe 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. Sie ist nicht für App Clips verfügbar. Die Einrichtungsanleitung auf dieser Seite bezieht sich in bestimmten Beispielen auf iOS, ist aber allgemein gehalten und funktioniert für jedes Apple-Plattformziel.

Vorbereitung

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

Datenbank erstellen

  1. Rufen Sie in der Firebase console den Realtime Database section auf. 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 Security Rules aus:

    Testmodus

    Gut für die ersten Schritte mit den Mobil- und Web-Clientbibliotheken, allerdings können Ihre Daten von beliebigen Personen gelesen und überschrieben werden. Prüfen Sie nach dem Test den Abschnitt Firebase Realtime Database-Regeln verstehen.

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

    Sperrmodus

    Lehnt alle Lese- und Schreibvorgänge von Mobil- und Webclients ab. 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 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.

Firebase Realtime Database Ihrer App hinzufügen

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

  1. Öffnen Sie Ihr App-Projekt und gehen Sie in Xcode zu File > Add Packages (Datei > 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
  3. Wählen Sie die Realtime Database-Bibliothek aus.
  4. Fügen Sie das Flag -ObjC im Bereich Other Linker Flags (Weitere Verknüpfungsmerker) der Build-Einstellungen Ihres Ziels hinzu.
  5. Wenn Sie fertig, beginnt Xcode automatisch, Ihre Abhängigkeiten im Hintergrund aufzulösen und herunterzuladen.

Realtime Database Security Rules konfigurieren

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

Firebase Realtime Database einrichten

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-Delegate verwendet. Beispiel: So verwenden Sie 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 eine FirebaseApp freigegebene Instanz in der application(_:didFinishLaunchingWithOptions:) Methode Ihres App-Delegates:

    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 ein App-Delegate erstellen und es an Ihre App Struktur über UIApplicationDelegateAdaptor oder NSApplicationDelegateAdaptor anhängen. Außerdem müssen Sie das Swizzling des App-Delegates deaktivieren. 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 zu Ihrer Datenbank und geben Sie den Speicherort an, in den Sie schreiben möchten.

    Swift

    Hinweis:Dieses Firebase-Produkt ist für das App Clip-Ziel nicht verfügbar. 
    var ref: DatabaseReference!

ref = Database.database().reference()

    Objective-C

    Hinweis:Dieses Firebase-Produkt ist für das App Clip-Ziel nicht verfügbar. 
    @property (strong, nonatomic) FIRDatabaseReference *ref;

self.ref = [[FIRDatabase database] reference];

Nächste Schritte