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.
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.
Vai alla console Firebase .
Al centro della pagina della panoramica del progetto, fare 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 iOS .
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 con il tuo progetto Firebase.
(Facoltativo) Inserisci altre informazioni sull'app: nickname app e ID App Store .
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 .
Fare 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 iOS di Firebase (
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 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)
.
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 Swift Package Manager (beta) .
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.
Crea un Podfile se non ne hai già uno:
cd your-project-directory
pod init
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'
# 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'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'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.
- Importa il modulo Firebase nella tua
UIApplicationDelegate
:Swift
import Firebase
Obiettivo-C
@import Firebase;
- Configura un'istanza condivisa di
FirebaseApp
, generalmente nell'applicazione della tua appapplication:didFinishLaunchingWithOptions:
metodo:Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Obiettivo-C
// Use Firebase library to configure APIs [FIRApp configure];
- 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 .
Cialde disponibili
Questa sezione elenca i prodotti Firebase supportati per iOS e i relativi pod. Ulteriori informazioni su queste librerie Firebase iOS:
Servizio o prodotto | Pod | Aggiungere Analytics? |
---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' | |
Analytics | pod 'Firebase/Analytics' | |
Distribuzione di app | pod 'Firebase/AppDistribution' | |
Autenticazione | pod 'Firebase/Auth' | |
Cloud Firestore | pod 'Firebase/Firestore' | |
Cloud Functions per Firebase Client SDK | pod 'Firebase/Functions' | |
Messaggistica cloud | pod 'Firebase/Messaging' | |
Archiviazione nel cloud | pod 'Firebase/Storage' | |
Firebase Crashlytics | pod 'Firebase/Crashlytics' | |
Collegamenti dinamici | pod 'Firebase/DynamicLinks' | |
Messaggistica in-app | pod 'Firebase/InAppMessaging' | (necessario) |
API del modello personalizzato Firebase ML | pod 'Firebase/MLModelDownloader' | |
Monitoraggio delle prestazioni | pod 'Firebase/Performance' | |
Database in tempo reale | pod 'Firebase/Database' | |
Remote Config | pod 'Firebase/RemoteConfig' |
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 .
Scarica lo zip del framework SDK . Questo è un file di ~ 200 MB e potrebbe richiedere del tempo per il download.
Decomprimere il file, quindi rivedere il
README
per i Framework che si desidera includere nella propria app.Aggiungi il
ObjC
linkerObjC
nelleOther Linker Settings
nelleOther Linker Settings
di compilazione del tuo target.
Swift Package Manager
Il supporto di Swift Package Manager è attualmente in versione beta. Segui la documentazione su GitHub e invia eventuali commenti al tracker dei problemi di GitHub .
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.
- Consulta l' elenco di controllo per il lancio di Firebase .
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 .