Installation et Configuration sur les plates-formes Apple

Firebase Realtime Database est une base de données hébergée dans le cloud. Les données sont stockées au format JSON et synchronisées en temps réel avec chaque client connecté. Lorsque vous créez des applications multiplates-formes avec nos SDK Android, iOS et JavaScript, tous vos clients partagent une instance Realtime Database et reçoivent automatiquement les mises à jour avec les données les plus récentes.

Firebase Realtime Database est disponible sur toutes les plates-formes Apple, y compris iOS, macOS, macOS Catalyst, tvOS et watchOS. Elle n'est pas disponible pour les applications Clips. Les instructions de configuration de cette page font référence à iOS dans des exemples spécifiques, mais elles sont génériques et fonctionnent pour n'importe quelle cible de plate-forme Apple.

Prérequis

  1. Installez le SDK Firebase.
  2. Ajoutez votre application à votre projet Firebase dans la console Firebase.

Créer une base de données

  1. Accédez à la section Realtime Database de la console Firebase. Vous êtes alors invité à sélectionner un projet Firebase existant. Suivez le workflow de création de base de données.

  2. Sélectionnez un mode de démarrage pour votre Firebase Security Rules :

    Mode test

    Convient pour commencer à utiliser les bibliothèques clientes mobiles et Web, mais permet à tout le monde de lire et d'écraser vos données. Lorsque vous aurez terminé les tests, passez en revue la section Comprendre les règles de Firebase Realtime Database.

    Pour commencer à utiliser le SDK Web, Apple ou Android, sélectionnez le mode test.

    Mode verrouillé

    Refuse toutes les lectures et écritures des clients mobiles et Web. Vos serveurs d'applications authentifiés peuvent toujours accéder à votre base de données.

  3. Choisissez un emplacement pour la base de données.

    Selon l'emplacement de la base de données, l'URL de la nouvelle base de données prend l'une des formes suivantes:

    • DATABASE_NAME.firebaseio.com (pour les bases de données dans us-central1)

    • DATABASE_NAME.REGION.firebasedatabase.app (pour les bases de données situées dans tous les autres emplacements)

  4. Cliquez sur OK.

Lorsque vous activez Realtime Database, cela active également l'API dans Cloud API Manager.

Ajouter Firebase Realtime Database à votre application

Utilisez Swift Package Manager pour installer et gérer les dépendances Firebase.

  1. Dans Xcode, avec votre projet d'application ouvert, accédez à File > Add Packages (Fichier > Ajouter des packages).
  2. Lorsque vous y êtes invité, ajoutez le dépôt du SDK des plates-formes Firebase pour Apple :
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Sélectionnez la bibliothèque Realtime Database.
  4. Ajoutez l'indicateur -ObjC à la section Other Linker Flags (Autres indicateurs Linker) des paramètres de compilation de votre cible.
  5. Lorsque vous avez terminé, Xcode commence à résoudre et à télécharger automatiquement vos dépendances en arrière-plan.

Configurer Realtime Database Security Rules

Realtime Database fournit un langage de règles déclaratives qui vous permet de définir la manière dont vos données doivent être structurées, comment elles doivent être indexées, et quand il est possible de lire et d'écrire des données.

Configurer Firebase Realtime Database

Vous devez initialiser Firebase avant de créer ou d'utiliser une référence d'application Firebase. Si vous l'avez déjà fait pour une autre fonctionnalité Firebase, vous pouvez ignorer cette étape.

  1. Importez le module FirebaseCore dans votre UIApplicationDelegate, ainsi que tous les autres modules Firebase utilisés par votre délégué d'application. Par exemple, pour utiliser Cloud Firestore et 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. Configurez une instance partagée FirebaseApp dans la méthode application(_:didFinishLaunchingWithOptions:) de votre délégué d'application:

    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. Si vous utilisez SwiftUI, vous devez créer un délégué d'application et l'associer à votre struct App via UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor. Vous devez également désactiver le mélange des délégués d'application. Pour en savoir plus, consultez les instructions SwiftUI.

    SwiftUI

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
  4. Créez une référence à votre base de données et spécifiez l'emplacement où vous souhaitez écrire.

    Swift

    Remarque : Ce produit Firebase n'est pas disponible sur la cible App Clip. 
    var ref: DatabaseReference!

ref = Database.database().reference()

    Objective-C

    Remarque : Ce produit Firebase n'est pas disponible sur la cible App Clip. 
    @property (strong, nonatomic) FIRDatabaseReference *ref;

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

Étapes suivantes