Agregue Firebase a su proyecto de Apple

Requisitos previos

  • Instale lo siguiente:

    • Xcode 14.1 o posterior
  • Asegúrese de que su proyecto cumpla con estos requisitos:

    • Su proyecto debe estar orientado a estas versiones de plataforma o posteriores:
      • iOS 11
      • macOS 10.13
      • tvOS 12
      • relojOS 6
  • Configure un dispositivo Apple físico o use un simulador para ejecutar su aplicación.

Si aún no tienes un proyecto de Xcode y solo quieres probar un producto de Firebase, puedes descargar uno de nuestros ejemplos de inicio rápido .

Paso 1 : crea un proyecto de Firebase

Antes de poder agregar Firebase a su aplicación Apple, debe crear un proyecto de Firebase para conectarse a su aplicación. Visita Comprender los proyectos de Firebase para obtener más información sobre los proyectos de Firebase.

Paso 2 : registra tu aplicación en Firebase

Para usar Firebase en su aplicación de Apple, debe registrar su aplicación con su proyecto de Firebase. Registrar su aplicación a menudo se denomina "agregar" su aplicación a su proyecto.

  1. Vaya a la consola de Firebase .

  2. En el centro de la página de descripción general del proyecto, haga clic en el ícono de iOS+ para iniciar el flujo de trabajo de configuración.

    Si ya agregó una aplicación a su proyecto de Firebase, haga clic en Agregar aplicación para mostrar las opciones de la plataforma.

  3. Ingrese el ID del paquete de su aplicación en el campo ID del paquete .

  4. (Opcional) Ingrese otra información de la aplicación: apodo de la aplicación y ID de la App Store .

  5. Haga clic en Registrar aplicación .

Paso 3 : agregue un archivo de configuración de Firebase

  1. Haga clic en Descargar GoogleService-Info.plist para obtener el archivo de configuración de su plataforma Firebase Apple ( GoogleService-Info.plist ).

  2. Mueva su archivo de configuración a la raíz de su proyecto Xcode. Si se le solicita, seleccione agregar el archivo de configuración a todos los destinos.

Si tienes varios ID de paquete en tu proyecto, debes asociar cada ID de paquete con una aplicación registrada en Firebase console para que cada aplicación pueda tener su propio archivo GoogleService-Info.plist .

Paso 4 : agregue los SDK de Firebase a su aplicación

Utilice Swift Package Manager para instalar y administrar las dependencias de Firebase.

  1. En Xcode, con el proyecto de su aplicación abierto, navegue hasta Archivo > Agregar paquetes .
  2. Cuando se le solicite, agregue el repositorio SDK de las plataformas Firebase Apple:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Seleccione la versión del SDK que desea utilizar.
  5. Elija las bibliotecas de Firebase que desea utilizar.

    Si Google Analytics está habilitado en su proyecto de Firebase, asegúrese de agregar FirebaseAnalytics . Para Analytics sin capacidad de recopilación de IDFA, agregue FirebaseAnalyticsWithoutAdId en su lugar.

Cuando termine, Xcode comenzará automáticamente a resolver y descargar sus dependencias en segundo plano.

Paso 5 : inicializa Firebase en tu aplicación

El último paso es agregar el código de inicialización a su aplicación. Es posible que ya hayas hecho esto como parte de agregar Firebase a tu aplicación. Si está utilizando un proyecto de muestra de inicio rápido , ya lo hemos hecho por usted.

  1. Importe el módulo FirebaseCore en su UIApplicationDelegate , así como cualquier otro módulo de Firebase que utilice el delegado de su aplicación. Por ejemplo, para usar Cloud Firestore y autenticación:

    Interfaz de usuario rápida

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Rápido

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    C objetivo

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Configure una instancia compartida FirebaseApp en el método application(_:didFinishLaunchingWithOptions:) del delegado de su aplicación:

    Interfaz de usuario rápida

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Rápido

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    C objetivo

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Si está utilizando SwiftUI, debe crear un delegado de aplicación y adjuntarlo a su estructura App mediante UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor . También debes desactivar el cambio de delegados de aplicaciones. Para obtener más información, consulte las instrucciones de SwiftUI .

    Interfaz de usuario rápida

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          
  4. Si incluyó el SDK de Firebase para Google Analytics, puede ejecutar su aplicación para enviar una verificación a la consola de Firebase de que instaló Firebase correctamente.

¡Eso es todo! Puede pasar a los siguientes pasos .

Sin embargo, si tiene problemas para realizar la configuración, visite las preguntas frecuentes y solución de problemas de las plataformas Apple .

Bibliotecas disponibles

Esta sección enumera los productos de Firebase compatibles con las plataformas Apple. Obtenga más información sobre estas bibliotecas de la plataforma Firebase Apple:

Servicio o Producto vainas Bibliotecas SwiftPM ¿Agregar análisis?
AdMob pod 'Google-Mobile-Ads-SDK' N / A
Analítica pod 'FirebaseAnalytics' FirebaseAnalytics
Verificación de aplicaciones pod 'FirebaseAppCheck' FirebaseAppCheck
Distribución de aplicaciones pod 'FirebaseAppDistribution' FirebaseAppDistribution
Autenticación pod 'FirebaseAuth' FirebaseAuth
Tienda de fuego en la nube pod 'FirebaseFirestore' FirebaseFirestore
Funciones en la nube para el SDK del cliente Firebase pod 'FirebaseFunctions' FirebaseFunctions
Mensajería en la nube pod 'FirebaseMessaging' FirebaseMessaging
Almacenamiento en la nube pod 'FirebaseStorage' FirebaseStorage
Crashlíticos pod 'FirebaseCrashlytics' FirebaseCrashlytics
Enlaces dinámicos pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
Mensajería en la aplicación pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(requerido)
Instalaciones de base de fuego pod 'FirebaseInstallations' FirebaseInstallations
API de modelo personalizado de Firebase ML pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Supervisión del rendimiento pod 'FirebasePerformance' FirebasePerformance
Base de datos en tiempo real pod 'FirebaseDatabase' FirebaseDatabase
Configuración remota pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

Integre sin usar Swift Package Manager

Si no desea utilizar Swift Package Manager, aún puede aprovechar los SDK de Firebase utilizando CocoaPods o importando los marcos directamente.

CacaoPods

Obtenga más información sobre la integración de CocoaPods en nuestra guía .

Marcos

Además de ser compatible con la plataforma iOS, el zip ahora incluye archivos .xcframework . Para obtener más información, consulte el SDK README de las plataformas Firebase Apple en GitHub .

  1. Descargue el zip del SDK del marco . Este es un archivo de ~200 MB y puede tardar algún tiempo en descargarse.

  2. Descomprima el archivo y luego integre los marcos que desea incluir en su aplicación.

    Puede encontrar instrucciones de integración en cualquiera de los siguientes lugares:

    Para obtener información sobre las versiones o dependencias del marco, consulte el archivo METADATA.md dentro de la distribución zip descargada.

  3. Agregue el indicador del vinculador -ObjC en su Other Linker Settings en la configuración de compilación de su objetivo.

Próximos pasos

Más información sobre Firebase:

Agrega servicios de Firebase a tu aplicación: