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.

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.

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.

  4. (Facoltativo) Immettere altre informazioni app: nick App e App Store ID.

  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 ).

  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:
  3.   https://github.com/firebase/firebase-ios-sdk
      
  4. Seleziona la versione dell'SDK che desideri utilizzare.
  5. 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:

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:

Aggiungi i servizi Firebase alla tua app: