Agrega Firebase a tu proyecto de Apple

Requisitos previos

  • Instala lo siguiente:

    • Xcode 12.5 o una versión más reciente

  • Asegúrate de que tu proyecto cumpla con estos requisitos:

    • Debe orientarse a estas versiones de las plataformas o a otras más recientes:
      • iOS 10
      • macOS 10.12
      • 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

Cuando tengas un proyecto de Firebase, podrás agregarle tu app para Apple.

Consulta Información sobre los proyectos de Firebase a fin de obtener detalles sobre prácticas recomendadas y consideraciones que debes tener para agregar apps a un proyecto de Firebase, entre ellas cómo manejar diversas variantes de compilación.

  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 ID 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 SDK de Firebase a tu app

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

  1. Abre el proyecto de tu app y, en Xcode, navega a File > Swift Packages > Add Package Dependency.
  2. Cuando se te solicite, agrega el repositorio del SDK de Firebase para plataformas de Apple:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. Selecciona la versión del SDK que quieres usar.

  4. 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 de Firebase en UIApplicationDelegate:

    Swift

    import Firebase

    Objective-C

    @import Firebase;
  2. Configura una instancia compartida de FirebaseApp, generalmente en el método application:didFinishLaunchingWithOptions: de tu app:

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. 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 'Firebase/Analytics' FirebaseAnalytics
Verificación de aplicaciones pod 'Firebase/AppCheck' FirebaseAppCheck
App Distribution pod 'Firebase/AppDistribution' FirebaseAppDistribution
Authentication pod 'Firebase/Auth' FirebaseAuth
Cloud Firestore pod 'Firebase/Firestore' FirebaseFirestore
SDK cliente de Cloud Functions para Firebase pod 'Firebase/Functions' FirebaseFunctions
Cloud Messaging pod 'Firebase/Messaging' FirebaseMessaging
Cloud Storage pod 'Firebase/Storage' FirebaseStorage
Crashlytics pod 'Firebase/Crashlytics' FirebaseCrashlytics
Dynamic Links pod 'Firebase/DynamicLinks' FirebaseDynamicLinks
In‑App Messaging pod 'Firebase/InAppMessaging' FirebaseInAppMessaging
(obligatorio)
Instalaciones de Firebase pod 'Firebase/Installations' FirebaseInstallations
API de Firebase ML Custom Model pod 'Firebase/MLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'Firebase/Performance' FirebasePerformance
Realtime Database pod 'Firebase/Database' FirebaseDatabase
Remote Config pod 'Firebase/RemoteConfig' FirebaseRemoteConfig

Realiza la integración sin un administrador de dependencias

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

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 aproximadamente 200 MB, por lo que la descarga puede tardar un poco.

  2. Descomprime el archivo y revisa el archivo README de los frameworks que quieres incluir en tu app.

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

CocoaPods

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

Próximos pasos

Obtén información acerca de Firebase:

Agrega los servicios de Firebase a tu app: