Agrega Firebase a tu proyecto de iOS

Requisitos previos

Antes de comenzar, debes configurar algunos elementos en tu entorno:

• Xcode 10.1 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 momento de agregar Firebase a la app. Primero, necesitarás un proyecto y un archivo de configuración de Firebase para la app. Consulta el artículo Información sobre los proyectos de Firebase para obtener detalles sobre el tema.

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 cuando agregas la app al proyecto de Firebase.

3. Agrega el archivo de configuración de Firebase para iOS a la app, como se indica a continuación:

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

      Puedes volver a descargar el archivo de configuración de Firebase para iOS cuando quieras.

   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 objetivos.

4. Después de agregar el código de inicialización, ejecuta tu app para verificar con la consola que instalaste Firebase correctamente.

Visita Información sobre los proyectos de Firebase a fin de obtener detalles sobre las recomendaciones y consideraciones para agregar apps a un proyecto de Firebase, incluido cómo manejar diversas variantes de compilación.

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/Analytics'
   
   

   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 archivo ZIP del marco de trabajo del SDK (se trata de un archivo de 1 GB aproximadamente y puede tardar un poco).
2. Descomprímelo y lee el archivo README para saber qué marcos de trabajo incluir en tu proyecto.
3. Agrega la marca del vinculador ObjC a la sección Other Linker Settings de la configuración de compilación del destino.

Próximos pasos

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 de los usuarios 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.