Agregar 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. Se asigna un ID único al proyecto de manera automática, 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 de paquete de la app cuando se te solicite. Es importante que ingreses el ID de paquete que está usando la app. Esto solo se puede configurar cuando agregas 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.

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:

• Explora las apps de muestra de Firebase.
• Obtén experiencia personal con el Codelab de Firebase para iOS.
• Explora el código abierto en GitHub.

Agrega funciones de Firebase a la app:

• Obtén estadísticas sobre el comportamiento de los usuarios con Analytics.
• Configura la autenticación de usuarios con Authentication.
• Almacena información del usuario con Realtime Database o datos BLOB con Cloud Storage.
• Envía notificaciones a los usuarios con Cloud Messaging.
• Descubre cuándo y por qué la app falla con Crashlytics.