Installation et Configuration sur les plates-formes Apple

Le 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és en temps réel à chaque client connecté. Lorsque vous créez multiplate-forme avec nos SDK Android, iOS et JavaScript, Les clients partagent une instance Realtime Database et reçoivent automatiquement les mises à jour avec des 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 clips d'application. Les instructions de configuration de cette page font référence à iOS dans des exemples spécifiques, génériques et adaptées à toutes les plates-formes cibles 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 Console Firebase Vous êtes 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

    Bon pour démarrer avec les bibliothèques clientes mobiles et Web, mais permet à n’importe qui de lire et d’écraser vos données. Après les tests, faites consultez Comprendre les règles Firebase Realtime Database .

    Pour commencer à utiliser le SDK Web, Apple ou Android, sélectionnez "testmode".

    Mode verrouillé

    Interdit toute lecture et écriture à partir de 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 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 OK.

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

Ajouter Firebase Realtime Database à votre application

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

  1. Dans Xcode, ouvrez le projet de votre application, puis accédez à File > 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 structure et l'indexation de vos données, ainsi que les moments où elles peuvent être lues et écrites.

Configurer Firebase Realtime Database

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

  1. Importez le module FirebaseCore dans votre UIApplicationDelegate, ainsi que toute autre Modules Firebase que votre délégué d'application utilise. 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 un FirebaseApp l'instance partagée dans le bucket du délégué Méthode application(_:didFinishLaunchingWithOptions:):

    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 swizzling du délégué 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 de l'extrait d'application. 
    var ref: DatabaseReference!

ref = Database.database().reference()

    Objective-C

    Remarque:Ce produit Firebase n'est pas disponible sur la cible de l'extrait d'application. 
    @property (strong, nonatomic) FIRDatabaseReference *ref;

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

Étapes suivantes