Installation et configuration sur les plates-formes 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, y compris iOS, macOS, macOS Catalyst, tvOS et watchOS. Il n'est pas disponible pour les clips d'application. 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 la base de données.

  2. Sélectionnez un mode de démarrage pour vos règles de sécurité Firebase :

    Mode d'essai

    Bon pour démarrer avec les bibliothèques de clients mobiles et Web, mais permet à n'importe qui 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 Web, Apple ou Android SDK, sélectionnez testmode.

    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 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 dans tous les autres emplacements)

  4. Cliquez sur Terminé .

Lorsque vous activez la base de données en temps réel, 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 .
  2. Lorsque vous y êtes invité, ajoutez le dépôt du SDK des plates-formes Apple Firebase :
    3.   https://github.com/firebase/firebase-ios-sdk
  3. Choisissez la bibliothèque de base de données en temps réel.
  4. 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 la création ou l'utilisation de toute 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 tout autre module Firebase utilisé par votre délégué d'application. Par exemple, pour utiliser Cloud Firestore et 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 où 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