Aggiungi Firebase al tuo progetto Apple

Prerequisiti

• Installa quanto segue:

  • Xcode 13.3.1 o successivo

• Assicurati che il tuo progetto soddisfi questi requisiti:

  • Il tuo progetto deve avere come target queste versioni della piattaforma o successive:
    • iOS 11
    • macOS 10.13
    • tvOS 12
    • watchOS 6

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

  Vuoi utilizzare la messaggistica cloud?

  Per il Cloud Messaging su piattaforme Apple, ecco i prerequisiti:

  • Configura un dispositivo Apple fisico .
  • Ottieni una chiave di autenticazione di notifica push 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 disponi già di un progetto Xcode e desideri semplicemente 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 Apple, devi creare un progetto Firebase per connetterti alla tua app. Visita Comprendere i progetti Firebase per saperne di più sui progetti Firebase.

Passaggio 2 : registra la tua app con Firebase

Per utilizzare Firebase nella tua app Apple, devi registrare la tua app con il tuo progetto Firebase. La registrazione della tua app è spesso chiamata "aggiunta" della tua app al tuo progetto.

1. Vai alla console Firebase .

2. Al centro della pagina di panoramica del progetto, fai clic sull'icona 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 pacchetto della tua app nel campo ID pacchetto .

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

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

   • Trova il tuo bundle ID: apri il tuo progetto 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 (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 dopo che è stata registrata con il tuo progetto Firebase.

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

   Come vengono utilizzati il ​​nickname dell'app e l' ID dell'App Store all'interno di Firebase?

   • Soprannome dell'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 pagina dell'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 di Firebase

1. Fare clic su Scarica GoogleService-Info.plist per ottenere il file di configurazione delle piattaforme Firebase Apple ( 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 al nome del file di configurazione non siano aggiunti caratteri aggiuntivi, come (2) .

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

Se nel tuo progetto sono presenti più ID bundle, devi associare ciascun 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

Usa Swift Package Manager per installare e gestire le dipendenze di Firebase.

1. In Xcode, con il progetto dell'app aperto, vai su File > Aggiungi pacchetti .
2. Quando richiesto, aggiungi il repository SDK delle piattaforme Apple Firebase:

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

3. Seleziona la versione dell'SDK che desideri utilizzare.

4. Scegli le librerie Firebase che desideri utilizzare.

   Se Google Analytics è abilitato nel tuo progetto Firebase, assicurati di aggiungere FirebaseAnalytics . Per Analytics senza funzionalità di raccolta IDFA, aggiungi invece FirebaseAnalyticsWithoutAdId .

Al termine, Xcode inizierà automaticamente a risolvere e scaricare le tue dipendenze in background.

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 usando un progetto di esempio di avvio rapido, questo è stato fatto per te.

1. Importa il modulo FirebaseCore nel tuo UIApplicationDelegate , così come qualsiasi altro modulo Firebase utilizzato dal delegato dell'app. Ad esempio, per utilizzare Cloud Firestore e l'autenticazione:

   Veloce

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Obiettivo-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Configura un'istanza condivisa FirebaseApp nel metodo dell'applicazione del delegato application(_:didFinishLaunchingWithOptions:) :

   Veloce

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

   Obiettivo-C

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

3. Se hai incluso l'SDK Firebase per Google Analytics, puoi eseguire la tua app per inviare la verifica alla console Firebase che hai installato correttamente Firebase.

Questo è tutto! Puoi saltare ai passaggi successivi .

Se riscontri problemi con la configurazione, visita la sezione Risoluzione dei problemi e domande frequenti sulle piattaforme Apple .

Librerie disponibili

Questa sezione elenca i prodotti Firebase supportati per le piattaforme Apple. Scopri di più su queste librerie della piattaforma Apple Firebase:

• Documentazione di riferimento ( Swift | Obj-C )

• Repo GitHub dell'SDK delle piattaforme Apple Firebase

Integra senza utilizzare Swift Package Manager

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

Cialde Di Cacao

Scopri di più sull'integrazione di CocoaPods nella nostra guida .

Quadri

Oltre a supportare la piattaforma iOS, lo zip ora include i file .xcframework . Per i dettagli, consulta il README dell'SDK delle piattaforme Apple Firebase su GitHub .

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

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

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

Prossimi passi

Ulteriori informazioni su Firebase:

• Visita Comprendere i progetti Firebase per saperne di più sui progetti Firebase e sulle migliori pratiche per i progetti.

• Esplora app Firebase di esempio .

• Ottieni un'esperienza pratica con Firebase iOS Codelab .

• Esplora il codice open source in GitHub .

• Preparati ad avviare la tua app:

  • Imposta avvisi di budget per il tuo progetto in Google Cloud Console.
  • Monitora il dashboard di utilizzo e fatturazione nella console Firebase per avere un quadro generale dell'utilizzo del tuo progetto su più servizi Firebase.
  • Esamina l'elenco di controllo per l'avvio di Firebase .

• Hai problemi con Firebase e il tuo progetto Apple? Visita la risoluzione dei problemi e le domande frequenti sulle piattaforme Apple .

Aggiungi i servizi Firebase alla tua app:

• Ottieni informazioni dettagliate sul comportamento degli utenti con Analytics .

• Configura l'autenticazione utente con Autenticazione .

• Archivia i dati, come le informazioni sull'utente, con Cloud Firestore o Realtime Database .

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

• Attiva il codice back-end 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 .