Installation & Einrichtung auf Apple-Plattformen

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, 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. Firebase SDK installieren
  2. Fügen Sie Ihre App Ihrem Firebase-Projekt in der Firebase Console hinzu.

Datenbank erstellen

  1. Rufen Sie in der Firebase-Konsole Databases & Storage > Realtime Database auf.

  2. Klicken Sie auf Datenbank erstellen.

  3. Wählen Sie einen Startmodus für Ihr Firebase Security Rules aus:

    Testmodus

    Gut für den Einstieg in die Mobil- und Web-Clientbibliotheken, aber jeder kann Ihre Daten lesen und überschreiben. Nach dem Testen sollten Sie sich den Abschnitt Firebase Realtime Database-Regeln verstehen ansehen.

    Wenn Sie mit dem Web-, Apple- oder Android-SDK beginnen möchten, wählen Sie „testmode“ aus.

    Sperrmodus

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

  4. 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)

  5. Klicken Sie auf Fertig.

Wenn Sie Realtime Database aktivieren, wird die API auch 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
  3. Wählen Sie die Realtime Database-Mediathek aus.
  4. Fügen Sie das Flag -ObjC dem Abschnitt Other Linker Flags (Andere Linker-Flags) 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 das bereits für eine andere Firebase-Funktion 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-Delegate 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 gemeinsam genutzte FirebaseApp-Instanz in der application(_:didFinishLaunchingWithOptions:)-Methode 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 Anwendungsdelegate 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 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