Gestore di pacchetti Swift
A partire dalla v8.0.0 di Firebase Apple SDK, il supporto per Swift Package Manager di Firebase è fuori dalla versione beta ed è generalmente disponibile per l'uso. CocoaPods non è richiesto per gli utenti di Swift Package Manager.
Per Firebase versioni 8 e successive, Swift Package Manager è il metodo di installazione consigliato.
Tramite Xcode
Il supporto di Swift Package Manager richiede 13.3.1 o versioni successive.
Se stai migrando da un progetto basato su CocoaPods, esegui
pod deintegrate
per rimuovere CocoaPods dal tuo progetto Xcode. Il file.xcworkspace
generato da CocoaPods può essere eliminato in modo sicuro in seguito. Se stai aggiungendo Firebase a un progetto per la prima volta, questo passaggio può essere ignorato.In Xcode, installa le librerie Firebase andando su File > Aggiungi pacchetti
Nel prompt che appare, seleziona il repository GitHub di Firebase:
https://github.com/firebase/firebase-ios-sdk.git
Seleziona la versione di Firebase che desideri utilizzare. Per i nuovi progetti, consigliamo di utilizzare la versione più recente di Firebase.
Scegli le librerie Firebase che desideri includere nella tua app.
Una volta terminato, Xcode inizierà a risolvere le dipendenze del pacchetto 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 delle dependencies
del tuo 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"),
// ...
],
Quindi in qualsiasi destinazione che dipende da un prodotto Firebase, aggiungilo all'array delle dependencies
di tale destinazione.
.target(
name: "MyTargetName",
dependencies: [
.product(name: "FirebaseAuth", package: "Firebase"),
// ...
]
),
Considerazioni specifiche sul prodotto
Alcuni prodotti Firebase richiedono passaggi di integrazione aggiuntivi per funzionare correttamente.
statistiche di Google
Google Analytics richiede l'aggiunta del flag del linker -ObjC
alle impostazioni di build del tuo target se incluso in modo transitivo.
Crashlytics
Crashlytics richiede il caricamento di simboli di debug.
È possibile 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 consiste nell'usare lo script upload-symbols
. Posiziona 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, eseguire upload-symbols
senza alcun parametro.
Cialde Di Cacao
Firebase supporta l'installazione con CocoaPods oltre a Swift Package Manager.
La distribuzione CocoaPods di Firebase richiede Xcode 13.3.1 e CocoaPods 1.10.0 o versioni successive. Ecco come installare Firebase utilizzando CocoaPods:
Crea un Podfile se non ne hai già uno. Dalla radice della directory del tuo progetto, esegui il comando seguente:
pod init
Al tuo Podfile, aggiungi i pod Firebase che desideri utilizzare nella tua app.
Puoi aggiungere alla tua app uno qualsiasi dei prodotti Firebase supportati .
Analisi abilitata
# 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 pubblicitario a livello di dispositivo, nella documentazione sulla privacy degli utenti e sull'utilizzo dei dati e sulla trasparenza del monitoraggio delle app di Apple.
Analisi non abilitate
# 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'
Installa i pod, quindi apri il tuo file
.xcworkspace
per vedere il progetto in Xcode:pod install --repo-update
open your-project.xcworkspace
Considerazioni specifiche sul prodotto
Alcuni prodotti Firebase richiedono passaggi di integrazione aggiuntivi per funzionare correttamente.
Crashlytics
Crashlytics richiede il caricamento di simboli di debug.
È possibile 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"
Cartagine
Il supporto di Cartagine è sperimentale. Consulta le istruzioni su GitHub per includere Firebase nella tua app tramite Carthage.
Integra manualmente
Firebase fornisce una distribuzione binaria XCFramework pre-costruita per gli utenti che desiderano integrare Firebase senza utilizzare un gestore delle dipendenze. Per installare Firebase:
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 il download potrebbe richiedere del tempo.
Decomprimi il file, quindi rivedi il
README
per i framework che desideri includere nella tua app.Aggiungi il flag del linker
-ObjC
inOther Linker Settings
di build del tuo target.