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 15.2 o successive.

1. Se esegui la migrazione da un progetto basato su CocoaPods, esegui pod deintegrate per rimuovere CocoaPods dal tuo progetto Xcode. .xcworkspace generato da CocoaPods dopo averlo eliminato in sicurezza. Se aggiungi Firebase a un progetto per la prima volta, questo passaggio può essere ignorato.

2. In Xcode, installa le librerie Firebase andando su 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, consigliamo di utilizzare l'ultima versione di Firebase.

5. Scegli le librerie Firebase da includere nell'app.

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

Via Package.swift

Per integrare Firebase in un pacchetto Swift tramite un manifest Package.swift, puoi: aggiungi Firebase all'array dependencies del pacchetto. Per ulteriori dettagli, vedi il Documentazione relativa a Swift Package Manager.

dependencies: [

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

],

Poi, in ogni target che dipende da un prodotto Firebase, aggiungilo alla Array dependencies del target.

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

Considerazioni specifiche del prodotto

Alcuni prodotti Firebase richiedono passaggi di integrazione aggiuntivi per funzionare in modo corretto.

Google Analytics

Google Analytics richiede l'aggiunta del flag linker -ObjC al tag impostazioni di build, se incluse in modo transitivo.

Crashlytics

Crashlytics richiede il caricamento di simboli di debug.

Puoi utilizzare una fase di creazione di uno script affinché Xcode carichi automaticamente il debug post-compilazione. Qui puoi trovare lo script di esecuzione:

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

Un'altra opzione per caricare simboli è quella di utilizzare upload-symbols lo 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 note sull'utilizzo e istruzioni aggiuntive per lo script, esegui upload-symbols senza parametri.

CocoaPods

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

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

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

   pod init

2. Al podfile, aggiungi i pod Firebase che vuoi utilizzare nell'app.

   Puoi aggiungere uno qualsiasi dei prodotti Firebase alla tua app.

   Analytics attivato

   # Add the Firebase pod for Google Analytics
   pod 'FirebaseAnalytics'
   
   # For Analytics without IDFA collection capability, use this pod instead
   # pod ‘Firebase/AnalyticsWithoutAdIdSupport’
   
   # 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ù sull'IDFA, l'identificatore pubblicità a livello di dispositivo, in Apple Privacy dell'utente e utilizzo dei dati e Trasparenza sul tracciamento delle app documentazione.

   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 Codice X:

   pod install --repo-update

   open your-project.xcworkspace

Considerazioni specifiche del prodotto

Alcuni prodotti Firebase richiedono passaggi di integrazione aggiuntivi per funzionare in modo corretto.

Crashlytics

Crashlytics richiede il caricamento di simboli di debug.

Puoi utilizzare una fase di compilazione dello script di esecuzione per Xcode per caricare automaticamente i simboli di debug post-build. Qui puoi trovare lo script di esecuzione:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Cartagine

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

Integra manualmente

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

1. Scarica il framework SDK ZIP. Questo file contiene sezioni dell'architettura per tutte le architetture di destinazione disponibili per tutti gli SDK Firebase e quindi richiedono un po' di tempo per il download.

2. Decomprimi il file, poi controlla il README per individuare i framework che vuoi includere nella tua app.

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