Agrega Firebase a tu proyecto de Apple

Requisitos previos

  • Instala lo siguiente:

    • Xcode 14.1 o una versión posterior
  • Asegúrate de que tu proyecto cumpla con estos requisitos:

    • Se debe seleccionar como objetivo a estas versiones de las plataformas o a otras más recientes:
      • iOS 11
      • macOS 10.13
      • tvOS 12
      • watchOS 6
  • Configura un dispositivo Apple físico o usa un simulador para ejecutar tu app.

Si solo quieres probar un producto de Firebase, pero aún no tienes un proyecto de Xcode, puedes descargar una de estas muestras de inicio rápido.

Paso 1: Crea un proyecto de Firebase

Antes de que puedas agregar Firebase a tu app para Apple, debes crear un proyecto de Firebase y conectarlo a ella. Visita Información sobre los proyectos de Firebase para obtener más detalles sobre este tema.

Paso 2: Registra tu app con Firebase

Si quieres usar Firebase en tu app para Apple, debes registrar la app con el proyecto de Firebase. El registro de tu app a menudo se conoce como “agregar” la app a tu proyecto.

  1. Dirígete a Firebase console.

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

    Si ya agregaste una app a tu proyecto de Firebase, haz clic en Agregar app para que se muestren las opciones de plataforma.

  3. Ingresa el ID del paquete de la app en el campo ID del paquete.

  4. Ingresa otra información, como el Sobrenombre de la app y el ID de App Store (opcional).

  5. Haz clic en Registrar app.

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

  1. Haz clic en Descargar GoogleService-Info.plist a fin de obtener el archivo de configuración de Firebase para plataformas de Apple (GoogleService-Info.plist).

  2. Traslada el archivo de configuración al directorio raíz de tu proyecto de Xcode. Si se te solicita, selecciona la opción para agregar el archivo de configuración a todos los destinos.

Si tienes varios IDs de paquete en tu proyecto, debes asociar cada uno de ellos a una app registrada en Firebase console para que cada app tenga su propio archivo GoogleService-Info.plist.

Paso 4: Agrega los SDKs de Firebase a tu app

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

  1. En Xcode, con tu proyecto de app abierto, navega a File > Add Packages.
  2. Cuando se te solicite, agrega el repositorio del SDK de Firebase para plataformas de Apple:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Selecciona la versión del SDK que quieres usar.
  5. Elige las bibliotecas de Firebase que quieres usar.

    Si Google Analytics está habilitado en tu proyecto de Firebase, asegúrate de agregar FirebaseAnalytics. Si usas Analytics sin la capacidad de recopilación de IDFA, agrega FirebaseAnalyticsWithoutAdId.

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

Paso 5: Inicializa Firebase en tu app

El paso final es agregar código de inicialización a la aplicación. Es posible que ya hayas hecho esto en el proceso de agregar Firebase a tu app. Si utilizas un proyecto de ejemplo de inicio rápido, ya está hecho.

  1. Importa el módulo FirebaseCore en tu UIApplicationDelegate, así como cualquier otro módulo de Firebase que use el delegado de la app. Por ejemplo, para usar Cloud Firestore y Authentication:

    SwiftUI

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

    Swift

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Configura una instancia compartida de FirebaseApp en el método application(_:didFinishLaunchingWithOptions:) del delegado de la app:

    SwiftUI

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

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Si usas SwiftUI, debes crear un delegado de la aplicación y adjuntarlo al struct de tu App a través de UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor. También debes inhabilitar el swizzling del delegado de la app. Para obtener más información, consulta las instrucciones de SwiftUI.

    SwiftUI

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          
  4. Si incluiste el SDK de Firebase para Google Analytics, puedes ejecutar la app a fin de enviar la verificación a Firebase console de que instalaste Firebase correctamente.

Listo. Puedes avanzar a los pasos siguientes.

Sin embargo, si tienes problemas con la configuración, visita la página de Preguntas frecuentes y solución de problemas de las plataformas de Apple.

Bibliotecas disponibles

En esta sección, se enumeran los productos de Firebase compatibles con las plataformas de Apple. Más información sobre estas bibliotecas de Firebase para plataformas de Apple:

Servicio o producto Pods Bibliotecas de SwiftPM ¿Agregar Analytics?
AdMob pod 'Google-Mobile-Ads-SDK' N/A
Analytics pod 'FirebaseAnalytics' FirebaseAnalytics
Verificación de aplicaciones pod 'FirebaseAppCheck' FirebaseAppCheck
App Distribution pod 'FirebaseAppDistribution' FirebaseAppDistribution
Authentication pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
SDK cliente de Cloud Functions para Firebase pod 'FirebaseFunctions' FirebaseFunctions
Cloud Messaging pod 'FirebaseMessaging' FirebaseMessaging
Cloud Storage pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
In‑App Messaging pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(obligatorio)
Instalaciones de Firebase pod 'FirebaseInstallations' FirebaseInstallations
APIs de Firebase ML Custom Model pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'FirebasePerformance' FirebasePerformance
Realtime Database pod 'FirebaseDatabase' FirebaseDatabase
Remote Config pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

Integra sin usar Swift Package Manager

Para sacar provecho de los SDK de Firebase sin usar Swift Package Manager, puedes usar CocoaPods o importar los frameworks directamente.

CocoaPods

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

Frameworks

Además de ser compatible con la plataforma de iOS, el archivo ZIP ahora incluye archivos .xcframework. A fin de obtener más detalles, consulta el archivo README del SDK de Firebase para plataformas de Apple en GitHub.

  1. Descarga el archivo ZIP del framework del SDK. Se trata de un archivo de aprox. 200 MB, por lo que la descarga puede tardar un poco.

  2. Descomprime el archivo y, luego, integra los frameworks que quieras incluir en la app.

    Puedes encontrar las instrucciones de integración en los siguientes lugares:

    Para obtener información sobre las versiones o dependencias del framework, consulta el archivo METADATA.md en la distribución ZIP descargada.

  3. Agrega la marca del vinculador -ObjC en tu Other Linker Settings en la configuración de compilación de tu destino.

Próximos pasos

Obtén información acerca de Firebase:

Agrega los servicios de Firebase a tu app: