Agrega Firebase al proyecto de iOS

Requisitos previos

Antes de comenzar, debes configurar lo siguiente en el entorno:

  • Xcode 9.2 o una versión posterior
  • un proyecto de Xcode para iOS 8 o una versión posterior
  • los proyectos Swift deben usar la versión 3.0 o una más reciente
  • el identificador del paquete de la app
  • CocoaPods 1.4.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 desarrollador de Apple
    • en Xcode, habilita las notificaciones push en App > Capabilities

Si aún no tienes un proyecto de Xcode, puedes descargar una de nuestras muestras 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 la app

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

Para crear un proyecto de Firebase:

  1. Crea un proyecto en Firebase console si no lo hiciste anteriormente. Haz clic en Agregar proyecto. Si ya tienes un proyecto de Google asociado con la app para dispositivos móviles, selecciónalo en el menú desplegable Nombre del proyecto. De lo contrario, escribe un nombre para crear un proyecto nuevo.
  2. Opcional: Edita el ID del proyecto. De manera automática, se asigna un ID único al proyecto, que se usa públicamente en funciones visibles de Firebase, como las URL de bases de datos y tu subdominio de Firebase Hosting. Puedes cambiarlo en este momento si deseas usar un subdominio específico.
  3. Sigue los pasos de configuración restantes y haz clic en Crear proyecto (o Agregar Firebase si usas un proyecto existente) a fin de aprovisionar recursos para el proyecto. Este proceso suele tardar algunos minutos. Cuando finalice, verás la descripción general del proyecto.

Ahora que tienes un proyecto, puedes agregar la app para iOS:

  1. Haz clic en Agrega Firebase a tu app para iOS y sigue los pasos de configuración. Si importas un proyecto de Google existente, es posible que esto ocurra de forma automática y solo tengas que descargar el archivo de configuración.
  2. Ingresa el ID del paquete de la app cuando se te solicite. Es importante que ingreses el ID del paquete que usa la app. Esta configuración solo puede hacerse al agregar una app al proyecto de Firebase.
  3. Durante el proceso, descargarás un archivo GoogleService-Info.plist. Puedes volver a descargarlo en cualquier momento.
  4. Después de agregar el código de inicialización, ejecuta la app para verificar con Firebase console que instalaste Firebase correctamente.

Agrega el SDK

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

Te recomendamos que uses CocoaPods para instalar las bibliotecas. Para instalar el sistema, sigue las instrucciones. Si prefieres no usarlo, puedes integrar los marcos de trabajo del SDK directamente sin usar CocoaPods.

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 en uno de tus proyectos, debes agregar los pods para las bibliotecas que vayas a 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 el Podfile, de la siguiente forma:

    pod 'Firebase/Core'
    
    

    Esto agregará las bibliotecas necesarias para comenzar a usar Firebase en la 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 de cada característica.

  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 la app

El paso final es agregar código de inicialización a la aplicación. Es posible que ya lo hayas hecho cuando agregaste Firebase a la app. Si utilizas una muestra 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 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 características de Firebase.

Pod Servicio
pod 'Firebase/Core' Bibliotecas necesarias 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 'Fabric'
pod 'Crashlytics'
Crashlytics
pod 'Firebase/RemoteConfig' Remote Config
pod 'Firebase/Auth' Authentication
pod 'Firebase/Storage' Storage
pod 'Firebase/Performance' Performance Monitoring
pod 'Firebase/Firestore' Cloud Firestore
pod 'Firebase/Functions' SDK de cliente de Cloud Functions para Firebase
pod 'Firebase/MLVision' API de Vision del Kit de AA
pod 'Firebase/MLVisionLabelModel' Kit de AA (detección de etiquetas en el dispositivo)
pod 'Firebase/MLVisionBarcodeModel' Kit de AA (escaneo de códigos de barras en el dispositivo)
pod 'Firebase/MLVisionTextModel' Kit de AA (reconocimiento de texto en el dispositivo)
pod 'Firebase/MLVisionFaceModel' Kit de AA (detección de rostros en el dispositivo)

Integra sin CocoaPods

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

  1. Descarga el ZIP que contiene los SDK de los marcos de trabajo (el archivo pesa unos 500 MB, por lo que podría tardar un poco).
  2. Descomprímelo y lee el archivo README para saber qué marcos de trabajo incluir en el proyecto.
  3. Agrega la marca del vinculador ObjC en Other Linker Settings en la configuración de compilación del destino.

Pasos siguientes

Obtén información acerca de Firebase:

Agrega funciones de Firebase a la app:

Enviar comentarios sobre...

Si necesitas ayuda, visita nuestra página de asistencia.