Opzioni per installare Firebase nell'app Apple

Swift Package Manager

Firebase consiglia Swift Package Manager per i nuovi progetti.

Tramite Xcode

Il supporto di Swift Package Manager richiede la versione 26.2 o successive.

  1. Se esegui la migrazione da un progetto basato su CocoaPods, esegui pod deintegrate per rimuovere CocoaPods dal progetto Xcode. Il file .xcworkspace generato da CocoaPods può essere eliminato in sicurezza in un secondo momento. Se aggiungi Firebase a un progetto per la prima volta, puoi ignorare questo passaggio.

  2. In Xcode, installa le librerie Firebase andando a File > Add Packages (File > Aggiungi pacchetti).

  3. Nel prompt visualizzato, seleziona il repository GitHub di Firebase:

    https://github.com/firebase/firebase-ios-sdk.git

  4. Seleziona la versione di Firebase che vuoi utilizzare. Per i nuovi progetti, ti consigliamo di utilizzare la versione più recente di Firebase.

  5. Scegli le librerie Firebase da includere nella tua app.

Al termine, Xcode inizierà a risolvere le dipendenze dei pacchetti e a scaricarle in background.

Tramite Package.swift

Per integrare Firebase in un pacchetto Swift tramite un manifest Package.swift, puoi aggiungere Firebase all'array dependencies del pacchetto. Per maggiori dettagli, consulta la documentazione di Swift Package Manager.

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

Poi, in qualsiasi target che dipende da un prodotto Firebase, aggiungilo all' dependencies array di quel target.

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

Considerazioni specifiche per i prodotti

Alcuni prodotti Firebase richiedono passaggi di integrazione aggiuntivi per funzionare correttamente.

Google Analytics

Google Analytics richiede l'aggiunta del flag del linker -ObjC alle impostazioni di compilazione del target se incluso in modo transitivo.

Crashlytics

Crashlytics richiede il caricamento dei simboli di debug.

Puoi utilizzare una fase di compilazione dello script di esecuzione per Xcode per caricare automaticamente i simboli di debug dopo la compilazione. Trova lo script di esecuzione qui:

${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run

Un'altra opzione per caricare i simboli è utilizzare lo upload-symbols script. Inserisci lo script in una sottodirectory del file di progetto (ad esempio scripts/upload-symbols), quindi assicurati che lo script sia eseguibile:

chmod +x scripts/upload-symbols

Questo script può essere utilizzato per caricare manualmente i file dSYM. Per le note sull'utilizzo e le istruzioni aggiuntive per lo script, esegui upload-symbols senza parametri.

CocoaPods

Oltre a Swift Package Manager, Firebase supporta l'installazione con CocoaPods.

La distribuzione CocoaPods di Firebase richiede Xcode 26.2 e CocoaPods 1.12.0 o versioni successive. Ecco come installare Firebase utilizzando CocoaPods:

  1. Crea un Podfile se non ne hai già uno. Dalla radice della directory del progetto, esegui il seguente comando:

    pod init

  2. Aggiungi al Podfile i pod Firebase che vuoi utilizzare nella tua app.

    Puoi aggiungere alla tua app uno qualsiasi dei prodotti Firebase supportati.

    Analytics attivato 

    # Add the Firebase pod for Google Analytics
pod 'FirebaseAnalytics'

# For Analytics without IDFA collection capability, use this pod instead
# pod FirebaseAnalytics/Core

# Add the pods for any other Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'FirebaseAuth'
pod 'FirebaseFirestore'

    Scopri di più su IDFA, l'identificatore pubblicitario a livello di dispositivo, nella documentazione di Apple Privacy dell'utente e utilizzo dei dati e Trasparenza del monitoraggio delle app.

    Analytics non attivato 

    # Add the pods for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'FirebaseAuth'
pod 'FirebaseFirestore'

  3. Installa i pod, quindi apri il file .xcworkspace per visualizzare il progetto in Xcode:

    pod install --repo-update
     
    open your-project.xcworkspace

Considerazioni specifiche per i prodotti

Alcuni prodotti Firebase richiedono passaggi di integrazione aggiuntivi per funzionare correttamente.

Crashlytics

Crashlytics richiede il caricamento dei simboli di debug.

Puoi utilizzare una fase di compilazione dello script di esecuzione per Xcode per caricare automaticamente i simboli di debug dopo la compilazione. Trova lo script di esecuzione qui:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Carthage

Il supporto di Carthage è sperimentale. Consulta le istruzioni su GitHub per includere Firebase nella tua app tramite Carthage.

Eseguire l'integrazione manualmente

Firebase fornisce una distribuzione binaria XCFramework precompilata per gli utenti che vogliono integrare Firebase senza utilizzare un gestore delle dipendenze. Per installare Firebase:

  1. Scarica lo zip dell'SDK del framework. Questo file contiene sezioni di architettura per tutte le architetture di destinazione disponibili per tutti gli SDK Firebase e pertanto il download potrebbe richiedere del tempo.

  2. Decomprimi il file, quindi esamina il file README per i framework che vuoi includere nella tua app.

  3. Aggiungi il flag del linker -ObjC in your Other Linker Settings nelle impostazioni di compilazione del target.