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 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. In der Einrichtungsanleitung auf dieser Seite wird iOS in bestimmten Beispielen genannt. Sie ist jedoch allgemein gehalten und funktioniert für alle Apple-Plattformen.

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 Datenbanken und Speicher > Realtime Database auf.

  2. Klicken Sie auf Datenbank erstellen.

  3. Wähle einen Startmodus für dein Firebase Security Rules aus:

    Testmodus

    Gut für den Einstieg in die mobilen 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.

    Wählen Sie den Testmodus 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.

  4. Wählen Sie einen Standort 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 zur 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 Bibliothek Realtime Database aus.
  4. Fügen Sie das Flag -ObjC im 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 festlegen können, wie Ihre Daten strukturiert und indexiert werden sollen und wann 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 Ihr App-Delegat verwendet. Beispiel für die Verwendung von 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 in der application(_:didFinishLaunchingWithOptions:)-Methode des App-Delegats eine freigegebene FirebaseApp-Instanz:

    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-Delegat erstellen und es über UIApplicationDelegateAdaptor oder NSApplicationDelegateAdaptor an Ihre App-Struktur anhängen. Außerdem müssen Sie das Swizzling des 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, an 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