Aggiungi Firebase al tuo progetto Apple

Prerequisiti

  • Installa quanto segue:

    • Xcode 16.2 o versioni successive

  • Assicurati che il tuo progetto soddisfi i seguenti requisiti:

    • Il tuo progetto deve avere come target queste versioni della piattaforma o versioni successive:
      • iOS 13
      • macOS 10.15
      • tvOS 13
      • watchOS 7

  • Configura un dispositivo Apple fisico o utilizza un simulatore per eseguire l'app.

Se non hai già un progetto Xcode e vuoi solo 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 a cui connetterti. Visita la pagina Informazioni sui progetti Firebase per scoprire di più su questi progetti.

Passaggio 2: registra la tua app con Firebase

Per utilizzare Firebase nella tua app Apple, devi registrarla nel tuo progetto Firebase. La registrazione dell'app viene spesso chiamata "aggiunta" dell'app al progetto.

  1. Vai alla console Firebase.

  2. Al centro della pagina di riepilogo del progetto, fai clic sull'icona iOS+ per avviare il flusso di lavoro della 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 bundle della tua app nel campo ID bundle.

  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 di Firebase

  1. Fai clic su Scarica GoogleService-Info.plist per ottenere il file di configurazione Firebase della tua app (GoogleService-Info.plist).

  2. Sposta il file di configurazione nella root del progetto Xcode. Se richiesto, seleziona l'opzione per aggiungere il file di configurazione a tutti i target.

Se nel tuo progetto sono presenti più ID bundle, devi associare ogni ID bundle a un'app registrata nella console Firebase in modo che ogni 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 (File > Aggiungi pacchetti).
  2. Quando richiesto, aggiungi il repository dell'SDK delle piattaforme Apple di Firebase:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. Seleziona la versione dell'SDK da utilizzare.

  4. Scegli le librerie Firebase da utilizzare.

    Se Google Analytics è abilitato nel tuo progetto Firebase, assicurati di aggiungere FirebaseAnalytics. In questo modo, vengono fornite tutte le funzionalità di analisi. Puoi anche selezionare singole funzionalità. Consulta le nostre domande frequenti sull'organizzazione più recente dei moduli in Google Analytics per l'SDK Firebase.

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

Passaggio 5: inizializza Firebase nella tua app

L'ultimo passaggio consiste nell'aggiungere il codice di inizializzazione all'applicazione. Potresti averlo già fatto nell'ambito dell'aggiunta di Firebase alla tua app. Se utilizzi un progetto di esempio di avvio rapido, questa operazione è già stata eseguita.

  1. Importa il modulo FirebaseCore nel tuo 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 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 struttura App tramite UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor. Devi anche disattivare lo swizzling del delegato dell'app. Per ulteriori informazioni, consulta le istruzioni per 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 la verifica alla console Firebase che hai installato correttamente Firebase.

Ecco fatto. Puoi andare direttamente ai passaggi successivi.

Se hai difficoltà con la configurazione, visita la pagina Risoluzione dei problemi e domande frequenti sulle piattaforme Apple.

Librerie disponibili

Questa sezione elenca i prodotti Firebase supportati per le piattaforme Apple. Scopri di più su queste librerie della piattaforma Apple di Firebase:

  • Documentazione di riferimento (Swift | Obj-C)

  • Repository GitHub dell'SDK Firebase per le piattaforme Apple GitHub

Servizio o prodotto Pod Librerie SwiftPM Aggiungere Analytics?
AdMob pod 'Google-Mobile-Ads-SDK' N/D
Firebase AI Logic 1
 pod 'FirebaseAI' FirebaseAI
Analytics pod 'FirebaseAnalytics' FirebaseAnalytics
App Check pod 'FirebaseAppCheck' FirebaseAppCheck
App Distribution pod 'FirebaseAppDistribution' FirebaseAppDistribution
Authentication pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Cloud Functions for Firebase Client SDK pod 'FirebaseFunctions' FirebaseFunctions
Cloud Messaging pod 'FirebaseMessaging' FirebaseMessaging
Cloud Storage pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Data Connect N/D FirebaseDataConnect
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
In-App Messaging pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(obbligatorio)
Firebase installazioni pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML API Custom Model pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'FirebasePerformance' FirebasePerformance
Realtime Database pod 'FirebaseDatabase' FirebaseDatabase
Remote Config pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

1 Firebase AI Logic in precedenza si chiamava "Vertex AI in Firebase" con il pod pod 'FirebaseVertexAI' e la libreria SwiftPM FirebaseVertexAI.

Eseguire l'integrazione senza utilizzare Swift Package Manager

Se non vuoi utilizzare Swift Package Manager, puoi comunque usufruire degli SDK Firebase utilizzando CocoaPods o importando direttamente i framework.

CocoaPods

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

Framework

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

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

  2. Decomprimi il file e poi integra i framework che vuoi includere nella tua app.

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

    Per informazioni sulle versioni o sulle dipendenze del framework, consulta il file METADATA.md all'interno della distribuzione ZIP scaricata.

  3. Aggiungi il flag del linker -ObjC nel Other Linker Settings nelle impostazioni di build della destinazione.

Passaggi successivi

Scopri di più su Firebase:

Aggiungi i servizi Firebase alla tua app: