Aggiungi Firebase al tuo progetto iOS

Prerequisiti

• Installa quanto segue:

  • Xcode 12.2 o successivo
  • CocoaPods 1.10.0 o versioni successive

• Assicurati che il tuo progetto soddisfi questi requisiti:

  • Il tuo progetto deve avere come target iOS 10 o versioni successive.

• Configura un dispositivo iOS fisico o usa il simulatore iOS per eseguire la tua app.

  Vuoi utilizzare Cloud Messaging?

  Per la messaggistica cloud su iOS, ecco i prerequisiti:

  • Configura un dispositivo iOS fisico .
  • Ottieni una chiave di autenticazione per le notifiche push di Apple per il tuo account sviluppatore Apple .
  • Abilita le notifiche push in Xcode in App> Funzionalità .

• Accedi a Firebase utilizzando il tuo account Google.

Se non hai già un progetto Xcode e desideri 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 iOS, devi creare un progetto Firebase per connetterti alla tua app iOS. Visita Comprendere i progetti Firebase per ulteriori informazioni sui progetti Firebase.

Passaggio 2 : registra la tua app con Firebase

Dopo aver creato un progetto Firebase, puoi aggiungervi la tua app iOS.

Visita Comprendere i progetti Firebase per saperne di più sulle best practice e considerazioni per l'aggiunta di app a un progetto Firebase, incluso come gestire più varianti di build.

1. Vai alla console Firebase .

2. Al centro della pagina della panoramica del progetto, fare clic sull'icona iOS ( plat_ios ) per avviare il flusso di lavoro di 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 bundle della tua app nel campo ID bundle iOS .

   Che cos'è un ID bundle e dove lo trovi?

   • Un ID bundle identifica in modo univoco un'applicazione nell'ecosistema Apple.

   • Trova il tuo ID bundle: apri il tuo progetto iOS in Xcode, seleziona l'app di primo livello nel navigatore del progetto, quindi seleziona la scheda Generale .

     Il valore del campo Bundle Identifier è l'ID bundle iOS (ad esempio, com.yourcompany.yourproject ).

   • Tieni presente che il valore dell'ID bundle fa distinzione tra maiuscole e minuscole e non può essere modificato per questa app Firebase per iOS dopo che è stata registrata nel tuo progetto Firebase.

4. (Facoltativo) Inserisci altre informazioni sull'app: nickname app e ID App Store .

   Come vengono utilizzati il nickname dell'app e l' ID dell'App Store in Firebase?

   • Nickname app : un identificatore di convenienza interno visibile solo a te nella console Firebase

   • ID App Store : utilizzato da Firebase Dynamic Links per reindirizzare gli utenti alla tua pagina App Store e da Google Analytics per importare eventi di conversione in Google Ads . Se la tua app non ha ancora un ID App Store, puoi aggiungere l'ID in un secondo momento nelle impostazioni del progetto .

5. Fare 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 iOS di Firebase ( GoogleService-Info.plist ).

   Cosa devi sapere su questo file di configurazione?

   • Il file di configurazione di Firebase contiene identificatori univoci ma non segreti per il tuo progetto. Per ulteriori informazioni su questo file di configurazione, visita Informazioni sui progetti Firebase .

   • Puoi scaricare nuovamente il file di configurazione di Firebase in qualsiasi momento.

   • Assicurati che il nome del file di configurazione non sia aggiunto con caratteri aggiuntivi, come (2) .

2. Sposta il tuo file di configurazione nella radice del tuo progetto Xcode. Se richiesto, selezionare per aggiungere il file di configurazione a tutte le destinazioni.

Se hai più ID bundle nel tuo progetto, devi associare ogni ID bundle 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

Consigliamo di utilizzare CocoaPods per installare le librerie Firebase. Tuttavia, se preferisci non utilizzare CocoaPods, puoi integrare direttamente i framework SDK o utilizzare invece Swift Package Manager .

Stai usando uno degli esempi di avvio rapido ? Il progetto Xcode e Podfile (con pod) sono già presenti, ma dovrai comunque aggiungere il tuo file di configurazione Firebase e installare i pod.

1. Crea un Podfile se non ne hai già uno:

   cd your-project-directory

   pod init

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

   Puoi aggiungere qualsiasi prodotto Firebase supportato alla tua app iOS.

   Analytics abilitato

   platform :ios, ‘10.0’
   
   # Add the Firebase pod for Google Analytics
   pod 'Firebase/Analytics'
   
   # 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 'Firebase/Auth'
   pod 'Firebase/Firestore'

   Scopri di più su IDFA, l'identificatore pubblicitario a livello di dispositivo, nella documentazione sulla privacy degli utenti e sull'uso dei dati e sulla trasparenza del tracciamento delle app di Apple.

   Analytics non abilitato

   platform :ios, ‘10.0’
   
   # Add the pods for the Firebase products you want to use in your app
   # For example, to use Firebase Authentication and Cloud Firestore
   pod 'Firebase/Auth'
   pod 'Firebase/Firestore'

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

   pod install

   open your-project.xcworkspace

Passaggio 5 : inizializza Firebase nella tua app

Il passaggio finale consiste nell'aggiungere il codice di inizializzazione all'applicazione. Potresti averlo già fatto come parte dell'aggiunta di Firebase alla tua app. Se stai utilizzando un progetto di esempio di avvio rapido , questo è stato fatto per te.

1. Importa il modulo Firebase nella tua UIApplicationDelegate :

   Swift

   import Firebase

   Obiettivo-C

   @import Firebase;

2. Configura un'istanza condivisa di FirebaseApp , in genere nell'applicazione della tua app application:didFinishLaunchingWithOptions: metodo:

   Swift

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Obiettivo-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. Se hai incluso Firebase Analytics, puoi eseguire la tua app per inviare la verifica alla console Firebase di aver installato correttamente Firebase.

Questo è tutto! Puoi passare direttamente ai passaggi successivi .

Se hai problemi con la configurazione, visita la risoluzione dei problemi e le domande frequenti su iOS .

Cialde disponibili

Questa sezione elenca i prodotti Firebase supportati per iOS e i relativi pod. Ulteriori informazioni su queste librerie Firebase iOS:

• Documentazione di riferimento ( Swift | Obj-C )

• Repo GitHub di Firebase iOS SDK

Integra senza CocoaPods

Se non desideri utilizzare Cocoapods, puoi comunque sfruttare gli SDK Firebase importando i framework direttamente o utilizzando Swift Package Manager.

Quadri

Oltre a supportare la piattaforma iOS, lo zip ora include file .xcframework che aggiungono il supporto Catalyst basato sulla community. Per i dettagli, consulta il README dell'SDK iOS di Firebase su GitHub .

1. Scarica lo zip del framework SDK . Questo è un file di ~ 200 MB e potrebbe richiedere del tempo per il download.

2. Decomprimere il file, quindi esaminare il README per i framework che si desidera includere nella propria app.

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

Swift Package Manager

Scopri di più sull'integrazione di Swift Package Manager nella nostra guida .

Prossimi passi

Informazioni su Firebase:

• Visita Comprendere i progetti Firebase per ulteriori informazioni sui progetti Firebase e sulle best practice per i progetti.

• Esplora le app Firebase di esempio .

• Ottieni esperienza pratica con Firebase iOS Codelab .

• Esplora il codice open source in GitHub .

• Preparati ad avviare la tua app:

  • Imposta gli avvisi di budget per il tuo progetto nella Google Cloud Console.
  • Monitora la dashboard di utilizzo e fatturazione nella console Firebase per ottenere un quadro generale dell'utilizzo del tuo progetto su più servizi Firebase.
  • Consulta l' elenco di controllo per il lancio di Firebase .

• Hai problemi con Firebase e il tuo progetto iOS? Visita la risoluzione dei problemi e le domande frequenti su iOS .

Aggiungi i servizi Firebase alla tua app:

• Ottieni informazioni dettagliate sul comportamento degli utenti con Analytics .

• Configurare l'autenticazione utente con autenticazione .

• Archivia i dati, come le informazioni sugli utenti, con Cloud Firestore o Realtime Database .

• Archivia file, come foto e video, con Cloud Storage .

• Attiva il codice di backend che viene eseguito in un ambiente sicuro con Cloud Functions .

• Invia notifiche con Cloud Messaging .

• Scopri quando e perché la tua app si arresta in modo anomalo con Crashlytics .