Installazione e; Configurazione su piattaforme Apple

Il Firebase Realtime Database è un database ospitato sul cloud. I dati vengono archiviati come JSON e sincronizzati in tempo reale su ogni client connesso. Quando crei app multipiattaforma con i nostri SDK 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 le clip dell'app. 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 di Firebase .
  2. Aggiungi la tua app al tuo progetto Firebase nella console Firebase .

Creare una banca dati

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

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

    Modalità di prova

    Utile per iniziare con le librerie client mobili e Web, ma consente a chiunque di leggere e sovrascrivere i tuoi dati. Dopo il test, assicurati di rivedere la sezione Informazioni sulle regole del database Firebase Realtime .

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

    Modalità bloccata

    Nega tutte le operazioni di lettura e scrittura da client mobili e Web. 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 sarà in 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 posizioni)

  4. Fare clic su Fine .

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 Apple Firebase:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Scegli la libreria Realtime Database.
  5. Aggiungi il flag -ObjC alla sezione Altri flag del linker delle impostazioni di build del tuo target.
  6. Al termine, Xcode inizierà automaticamente a risolvere e scaricare le tue dipendenze in background.

Configura le regole di sicurezza del database in tempo reale

Il Realtime Database 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 Firebase

È necessario inizializzare Firebase prima che venga creato o utilizzato 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 tutti gli altri moduli Firebase utilizzati dal delegato dell'app. Ad esempio, per utilizzare Cloud Firestore e l'autenticazione:

    SwiftUI

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

    Veloce

    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()

    Veloce

    // 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 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 tuo database e specifica la posizione in cui desideri scrivere.

    Veloce

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

    Obiettivo-C

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

Prossimi passi