Prerequisiti
Installa quanto segue:
- Xcode 14.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
- Mac OS 10.13
- tv OS 12
- watch OS 6
- Il tuo progetto deve avere come target queste versioni della piattaforma o successive:
Configura un dispositivo Apple fisico o usa un simulatore per eseguire la tua app.
Per Cloud Messaging su piattaforme Apple, ecco i prerequisiti:
- Configura un dispositivo Apple fisico .
- Ottieni una chiave di autenticazione per le notifiche push Apple per il tuo account sviluppatore Apple .
- Abilita le notifiche push in Xcode in App > Capabilities .
- 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 Capire 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 viene spesso chiamata "aggiunta" della tua app al tuo progetto.
Vai alla console di Firebase .
Al centro della pagina della 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.
Inserisci l'ID bundle della tua app nel campo ID bundle .
Un ID pacchetto identifica in modo univoco un'applicazione nell'ecosistema di Apple.
Trova il tuo ID bundle: 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 Identificatore pacchetto è l'ID pacchetto (ad esempio,
com.yourcompany.yourproject
).Tieni presente che il valore dell'ID pacchetto fa distinzione tra maiuscole e minuscole e non può essere modificato per questa app Firebase dopo che è stata registrata con il tuo progetto Firebase.
(Facoltativo) Inserisci altre informazioni sull'app: nickname dell'app e ID dell'App Store .
Nickname dell'app : un identificatore di convenienza interno visibile solo a te nella console di 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 .
Fai clic su Registra app .
Passaggio 3 : aggiungi un file di configurazione Firebase
Fai clic su Scarica GoogleService-Info.plist per ottenere il file di configurazione delle piattaforme Firebase Apple (
GoogleService-Info.plist
).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 Understand Firebase Projects .
Puoi scaricare di nuovo 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)
.
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 disponi di 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
Utilizza Swift Package Manager per installare e gestire le dipendenze di Firebase.
- In Xcode, con il progetto dell'app aperto, vai a File > Add Packages .
- Quando richiesto, aggiungi il repository SDK delle piattaforme Firebase Apple:
- Seleziona la versione dell'SDK che desideri utilizzare.
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 inveceFirebaseAnalyticsWithoutAdId
.
https://github.com/firebase/firebase-ios-sdk
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.
- Importa il modulo
FirebaseCore
nel tuoUIApplicationDelegate
, così come qualsiasi altro modulo Firebase utilizzato dal delegato dell'app. Ad esempio, per utilizzare Cloud Firestore e l'autenticazione:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Rapido
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Obiettivo-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()
Rapido
// Use Firebase library to configure APIs FirebaseApp.configure()
Obiettivo-C
// Use Firebase library to configure APIs [FIRApp configure];
- Se utilizzi SwiftUI, devi creare un delegato dell'applicazione e allegarlo alla struttura
App
tramiteUIApplicationDelegateAdaptor
oNSApplicationDelegateAdaptor
. È inoltre necessario disabilitare lo scorrimento del delegato dell'app. Per ulteriori informazioni, consulta le istruzioni 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 che hai installato correttamente Firebase.
Questo è tutto! Puoi saltare ai passaggi successivi .
Se riscontri problemi con la configurazione, visita la risoluzione dei problemi e le domande frequenti sulle piattaforme Apple .
Librerie disponibili
Questa sezione elenca i prodotti Firebase supportati per le piattaforme Apple. Ulteriori informazioni su queste librerie della piattaforma Apple Firebase:
Repo GitHub SDK per piattaforme Apple Firebase
Servizio o Prodotto | Baccelli | Librerie SwiftPM | Aggiungere Analisi? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' | N / A | |
Analitica | pod 'FirebaseAnalytics' | FirebaseAnalytics | |
Controllo dell'app | pod 'FirebaseAppCheck' | FirebaseAppCheck | |
Distribuzione dell'app | pod 'FirebaseAppDistribution' | FirebaseAppDistribution | |
Autenticazione | pod 'FirebaseAuth' | FirebaseAuth | |
CloudFirestore | pod 'FirebaseFirestore' | FirebaseFirestore | |
Funzioni cloud per Firebase Client SDK | pod 'FirebaseFunctions' | FirebaseFunctions | |
Messaggi sulla nuvola | pod 'FirebaseMessaging' | FirebaseMessaging | |
Archiviazione cloud | pod 'FirebaseStorage' | FirebaseStorage | |
Crashlytics | pod 'FirebaseCrashlytics' | FirebaseCrashlytics | |
Collegamenti dinamici | pod 'FirebaseDynamicLinks' | FirebaseDynamicLinks | |
Messaggi in-app | pod 'FirebaseInAppMessaging' | FirebaseInAppMessaging | (necessario) |
Installazioni Firebase | pod 'FirebaseInstallations' | FirebaseInstallations | |
API del modello personalizzato di Firebase ML | pod 'FirebaseMLModelDownloader' | FirebaseMLModelDownloader | |
Monitoraggio delle prestazioni | pod 'FirebasePerformance' | FirebasePerformance | |
Database in tempo reale | pod 'FirebaseDatabase' | FirebaseDatabase | |
Configurazione remota | pod 'FirebaseRemoteConfig' | FirebaseRemoteConfig |
Integra senza utilizzare Swift Package Manager
Se non desideri utilizzare Swift Package Manager, puoi comunque sfruttare gli SDK di 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 include ora i file .xcframework
. Per i dettagli, consulta il file README dell'SDK dell'SDK per piattaforme Apple Firebase su GitHub .
Scarica il framework SDK zip . Questo è un file di circa 200 MB e potrebbe richiedere del tempo per il download.
Decomprimere il file e quindi integrare i framework che si desidera includere nell'app.
Puoi trovare le istruzioni per l'integrazione in una delle seguenti posizioni:
- Nel repository GitHub dell'SDK iOS di Firebase .
- Nel file
README.md
all'interno della distribuzione zip scaricata.
Per informazioni relative alle versioni o alle dipendenze del framework, fare riferimento al file
METADATA.md
all'interno della distribuzione zip scaricata.Aggiungi il flag del linker
-ObjC
nelleOther Linker Settings
nelle impostazioni di build del tuo target.
Prossimi passi
Ulteriori informazioni su Firebase:
Visita Capire i progetti Firebase per saperne di più sui progetti Firebase e sulle best practice per i progetti.
Esplora le app Firebase di esempio .
Ottieni un'esperienza pratica con Firebase iOS Codelab .
Esplora il codice open source in GitHub .
Preparati a lanciare la tua app:
- Imposta avvisi di budget per il tuo progetto in 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.
- Esamina l' elenco di controllo per il lancio 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 .
Configurare l'autenticazione utente con Authentication .
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 va in crash con Crashlytics .