Aggiungi Firebase al tuo progetto Apple

Prerequisiti

  • Installa quanto segue:

    • Xcode 14.1 o successivo
  • Assicurati che il tuo progetto soddisfi questi requisiti:

    • Il tuo progetto deve avere come target queste versioni della piattaforma o successive:
      • iOS11
      • macOS 10.13
      • tvOS 12
      • watchOS 6
  • Configura un dispositivo Apple fisico o utilizza un simulatore per eseguire la tua app.

Se non disponi già di un progetto Xcode e desideri semplicemente provare un prodotto Firebase, puoi scaricare uno dei nostri esempi di avvio rapido .

Passaggio 1 : crea un progetto Firebase

Prima di poter aggiungere Firebase alla tua app Apple, devi creare un progetto Firebase per connetterti alla tua app. Visita Comprendere i progetti Firebase per ulteriori informazioni sui progetti Firebase.

Passaggio 2 : registra la tua app con Firebase

Per utilizzare Firebase nella tua app Apple, devi registrare la tua app con il tuo progetto Firebase. La registrazione della tua app viene spesso chiamata "aggiunta" della tua app al tuo progetto.

  1. Vai alla console Firebase .

  2. Al centro della pagina di panoramica del progetto, fai clic sull'icona iOS+ per avviare il flusso di lavoro di configurazione.

    Se hai già aggiunto un'app al tuo progetto Firebase, fai clic su Aggiungi app per visualizzare le opzioni della piattaforma.

  3. Inserisci l'ID pacchetto della tua app nel campo ID pacchetto .

  4. (Facoltativo) Inserisci altre informazioni sull'app: nickname dell'app e ID App Store .

  5. Fai clic su Registra app .

Passaggio 3 : aggiungi un file di configurazione Firebase

  1. Fai clic su Scarica GoogleService-Info.plist per ottenere il file di configurazione delle piattaforme Apple Firebase ( GoogleService-Info.plist ).

  2. Sposta il file di configurazione nella radice del tuo progetto Xcode. Se richiesto, seleziona per aggiungere il file di configurazione a tutte le destinazioni.

Se nel tuo progetto sono presenti più ID pacchetto, devi associare ciascun ID pacchetto a un'app registrata nella console Firebase in modo che ciascuna app possa avere il proprio file GoogleService-Info.plist .

Passaggio 4 : aggiungi gli SDK Firebase 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
  4. Seleziona la versione dell'SDK che desideri utilizzare.
  5. Scegli le librerie Firebase che desideri utilizzare.

    Se Google Analytics è abilitato nel tuo progetto Firebase, assicurati di aggiungere FirebaseAnalytics . Per Analytics senza funzionalità di raccolta IDFA, aggiungi invece FirebaseAnalyticsWithoutAdId .

Al termine, Xcode inizierà automaticamente a risolvere e scaricare le tue dipendenze in background.

Passaggio 5 : inizializza Firebase nella tua app

Il passaggio finale consiste nell'aggiungere il codice di inizializzazione all'applicazione. Potresti averlo già fatto come parte dell'aggiunta di Firebase alla tua app. Se stai utilizzando un progetto di esempio di avvio rapido , questo è stato fatto per te.

  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. Se hai incluso l'SDK Firebase per Google Analytics, puoi eseguire la tua app per inviare alla console Firebase la verifica che hai installato Firebase correttamente.

Questo è tutto! Puoi passare ai passaggi successivi .

Se riscontri problemi durante la configurazione, visita la sezione Risoluzione dei problemi e domande frequenti sulle piattaforme Apple .

Biblioteche disponibili

Questa sezione elenca i prodotti Firebase supportati per le piattaforme Apple. Ulteriori informazioni su queste librerie della piattaforma Apple Firebase:

Servizio o prodotto Baccelli Librerie SwiftPM Aggiungere Analisi?
AdMob pod 'Google-Mobile-Ads-SDK' N / A
Analitica pod 'FirebaseAnalytics' FirebaseAnalytics
Controllo dell'app pod 'FirebaseAppCheck' FirebaseAppCheck
Distribuzione dell'app pod 'FirebaseAppDistribution' FirebaseAppDistribution
Autenticazione pod 'FirebaseAuth' FirebaseAuth
Cloud Fire Store pod 'FirebaseFirestore' FirebaseFirestore
Funzioni cloud per l'SDK client Firebase pod 'FirebaseFunctions' FirebaseFunctions
Messaggistica sul cloud pod 'FirebaseMessaging' FirebaseMessaging
Archiviazione nel cloud pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Collegamenti dinamici pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
Messaggistica in-app pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(necessario)
Installazioni Firebase pod 'FirebaseInstallations' FirebaseInstallations
API del modello personalizzato Firebase ML pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Monitoraggio delle prestazioni pod 'FirebasePerformance' FirebasePerformance
Banca dati in tempo reale pod 'FirebaseDatabase' FirebaseDatabase
Configurazione remota pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

Integrazione senza utilizzare Swift Package Manager

Se non desideri utilizzare Swift Package Manager, puoi comunque sfruttare gli SDK Firebase utilizzando CocoaPods o importando direttamente i framework.

CocoaPods

Scopri di più sull'integrazione di CocoaPods nella nostra guida .

Quadri

Oltre a supportare la piattaforma iOS, lo zip ora include file .xcframework . Per i dettagli, consulta il file README dell'SDK delle piattaforme Apple Firebase su GitHub .

  1. Scarica il framework SDK zip . Si tratta di un file di circa 200 MB e il download potrebbe richiedere del tempo.

  2. Decomprimi il file e quindi integra i framework che desideri includere nella tua app.

    Puoi trovare le istruzioni per l'integrazione in uno dei seguenti posti:

    Per informazioni relative alle versioni o alle dipendenze del framework, fare riferimento al file METADATA.md all'interno della distribuzione zip scaricata.

  3. Aggiungi il flag del linker -ObjC nelle Other Linker Settings nelle impostazioni di build del tuo target.

Prossimi passi

Ulteriori informazioni su Firebase:

Aggiungi i servizi Firebase alla tua app: