Cómo agregar Firebase a tu proyecto de iOS

Requisitos previos

Antes de comenzar, debes realizar algunas configuraciones en tu entorno:

  • Xcode
    • 7.0 o una versión más reciente para Objective-C
    • 8.0 o una versión más reciente para Swift
  • Un proyecto de Xcode orientado a iOS 7 o una versión más reciente
  • Los proyectos Swift deben usar Swift 3.0 o una versión más reciente
  • El identificador del paquete de la app
  • CocoaPods 1.0.0 o una versión más reciente
  • Para Cloud Messaging:
    • un dispositivo iOS físico
    • una clave de autenticación de notificaciones push de Apple para tu cuenta de programador de Apple
    • en Xcode, habilita las notificaciones push en App > Capabilities

Si aún no tienes un proyecto de Xcode, puedes descargar uno de nuestros ejemplos de inicio rápido si solo quieres probar una función de Firebase. Si usas un inicio rápido, recuerda obtener el identificador de paquete en la configuración del proyecto, ya que lo necesitarás en el próximo paso.

Agrega Firebase a tu app

Es hora de agregar Firebase a tu app. Primero, necesitarás un proyecto y un archivo de configuración de Firebase para la app.

  1. Crea un proyecto en Firebase console si no lo hiciste antes. Si ya tienes un proyecto de Google existente asociado con tu app para dispositivos móviles, haz clic en Importar proyecto de Google. De lo contrario, haz clic en Crear proyecto nuevo.
  2. Haz clic en Agrega Firebase a tu app para iOS y sigue los pasos de configuración. Si estás importando un proyecto de Google existente, es posible que esto suceda de forma automática y solo tengas que descargar el archivo de configuración.
  3. Ingresa el ID del paquete de la app cuando se te solicite. Es importante ingresar el ID del paquete que usa tu app. Esto solo se puede configurar cuando agregas una app a tu proyecto de Firebase.
  4. Para finalizar el proceso, descargarás un archivo GoogleService-Info.plist. Puedes volver a descargar este archivo en cualquier momento.
  5. Si aún no lo hiciste, copia esto en la raíz de tu proyecto de Xcode.

Agrega el SDK

Si estás configurando un proyecto nuevo, debes instalar el SDK. Es posible que ya hayas hecho esto como parte de la creación de un proyecto de Firebase.

Te recomendamos que uses CocoaPods para instalar las bibliotecas. Para instalar CocoaPods, sigue las instrucciones de instalación. Si prefieres no usar CocoaPods, puedes seguir las instrucciones que se proporcionan a continuación para integrar los marcos de trabajo del SDK directamente.

Si vas a descargar y ejecutar una de las muestras de inicio rápido, estas ya contienen el proyecto de Xcode y el Podfile, pero de todas formas deberás instalar los pods y descargar el archivo GoogleService-Info.plist. Si quieres integrar las bibliotecas de Firebase a uno de tus proyectos, debes agregar los pods para las bibliotecas que quieras usar.

  1. Si aún no tienes un proyecto de Xcode, crea uno ahora.

  2. Crea un Podfile si aún no tienes uno:

    $ cd your-project directory
    $ pod init
    
  3. Agrega los pods que quieras instalar. Puedes incluir un Pod en tu Podfile, de la siguiente forma:

    pod 'Firebase/Core'
    
    

    Esto agregará las bibliotecas necesarias para comenzar a usar Firebase en tu app de iOS junto con Google Analytics para Firebase. A continuación, podrás encontrar una lista de las subespecificaciones y los pods que están disponibles. Esto también se aborda en las guías de configuración específicas para las funciones.

  4. Instala los pods y abre el archivo .xcworkspace para ver el proyecto en Xcode.

    $ pod install
    $ open your-project.xcworkspace
    
  5. Descarga un archivo GoogleService-Info.plist de Firebase console y agrégalo a tu app.

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 una guía de inicio rápido, esto ya está hecho.

  1. Importa el módulo de Firebase en tu subclase UIApplicationDelegate:

    Swift

    import Firebase
    

    Objective-C

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

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
    

Pods disponibles

Estos pods están disponibles para las diferentes funciones de Firebase.

Pod Servicio
pod 'Firebase/Core' Bibliotecas requeridas y Analytics
pod 'Firebase/AdMob' AdMob
pod "Firebase/Messaging" Cloud Messaging /
pod 'Firebase/Database' Realtime Database
pod 'Firebase/Invites' Invites
pod 'Firebase/DynamicLinks' Dynamic Links
pod 'Firebase/Crash' Crash Reporting
pod 'Firebase/RemoteConfig' Remote Config
pod 'Firebase/Auth' Authentication
pod 'Firebase/Storage' Storage
pod 'Firebase/Performance' Performance Monitoring

Integra sin CocoaPods

Para sacar provecho de los SDK de Firebase sin usar CocoaPods, puedes importar los marcos de trabajo en forma directa.

  1. Descarga el zip de SDK de marcos de trabajo (el archivo pesa unos 100 MB, así que podría demorar un poco).
  2. Descomprímelo y lee el archivo README para saber qué marcos de trabajo incluir en tu proyecto.
  3. Agrega la marca de vinculador ObjC en Other Linker Settings en la configuración de compilación de tu destino.

Pasos siguientes

Obtén información acerca de Firebase:

Agrega funciones de Firebase a tu app:

Enviar comentarios sobre…

¿Necesitas ayuda? Visita nuestra página de asistencia.