Catch up on highlights from Firebase at Google I/O 2023. Learn more

Installa Firebase nella tua app Apple

Gestore di pacchetti rapido

A partire dalla versione 8.0.0 di Firebase Apple SDK, il supporto di Swift Package Manager di Firebase non è più beta ed è generalmente disponibile per l'uso. CocoaPods non è richiesto per gli utenti di Swift Package Manager.

Per Firebase versione 8 e successive, Swift Package Manager è il metodo di installazione consigliato.

Tramite Xcode

Il supporto di Swift Package Manager richiede 14.1 o versioni successive.

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

  2. In Xcode, installa le librerie Firebase passando a 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 desideri utilizzare. Per i nuovi progetti, ti consigliamo di utilizzare la versione più recente di Firebase.

  5. 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, aggiungila all'array delle dependencies di quella destinazione.

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

Considerazioni specifiche del prodotto

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

statistiche di Google

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

Crashlytics

Crashlytics richiede di caricare i 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 tuo 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, 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 14.1 e CocoaPods 1.10.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 tuo progetto, esegui il seguente comando:

    pod init
  2. Al tuo Podfile, aggiungi i pod Firebase che desideri utilizzare nella tua app.

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

    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ù su IDFA, l'identificatore pubblicitario a livello di dispositivo, nella documentazione sulla privacy degli utenti e sull'utilizzo dei dati e sulla trasparenza delle app di Apple.

    Analisi non abilitata

    # 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 tuo file .xcworkspace per vedere il progetto in Xcode:

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

Considerazioni specifiche del prodotto

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

Crashlytics

Crashlytics richiede di caricare i 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.

Integrare manualmente

Firebase fornisce una distribuzione XCFramework binaria predefinita per gli utenti che desiderano 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 pertanto potrebbe richiedere del tempo per il download.

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

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