Installazione e Configurazione sulle piattaforme Apple

Firebase Realtime Database è un database ospitato nel 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 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 piattaforma Apple di destinazione.

Prerequisiti

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

Crea un database

  1. Nella console Firebase, vai a Database e spazio di archiviazione > Realtime Database.

  2. Fai clic su Crea database.

  3. Seleziona una modalità di avvio per Firebase Security Rules:

    Modalità di test

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

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

    Modalità di blocco

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

  4. 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à)

  5. Fai clic su Fine.

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

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

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

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 nel tuo UIApplicationDelegate, nonché tutti gli altri moduli Firebase utilizzati dal tuo 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 tuo 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 maggiori 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 tuo database e specifica la posizione in cui vuoi scrivere.

    Swift

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

ref = Database.database().reference()

    Objective-C

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

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

Passaggi successivi