Aggiungi Firebase al tuo progetto Apple

Prerequisiti

  • Installa quanto segue:

    • Xcode 15.2 o versioni successive
  • Assicurati che il progetto soddisfi i seguenti requisiti:

    • Il 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 ancora 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 per Apple, devi creare un progetto Firebase per connetterti all'app. Per saperne di più sui progetti Firebase, consulta Informazioni sui progetti Firebase.

Passaggio 2: registra la tua app con Firebase

Per utilizzare Firebase nella tua app per Apple, devi registrare l'app con il tuo progetto Firebase. La registrazione dell'app è 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 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 gruppo della tua app nel campo ID gruppo.

  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 delle piattaforme Apple Firebase (GoogleService-Info.plist).

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

Se nel 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 suo file GoogleService-Info.plist.

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

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

Al termine, Xcode inizierà automaticamente a risolvere e a 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. È possibile che tu abbia già eseguito questa operazione nell'ambito dell'aggiunta di Firebase alla tua app. Se utilizzi un progetto di esempio per la guida introduttiva, questa operazione è stata eseguita per te.

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

Ecco fatto. Puoi andare direttamente ai passaggi successivi.

Tuttavia, se hai problemi di configurazione, consulta le domande frequenti e la risoluzione dei problemi relativi alle piattaforme Apple.

Librerie disponibili

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

Servizio o prodotto Pod Librerie SwiftPM Google Analytics.">Aggiungi Analytics?
AdMob pod 'Google-Mobile-Ads-SDK' N/D
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
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
In-App Messaging pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(obbligatorio)
Firebase installazioni pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML API di modelli personalizzati pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'FirebasePerformance' FirebasePerformance
Realtime Database pod 'FirebaseDatabase' FirebaseDatabase
Remote Config pod 'FirebaseRemoteConfig' FirebaseRemoteConfig
Vertex AI in Firebase pod 'FirebaseVertexAI' FirebaseVertexAI

Eseguire l'integrazione senza utilizzare Swift Package Manager

Se non vuoi 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.

Framework

Oltre a supportare la piattaforma iOS, il file ZIP ora include i file .xcframework. Per maggiori 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. Decomprimere il file e integrare i framework che vuoi includere nella tua app.

    Puoi trovare le istruzioni di integrazione in uno dei seguenti punti:

    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 in Other Linker Settings nelle impostazioni di compilazione del target.

Passaggi successivi

Scopri di più su Firebase:

Aggiungi i servizi Firebase alla tua app: