Installazione e configurazione su piattaforme Apple

Firebase Realtime Database è un database ospitato nel cloud. I dati vengono archiviati come JSON e sincronizzati in tempo reale con ogni client connesso. Quando crei app multipiattaforma con i nostri SDK per Android, iOS e JavaScript, tutti i tuoi clienti condividono un'istanza di Realtime Database e ricevono automaticamente gli aggiornamenti con i dati più recenti.

Firebase Realtime Database è disponibile su tutte le piattaforme Apple, inclusi iOS, macOS, macOS Catalyst, tvOS e watchOS. Non è disponibile per App Clips. Le istruzioni di configurazione in questa pagina fanno riferimento a iOS in esempi specifici, ma sono generiche e funzionano per qualsiasi destinazione della piattaforma Apple.

Prerequisiti

  1. Installa l'SDK Firebase .
  2. Aggiungi la tua app al tuo progetto Firebase nella console Firebase .

Crea una banca dati

  1. Passa alla sezione Realtime Database della console Firebase . Ti verrà chiesto di selezionare un progetto Firebase esistente. Segui il flusso di lavoro per la creazione del database.

  2. Seleziona una modalità iniziale per le regole di sicurezza di Firebase:

    Modalità di prova

    Buono per iniziare con le librerie client mobile e web, ma consente a chiunque di leggere e sovrascrivere i tuoi dati. Dopo il test, assicurati di esaminare la sezione Comprendere le regole del database in tempo reale di Firebase .

    Per iniziare con l'SDK Web, Apple o Android, seleziona la modalità test.

    Modalità bloccata

    Nega tutte le letture e le scritture da client mobili e web. I tuoi server delle applicazioni autenticati possono ancora accedere al tuo database.

  3. Scegli una posizione per il database.

    A seconda della posizione del database , l'URL per il nuovo database sarà in uno dei seguenti formati:

    • DATABASE_NAME .firebaseio.com (per database in us-central1 )

    • DATABASE_NAME . REGION .firebasedatabase.app (per i database in tutte le altre località)

  4. Fai clic su Fatto .

Quando abiliti Realtime Database, abilita anche l'API in Cloud API Manager .

Aggiungi Firebase Realtime Database alla tua app

Utilizza Swift Package Manager per installare e gestire le dipendenze di Firebase.

  1. In Xcode, con il progetto dell'app aperto, vai a File > Add Packages .
  2. Quando richiesto, aggiungi il repository SDK delle piattaforme Firebase Apple:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Scegli la libreria Realtime Database.
  5. Al termine, Xcode inizierà automaticamente a risolvere e scaricare le tue dipendenze in background.

Configura le regole del database in tempo reale

Il database in tempo reale fornisce un linguaggio di regole dichiarative che ti consente di definire come i tuoi dati dovrebbero essere strutturati, come dovrebbero essere indicizzati e quando i tuoi dati possono essere letti e scritti.

Configura il database in tempo reale di Firebase

Devi inizializzare Firebase prima di creare o utilizzare qualsiasi riferimento all'app Firebase. Se lo hai già fatto per un'altra funzionalità di Firebase, puoi saltare questo passaggio.

  1. Importa il modulo FirebaseCore nel tuo UIApplicationDelegate , così come qualsiasi altro modulo Firebase utilizzato dal delegato dell'app. Ad esempio, per utilizzare Cloud Firestore e l'autenticazione:

    SwiftUI

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

    Rapido

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Obiettivo-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Configura un'istanza condivisa FirebaseApp nel metodo application(_:didFinishLaunchingWithOptions:) del delegato dell'app:

    SwiftUI

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

    Rapido

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

    Obiettivo-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Se utilizzi SwiftUI, devi creare un delegato dell'applicazione e allegarlo alla struttura App tramite UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor . È inoltre necessario disabilitare lo scorrimento del delegato dell'app. Per ulteriori informazioni, consulta le istruzioni 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. Crea un riferimento al tuo database e specifica la posizione in cui vuoi scrivere.

    Rapido

    Nota: questo prodotto Firebase non è disponibile nel target App Clip.
    var ref: DatabaseReference!
    
    ref = Database.database().reference()

    Obiettivo-C

    Nota: questo prodotto Firebase non è disponibile nel target App Clip.
    @property (strong, nonatomic) FIRDatabaseReference *ref;
    
    self.ref = [[FIRDatabase database] reference];

Prossimi passi