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.
- 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.
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.
(Facoltativo) Inserisci altre informazioni sull'app: Nickname dell'app e ID App Store.
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
).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:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Configura un'istanza condivisa
FirebaseApp
nel metodoapplication(_:didFinishLaunchingWithOptions:)
del delegato dell'app:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// 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.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 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 in uno dei 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.