Installazione e Configurazione sulle piattaforme Apple

Firebase Realtime Database è un database ospitato sul cloud. I dati vengono archiviati come JSON e sincronizzati in tempo reale con ogni client connesso. Quando crei app cross-platform con i nostri SDK per Android, iOS e JavaScript, tutti i tuoi clienti 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 le 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 l'app al progetto Firebase nella console Firebase.

Creare 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 per la creazione del database.

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

    Modalità di test

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

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

    Modalità di blocco

    Rifiuta tutte le letture e scritture dai client web e per dispositivi mobili. I tuoi server di applicazioni autenticati possono comunque accedere al tuo database.

  3. Scegli una posizione per il database.

    A seconda della posizione del database, l' URL del nuovo database avrà una delle seguenti forme:

    • 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.

Se attivi Realtime Database, viene attivata anche l'API in Cloud API Manager.

Aggiungere Firebase Realtime Database all'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 > 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 compilazione del target.
  5. Al termine, Xcode inizierà automaticamente a risolvere e a scaricare le tue dipendenze in background.

Configura Realtime Database Security Rules

L'Realtime Database fornisce un linguaggio di regole dichiarative 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 che venga creato o utilizzato un riferimento all'app Firebase. Se lo hai già fatto per un'altra funzionalità di Firebase, puoi saltare questo passaggio.

  1. Importa il modulo FirebaseCore in UIApplicationDelegate, nonché eventuali altri moduli Firebase utilizzati dal tuo app delegate. 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 tua struct App tramite UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor. Devi anche disattivare lo scambio 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 database e specifica la posizione in cui vuoi scrivere.

    Swift

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

ref = Database.database().reference()

    Objective-C

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

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

Passaggi successivi