Installazione e Configurazione sulle piattaforme Apple

Firebase Realtime Database è un database ospitato sul cloud. I dati vengono archiviati in formato 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 client 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, tra cui iOS, macOS, macOS Catalyst, tvOS e watchOS. Non è disponibile per gli App Clip. Le istruzioni di configurazione in questa pagina fanno riferimento a iOS in esempi specifici, ma sono generiche e funzionano per qualsiasi piattaforma Apple di destinazione.

Prerequisiti

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

Crea un database

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

  2. Seleziona una modalità iniziale per Firebase Security Rules:

    Modalità di prova

    Ideale per iniziare a utilizzare le librerie client web e mobile, ma consente a chiunque di leggere e sovrascrivere i tuoi dati. Dopo il test, assicurati di esaminare la sezione Comprendere le regole di Firebase Realtime Database.

    Per iniziare a utilizzare l'SDK per il web, Apple o Android, seleziona testmode.

    Modalità di blocco

    Nega tutte le operazioni di lettura e scrittura dei client web e su dispositivi mobili. I server delle applicazioni autenticati possono comunque accedere al database.

  3. Scegli una posizione per il database.

    A seconda della posizione del database, l'URL del nuovo database avrà uno dei seguenti formati:

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

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

  4. Fai clic su Fine.

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

Aggiungere 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 (File > Aggiungi pacchetti).
  2. Quando richiesto, aggiungi il repository dell'SDK delle piattaforme Apple di Firebase:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Scegli la raccolta Realtime Database.
  4. Aggiungi il flag -ObjC alla sezione Altri flag del linker delle impostazioni di build del target.
  5. Al termine, Xcode inizierà automaticamente a risolvere e a scaricare le tue dipendenze in background.

Configura Realtime Database Security Rules

Realtime Database fornisce un linguaggio di regole dichiarativo che ti consente di definire come devono essere strutturati i tuoi dati, come devono essere indicizzati e quando possono essere letti e scritti.

Configura Firebase Realtime Database

Devi inizializzare Firebase prima che venga creato o utilizzato qualsiasi riferimento all'app Firebase. Se hai già eseguito questa operazione per un'altra funzionalità di Firebase, puoi saltare questo passaggio.

  1. Importa il modulo FirebaseCore nel tuo UIApplicationDelegate, nonché tutti gli altri moduli Firebase utilizzati dal delegato dell'app. Ad esempio, per utilizzare Cloud Firestore e 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. Configura un'istanza condivisa FirebaseApp nel metodo application(_:didFinishLaunchingWithOptions:) del delegato dell'app:

    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. Se utilizzi SwiftUI, devi creare un delegato dell'applicazione e collegarlo alla struttura App tramite UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor. Devi anche disattivare lo swizzling del delegato dell'app. Per ulteriori informazioni, consulta le istruzioni per 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 database e specifica la posizione in cui vuoi scrivere.

    Swift

    Nota:questo prodotto Firebase non è disponibile nella destinazione App Clip. 
    var ref: DatabaseReference!

ref = Database.database().reference()

    Objective-C

    Nota:questo prodotto Firebase non è disponibile nella destinazione App Clip. 
    @property (strong, nonatomic) FIRDatabaseReference *ref;

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

Passaggi successivi