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, 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. Für App Clips ist sie nicht 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-Konsole den Abschnitt Realtime Database auf. Sie werden aufgefordert, ein vorhandenes Firebase-Projekt auszuwählen. Folgen Sie dem Workflow zur Datenbankerstellung.

  2. Wählen Sie einen Startmodus für Ihr 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 „testmode“ aus, um mit dem Web-, Apple- oder Android-SDK zu beginnen.

    Sperrmodus

    Verweigert alle Lese- und Schreibvorgänge von Mobil- und Webclients. 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 in Ihre App einbinden

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
  4. Wählen Sie die Realtime Database-Bibliothek aus.
  5. Fügen Sie das Flag -ObjC dem Abschnitt Other Linker Flags (Weitere Linker-Flags) der Build-Einstellungen Ihres Ziels 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 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 ein anderes Firebase-Feature getan haben, können Sie diesen Schritt überspringen.

  1. Importieren Sie das FirebaseCore-Modul in Ihre UIApplicationDelegate sowie alle anderen Firebase-Module, die von Ihrem App-Delegaten verwendet werden. 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 eine freigegebene FirebaseApp-Instanz in der Methode application(_:didFinishLaunchingWithOptions:) des App-Delegaten:

    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 Anwendungs-Delegate erstellen und es über UIApplicationDelegateAdaptor oder NSApplicationDelegateAdaptor an Ihre App-Struktur anhängen. Außerdem müssen Sie das Swizzling von App-Delegaten 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 einen Verweis auf Ihre Datenbank und geben Sie den Speicherort an, in den Sie schreiben möchten.

    Swift

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

    Objective-C

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

Nächste Schritte