Installation et installation Configuration sur les plateformes Apple

La base de données Firebase Realtime 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 multiplateformes avec nos SDK Android, iOS et JavaScript, tous vos clients partagent une instance de base de données en temps réel et reçoivent automatiquement des mises à jour avec les données les plus récentes.

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

Conditions préalables

  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 Base de données en temps réel de la console Firebase . Vous serez 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 vos règles de sécurité Firebase :

    Mode d'essai

    Idéal pour démarrer avec les bibliothèques clientes mobiles et Web, mais permet à quiconque de lire et d'écraser vos données. Après le test, assurez-vous de consulter la section Comprendre les règles de la base de données en temps réel Firebase .

    Pour démarrer avec 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.

    En fonction de l' emplacement de la base de données , l'URL de la nouvelle base de données se présentera sous 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 de tous les autres emplacements)

  4. Cliquez sur Terminé .

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

Ajoutez la base de données en temps réel Firebase à 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 .
  2. Lorsque vous y êtes invité, ajoutez le référentiel SDK des plates-formes Apple Firebase :
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Choisissez la bibliothèque de base de données en temps réel.
  5. Ajoutez l'indicateur -ObjC à la section Autres indicateurs de l'éditeur de liens des paramètres de construction de votre cible.
  6. Une fois terminé, Xcode commencera automatiquement à résoudre et à télécharger vos dépendances en arrière-plan.

Configurer les règles de sécurité de la base de données en temps réel

La base de données en temps réel fournit un langage de règles déclaratives qui vous permet de définir comment vos données doivent être structurées, comment elles doivent être indexées et quand vos données peuvent être lues et écrites.

Configurer la base de données en temps réel Firebase

Vous devez initialiser Firebase avant qu'une référence d'application Firebase ne soit créée ou utilisée. 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 l'authentification :

    SwiftUI

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Rapide

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objectif 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()

    Rapide

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objectif 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'attacher à votre structure App via UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor . Vous devez également désactiver le swizzling des délégués d’application. Pour plus d'informations, 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 dans lequel vous souhaitez écrire.

    Rapide

    Remarque : Ce produit Firebase n'est pas disponible sur la cible App Clip.
    var ref: DatabaseReference!
    
    ref = Database.database().reference()

    Objectif c

    Remarque : Ce produit Firebase n'est pas disponible sur la cible App Clip.
    @property (strong, nonatomic) FIRDatabaseReference *ref;
    
    self.ref = [[FIRDatabase database] reference];

Prochaines étapes