Installazione e Configurazione sulle piattaforme Apple

Il 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 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 target di piattaforma Apple.

Prerequisiti

  1. Installa l'SDK Firebase.
  2. Aggiungi l'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à di avvio per Firebase Security Rules:

    Modalità di prova

    Ideale per iniziare a utilizzare le librerie client web e su dispositivi mobili, ma consente a chiunque di leggere e sovrascrivere i dati. Dopo il test, assicurati di esaminare la sezione Informazioni sulle regole di Firebase Realtime Database.

    Per iniziare a utilizzare l'SDK web, Apple o Android, seleziona la modalità di prova.

    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 località per il database.

    A seconda della località 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 the 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 (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 libreria Realtime Database.
  4. Aggiungi il flag -ObjC alla sezione Other Linker Flags (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

Il Realtime Database fornisce un linguaggio di regole dichiarativo che ti consente di definire la struttura dei dati, la modalità di indicizzazione e quando è possibile leggere e scrivere i dati.

Configura Firebase Realtime Database

Devi inizializzare Firebase prima di creare o utilizzare 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 in 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 nel metodo application(_:didFinishLaunchingWithOptions:) del delegato dell'app:FirebaseApp

    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 di 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 località in cui vuoi scrivere.

    Swift

    Nota: questo prodotto Firebase non è disponibile sul target App Clip. 
    var ref: DatabaseReference!

ref = Database.database().reference()

    Objective-C

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

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

Passaggi successivi