Aggiungi Firebase al tuo progetto Apple

Prerequisiti

  • Installa quanto segue:

    • Xcode 26.2 o versioni successive

  • Assicurati che il tuo progetto soddisfi questi requisiti:

    • Il tuo progetto deve avere come target queste versioni della piattaforma o versioni successive:
      • iOS 15
      • macOS 11
      • tvOS 15
      • watchOS 8

  • 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 Apple, devi creare un progetto Firebase da connettere alla tua app. Consulta Informazioni sui progetti Firebase per scoprire di più sui progetti Firebase.

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 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 di Firebase (GoogleService-Info.plist) della tua app.

  2. Sposta il file di configurazione nella directory root del progetto Xcode. Se richiesto, seleziona l'opzione per aggiungere il file di configurazione a tutte le destinazioni.

Se nel progetto sono presenti più ID pacchetto, devi associare ogni ID pacchetto 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à. Per saperne di più, consulta le domande frequenti sull'ultima organizzazione dei moduli nell'SDK Google Analytics per Firebase.

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. Potresti averlo già fatto durante l'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 tuo 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 tuo 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 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'avvenuta installazione di Firebase.

Ecco fatto. Puoi passare ai passaggi successivi.

Se hai problemi con la configurazione, consulta 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:

Servizio o prodotto Nome della libreria / del framework Aggiungere Analytics?
AdMob GoogleMobileAds
Firebase AI Logic 1
 FirebaseAILogic
Analytics FirebaseAnalytics
App Check FirebaseAppCheck
App Distribution FirebaseAppDistribution
Authentication FirebaseAuth
Cloud Firestore FirebaseFirestore
Cloud Functions for Firebase Client SDK FirebaseFunctions
Cloud Messaging FirebaseMessaging
Cloud Storage FirebaseStorage
Crashlytics FirebaseCrashlytics
In-App Messaging FirebaseInAppMessaging (obbligatorio)
Firebase installazioni FirebaseInstallations
Performance Monitoring FirebasePerformance
Realtime Database FirebaseDatabase
Remote Config FirebaseRemoteConfig
SQL Connect 2 FirebaseDataConnect
LIBRERIE DEPRECATE O NON SUPPORTATE
Dynamic Links FirebaseDynamicLinks
API dei modelli personalizzati Firebase ML FirebaseMLModelDownloader

1 Firebase AI Logic (FirebaseAILogic) in precedenza si chiamava "Vertex AI in Firebase" ed era distribuito nel modulo FirebaseVertexAI. Firebase AI Logic era anche distribuito in precedenza con il modulo FirebaseAI.

2 Firebase SQL Connect era precedentemente chiamato "Firebase Data Connect".

Esegui l'integrazione senza utilizzare Swift Package Manager

Se non vuoi utilizzare Swift Package Manager, puoi comunque integrare Firebase importando direttamente i framework precompilati.

Framework

Oltre a supportare la piattaforma iOS, il file ZIP ora include i file .xcframework. Per i dettagli, consulta il file README dell'SDK delle piattaforme Apple di Firebase 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, quindi integra i framework che vuoi includere nella tua app.

    Puoi trovare le istruzioni per l'integrazione in una delle seguenti posizioni:

    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 Flags nelle impostazioni di build del target.

Passaggi successivi

Scopri di più su Firebase:

Aggiungi i servizi Firebase alla tua app: