Aggiungi Firebase al tuo progetto Apple

Prerequisiti

• Installa quanto segue:

  • Xcode 12.5 o successivo

• Assicurati che il tuo progetto soddisfi questi requisiti:

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

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

  Vuoi utilizzare il Cloud Messaging?

  Per Cloud Messaging su piattaforme Apple, ecco i prerequisiti:

  • Configurare un dispositivo di Apple fisico.
  • Ottenere una spinta di notifica di Apple chiave di autenticazione per il vostro conto di Apple Developer .
  • Attiva notifiche push in Xcode sotto App> Funzionalità.

• Accedi al Firebase utilizzando il tuo account Google.

Se non si dispone già di un progetto Xcode e vogliono solo provare un prodotto Firebase, è possibile scaricare uno dei nostri esempi rapidi .

Passo 1: Creare un progetto Firebase

Prima di poter aggiungere Firebase alla tua app Apple, devi creare un progetto Firebase per connetterti alla tua app. Visita Capire Firebase progetti per saperne di più su progetti Firebase.

Crea un progetto Firebase

1. Nella console Firebase , scegliere Aggiungi progetto.

   • Per aggiungere le risorse Firebase ad un progetto di Google Cloud esistente, inserire il nome del progetto o selezionarlo dal menu a discesa.

   • Per creare un nuovo progetto, inserisci il nome del progetto desiderato. Puoi anche modificare facoltativamente l'ID progetto visualizzato sotto il nome del progetto.

2. Se richiesto, rivedere e accettare i termini Firebase .

3. Fare clic su Continua.

4. (Opzionale) Impostazione di Google Analytics per il progetto, che vi permette di avere un'esperienza ottimale utilizzando uno dei seguenti prodotti Firebase:

   Firebase Crashlytics Previsioni Firebase

   Messaggistica cloud Firebase Messaggistica in-app Firebase

   Configurazione remota Firebase Test A/B Firebase

   O selezionare un esistente account Google Analytics o per creare un nuovo account.

   Se si crea un nuovo account, selezionare le Analytics posizione di segnalazione , quindi accettare le impostazioni di condivisione dei dati e condizioni di Google Analytics per il vostro progetto.

5. Fare clic su Crea progetto (o Aggiungi Firebase, se si sta utilizzando un progetto Google Cloud esistente).

Firebase fornisce automaticamente le risorse per il tuo progetto Firebase. Al termine del processo, verrai indirizzato alla pagina di panoramica per il tuo progetto Firebase nella console Firebase.

Step 2: Registrare l'app con Firebase

Dopo aver creato un progetto Firebase, puoi aggiungere la tua app Apple.

Visita Capire Firebase Progetti per conoscere meglio le best practice e le considerazioni per l'aggiunta di applicazioni a un progetto Firebase, compreso il modo di gestire molteplici varianti di compilazione.

1. Vai alla console Firebase .

2. Al centro della pagina panoramica del progetto, fare clic sull'icona + iOS per lanciare il flusso di lavoro di installazione.

   Se è già stato aggiunto un app per il vostro progetto Firebase, fare clic su Aggiungi app per visualizzare le opzioni di piattaforma.

3. Inserire l'ID pacchetto della tua applicazione nel campo ID bundle.

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

   • Un ID fascio identifica in modo univoco un'applicazione in ecosistema di Apple.

   • Trova il tuo ID bundle: aprire il progetto in Xcode, selezionare l'applicazione di livello superiore nella navigazione di progetto, quindi selezionare la scheda Generale.

     Il valore del campo Bundle Identifier è l'ID pacchetto (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) Immettere altre informazioni app: nick App e App Store ID.

   Come sono il soprannome App e l'App Store ID utilizzato all'interno di Firebase?

   • App soprannome: An, identificatore interno convenienza che è visibile solo a te nella console Firebase

   • App Store ID: Utilizzato da Firebase dinamica Link per reindirizzare gli utenti alla tua pagina di App Store e da Google Analytics per eventi di conversione di importazione in Google Ads . Se l'applicazione non ha ancora un App Store ID, è possibile aggiungere l'ID successivamente nelle impostazioni di progetto .

5. Fare clic su Registra app.

Passo 3: Aggiungere un file di configurazione Firebase

1. Fare clic su Scarica GoogleService-Info.plist per ottenere le vostre piattaforme Firebase di Apple di configurazione del file ( 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, visitare Capire Firebase Progetti .

   • È possibile scaricare il file di configurazione Firebase di nuovo in qualsiasi momento.

   • Assicurarsi che il nome del file di configurazione non viene aggiunto con caratteri aggiuntivi, come (2) .

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 si dispone di più ID di bundle nel progetto, è necessario associare ogni ID fascio con un'applicazione registrato nella console Firebase in modo che ogni applicazione può avere il proprio GoogleService-Info.plist file.

Fase 4: Aggiungere Firebase SDK per la vostra applicazione

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

1. In Xcode, con il progetto applicazione aperta, passare a File> Pacchetti Swift> Aggiungi dipendenza pacchetto.
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 è attivata nel progetto Firebase, assicurarsi di aggiungere FirebaseAnalytics . Per Analytics senza la capacità di raccolta IDFA, aggiungere FirebaseAnalyticsWithoutAdId invece.

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

Fase 5: inizializzazione Firebase nella tua app

Il passaggio finale consiste nell'aggiungere il codice di inizializzazione alla tua applicazione. Potresti averlo già fatto come parte dell'aggiunta di Firebase alla tua app. Se si utilizza un progetto di esempio QuickStart , questo è stato fatto per voi.

1. Importare il modulo Firebase nella vostra UIApplicationDelegate :

   veloce

   import Firebase

   Obiettivo-C

   @import Firebase;

2. Configurare un FirebaseApp istanza condivisa, di solito in della tua app application:didFinishLaunchingWithOptions: Metodo:

   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 della corretta installazione di Firebase.

Questo è tutto! È possibile passare direttamente ai passi successivi .

Se hai problemi a ottenere istituito, però, visitare le piattaforme Apple risoluzione dei problemi e Domande frequenti .

Librerie disponibili

Questa sezione elenca i prodotti Firebase supportati per le piattaforme Apple. Ulteriori informazioni su queste librerie della piattaforma Apple Firebase:

• Documentazione di riferimento ( Swift | Obj-C )

• Le piattaforme di Apple Firebase SDK GitHub repo

Servizio o prodotto	baccelli	Librerie SwiftPM	Aggiungere analisi?
AdMob	pod 'Google-Mobile-Ads-SDK'	N / A
Analisi	pod 'Firebase/Analytics'	FirebaseAnalytics
Controllo dell'app	pod 'Firebase/AppCheck'	FirebaseAppCheck
Distribuzione dell'app	pod 'Firebase/AppDistribution'	FirebaseAppDistribution
Autenticazione	pod 'Firebase/Auth'	FirebaseAuth
Cloud Firestore	pod 'Firebase/Firestore'	FirebaseFirestore
Funzioni cloud per Firebase Client SDK	pod 'Firebase/Functions'	FirebaseFunctions
Messaggistica cloud	pod 'Firebase/Messaging'	FirebaseMessaging
Archiviazione cloud	pod 'Firebase/Storage'	FirebaseStorage
Crashlytics	pod 'Firebase/Crashlytics'	FirebaseCrashlytics
Collegamenti dinamici	pod 'Firebase/DynamicLinks'	FirebaseDynamicLinks
Messaggistica in-app	pod 'Firebase/InAppMessaging'	FirebaseInAppMessaging	(necessario)
Installazioni Firebase	pod 'Firebase/Installations'	FirebaseInstallations
API modello personalizzato Firebase ML	pod 'Firebase/MLModelDownloader'	FirebaseMLModelDownloader
Monitoraggio delle prestazioni	pod 'Firebase/Performance'	FirebasePerformance
Database in tempo reale	pod 'Firebase/Database'	FirebaseDatabase
Configurazione remota	pod 'Firebase/RemoteConfig'	FirebaseRemoteConfig

Integra senza un gestore delle dipendenze

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

Quadri

Oltre a supportare la piattaforma iOS, la zip ora include .xcframework file. Per dettagli, vedere le piattaforme di Apple Firebase SDK README su GitHub .

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

2. Decomprimere il file, quindi esaminare il README per i quadri che si desidera includere nella vostra app.

3. Aggiungere il -ObjC bandiera linker nei vostri Other Linker Settings in impostazioni di generazione del bersaglio.

baccelli di cacao

Scopri di più su integrazione CocoaPods nella nostra guida .

Prossimi passi

Informazioni su Firebase:

• Visita Capire Firebase Progetti per imparare di più su progetti Firebase e le migliori pratiche per i progetti.

• Esplora campione applicazioni Firebase .

• Get hands-on esperienza con il Firebase iOS Codelab .

• Esplora il codice open source in GitHub .

• Preparati a lanciare la tua app:

  • Impostare avvisi di bilancio per il vostro progetto nel Cloud Console di Google.
  • Monitorare l' utilizzo e fatturazione cruscotto nella console Firebase per ottenere un quadro generale di utilizzo del progetto su più servizi Firebase.
  • Rivedere il lancio lista di controllo Firebase .

• Hai problemi con Firebase e il tuo progetto Apple? Visitate le piattaforme Apple risoluzione dei problemi e Domande frequenti .

Aggiungi i servizi Firebase alla tua app:

• Acquisire conoscenze sul comportamento degli utenti con Analytics .

• Impostare l'autenticazione utente con autenticazione .

• Memorizzare i dati, come le informazioni dell'utente, con Nuvola Firestore o in tempo reale del database .

• Memorizzare i file, come foto e video, con Cloud Storage .

• Trigger backend codice che viene eseguito in un ambiente sicuro con funzioni cloud .

• Invia notifiche con Cloud Messaging .

• Scopri quando e perché la vostra applicazione si blocca con Crashlytics .