Prerequisiti
Installa quanto segue:
- Xcode 15.2 o versioni successive
Assicurati che il progetto soddisfi i seguenti requisiti:
- Il progetto deve avere come target queste versioni della piattaforma o versioni successive:
- iOS 13
- macOS 10.15
- tvOS 13
- watchOS 7
- Il progetto deve avere come target queste versioni della piattaforma o versioni successive:
Configura un dispositivo Apple fisico o utilizza un simulatore per eseguire l'app.
Vuoi utilizzare Cloud Messaging?
Per Cloud Messaging sulle piattaforme Apple, ecco i prerequisiti:
- Configura un dispositivo Apple fisico.
- Ottieni una chiave di autenticazione delle notifiche push di Apple per il tuo account sviluppatore Apple.
- Attiva le notifiche push in Xcode in App > Funzionalità.
- Accedi a Firebase utilizzando il tuo Account Google.
Se non hai ancora un progetto Xcode e vuoi 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 per Apple, devi creare un progetto Firebase per connetterti all'app. Per saperne di più sui progetti Firebase, consulta Informazioni sui progetti Firebase.
Crea un progetto Firebase
-
Nella console Firebase, fai clic su Aggiungi progetto.
-
Per aggiungere risorse Firebase a un progetto Google Cloud esistente, inserisci il nome del progetto o selezionalo dal menu a discesa.
-
Per creare un nuovo progetto, inserisci il nome desiderato. Se vuoi, puoi anche modificare l'ID progetto visualizzato sotto il nome del progetto.
-
-
Se richiesto, leggi e accetta i Termini di Firebase.
-
Fai clic su Continua.
-
(Facoltativo) Configura Google Analytics per il tuo progetto, in modo da poter usufruire di un'esperienza ottimale con uno dei seguenti prodotti Firebase:
Seleziona un account Google Analytics esistente o creane uno nuovo.
Se crei un nuovo account, seleziona la località dei report Analytics, quindi accetta le impostazioni di condivisione dei dati e i termini di Google Analytics per il tuo progetto.
-
Fai clic su Crea progetto (o Aggiungi Firebase, se utilizzi un progetto Google Cloud esistente).
Firebase esegue automaticamente il provisioning delle risorse per il tuo progetto Firebase. Al termine della procedura, verrà visualizzata la pagina Panoramica del progetto Firebase nella console Firebase.
Passaggio 2: registra la tua app con Firebase
Per utilizzare Firebase nella tua app per Apple, devi registrare l'app con il tuo progetto Firebase. La registrazione dell'app è spesso chiamata "aggiunta" dell'app al progetto.
Vai alla console Firebase.
Al centro della pagina di riepilogo 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.
Inserisci l'ID gruppo della tua app nel campo ID gruppo.
Che cos'è un ID pacchetto e dove trovarlo?
Un ID gruppo identifica in modo univoco un'applicazione nell'ecosistema Apple.
Trova l'ID bundle: apri il progetto in Xcode, seleziona l'app di primo livello nel navigatore del progetto e poi la scheda Generale.
Il valore del campo Bundle Identifier è l'ID bundle (ad es.
com.yourcompany.yourproject
).Tieni presente che il valore dell'ID bundle è sensibile alle maiuscole e non può essere modificato per questa app Firebase dopo la registrazione al progetto Firebase.
(Facoltativo) Inserisci altre informazioni sull'app: Nickname dell'app e ID App Store.
Come vengono utilizzati il nickname dell'app e l'ID App Store in Firebase?
Nickname dell'app: un identificatore interno di praticità visibile solo per te nella console Firebase
ID App Store: utilizzato da Firebase Dynamic Links per indirizzare gli utenti alla tua pagina dell'App Store e da Google Analytics per importare gli eventi di conversione in Google Ads. Se la tua app non ha ancora un ID App Store, puoi aggiungerlo in un secondo momento nelle impostazioni del progetto.
Fai clic su Registra app.
Passaggio 3: aggiungi un file di configurazione di Firebase
Fai clic su Scarica GoogleService-Info.plist per ottenere il file di configurazione delle piattaforme Apple 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 scoprire di più su questo file di configurazione, consulta Informazioni sui progetti Firebase.
Puoi scaricare di nuovo il file di configurazione di Firebase in qualsiasi momento.
Assicurati che al nome del file di configurazione non vengano aggiunti caratteri aggiuntivi, come
(2)
.
Sposta il file di configurazione nella directory principale del progetto Xcode. Se richiesto, seleziona l'opzione per aggiungere il file di configurazione a tutti i target.
Se nel progetto sono presenti più ID bundle, devi associare ogni ID
bundle a un'app registrata nella console Firebase in modo che ogni app possa avere il suo
file GoogleService-Info.plist
.
Passaggio 4: aggiungi gli SDK Firebase all'app
Utilizza Swift Package Manager per installare e gestire le dipendenze di Firebase.
- In Xcode, con il progetto dell'app aperto, vai a File > Aggiungi pacchetti.
- Quando richiesto, aggiungi il repository dell'SDK delle piattaforme Apple di Firebase:
- Seleziona la versione dell'SDK da utilizzare.
Scegli le librerie Firebase da utilizzare.
Se Google Analytics è abilitato nel tuo progetto Firebase, assicurati di aggiungere
FirebaseAnalytics
. Invece, per Analytics senza la funzionalità di raccolta IDFA, aggiungiFirebaseAnalyticsWithoutAdId
.
https://github.com/firebase/firebase-ios-sdk
Al termine, Xcode inizierà automaticamente a risolvere e a 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. È possibile che tu abbia già eseguito questa operazione nell'ambito dell'aggiunta di Firebase alla tua app. Se utilizzi un progetto di esempio per la guida introduttiva, questa operazione è stata eseguita per te.
- Importa il modulo
FirebaseCore
inUIApplicationDelegate
, nonché eventuali altri moduli Firebase utilizzati dal tuo app delegate. Ad esempio, per utilizzare Cloud Firestore e Authentication:import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Configura un'istanza condivisa
FirebaseApp
nel metodoapplication(_:didFinishLaunchingWithOptions:)
del delegato dell'app:// Use Firebase library to configure APIs FirebaseApp.configure()
// Use Firebase library to configure APIs FirebaseApp.configure()
// Use Firebase library to configure APIs [FIRApp configure];
- Se utilizzi SwiftUI, devi creare un delegato dell'applicazione e collegarlo alla tua struct
App
tramiteUIApplicationDelegateAdaptor
oNSApplicationDelegateAdaptor
. Devi anche disattivare lo scambio del delegato dell'app. Per maggiori informazioni, consulta le istruzioni di SwiftUI.@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- Se hai incluso l'SDK Firebase per Google Analytics, puoi eseguire la tua app per inviare alla console Firebase la verifica dell'installazione di Firebase.
Ecco fatto. Puoi andare direttamente ai passaggi successivi.
Tuttavia, se hai problemi di configurazione, consulta le domande frequenti e la risoluzione dei problemi relativi alle piattaforme Apple.
Librerie disponibili
Questa sezione elenca i prodotti Firebase supportati per le piattaforme Apple. Scopri di più su queste librerie della piattaforma Apple di Firebase:
Repository GitHub dell'SDK delle piattaforme Apple di Firebase
Servizio o prodotto | Pod | Librerie SwiftPM | Google Analytics.">Aggiungi Analytics? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' |
N/D | |
Analytics | pod 'FirebaseAnalytics' |
FirebaseAnalytics |
|
App Check | pod 'FirebaseAppCheck' |
FirebaseAppCheck |
|
App Distribution | pod 'FirebaseAppDistribution' |
FirebaseAppDistribution |
|
Authentication | pod 'FirebaseAuth' |
FirebaseAuth |
|
Cloud Firestore | pod 'FirebaseFirestore' |
FirebaseFirestore |
|
Cloud Functions for Firebase Client SDK | pod 'FirebaseFunctions' |
FirebaseFunctions |
|
Cloud Messaging | pod 'FirebaseMessaging' |
FirebaseMessaging |
|
Cloud Storage | pod 'FirebaseStorage' |
FirebaseStorage |
|
Crashlytics | pod 'FirebaseCrashlytics' |
FirebaseCrashlytics |
|
Dynamic Links | pod 'FirebaseDynamicLinks' |
FirebaseDynamicLinks |
|
In-App Messaging | pod 'FirebaseInAppMessaging' |
FirebaseInAppMessaging |
(obbligatorio) |
Firebase installazioni | pod 'FirebaseInstallations' |
FirebaseInstallations |
|
Firebase ML API di modelli personalizzati | pod 'FirebaseMLModelDownloader' |
FirebaseMLModelDownloader |
|
Performance Monitoring | pod 'FirebasePerformance' |
FirebasePerformance |
|
Realtime Database | pod 'FirebaseDatabase' |
FirebaseDatabase |
|
Remote Config | pod 'FirebaseRemoteConfig' |
FirebaseRemoteConfig |
|
Vertex AI in Firebase | pod 'FirebaseVertexAI' |
FirebaseVertexAI |
Eseguire l'integrazione senza utilizzare Swift Package Manager
Se non vuoi utilizzare Swift Package Manager, puoi comunque sfruttare gli SDK Firebase utilizzando CocoaPods o importando direttamente i framework.
CocoaPods
Scopri di più sull'integrazione di CocoaPods nella nostra guida.
Framework
Oltre a supportare la piattaforma iOS, il file ZIP ora include i file .xcframework
. Per maggiori dettagli, consulta il file README dell'SDK Firebase per le piattaforme Apple su GitHub.
Scarica il file zip dell'SDK del framework. Si tratta di un file di circa 200 MB e il download potrebbe richiedere un po' di tempo.
Decomprimere il file e integrare i framework che vuoi includere nella tua app.
Puoi trovare le istruzioni di integrazione nei seguenti punti:
- Nel repository GitHub dell'SDK Firebase per iOS.
- Nel file
README.md
all'interno della distribuzione ZIP scaricata.
Per informazioni sulle versioni o sulle dipendenze del framework, consulta il file
METADATA.md
all'interno della distribuzione ZIP scaricata.Aggiungi il flag del linker
-ObjC
inOther Linker Settings
nelle impostazioni di compilazione del target.
Passaggi successivi
Scopri di più su Firebase:
Consulta Informazioni sui progetti Firebase per saperne di più sui progetti Firebase e sulle best practice per i progetti.
Esplora le app Firebase di esempio.
Fai un'esperienza pratica con il Codelab Firebase per iOS.
Esplora il codice open source su GitHub.
Preparati a lanciare l'app:
- Configura gli avvisi sul budget per il tuo progetto nella console Google Cloud.
- Monitora la dashboard Utilizzo e fatturazione nella console Firebase per avere un quadro complessivo dell'utilizzo del progetto su più servizi Firebase.
- Esamina l'elenco di controllo per il lancio di Firebase.
Hai problemi con Firebase e il tuo progetto Apple? Consulta le domande frequenti e la guida alla risoluzione dei problemi relativi alle piattaforme Apple.
Aggiungi i servizi Firebase alla tua app:
Ottieni informazioni sul comportamento degli utenti con Analytics.
Configura l'autenticazione utente con Authentication.
Memorizzare dati, come 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.