Agrega Firebase al proyecto de iOS

Requisitos previos

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

Xcode 9.4.1 o una versión más reciente
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:

Dirígete a Firebase console.
Haz clic en Agregar proyecto, luego selecciona o ingresa un Nombre del proyecto.
- Si hay un proyecto de Google existente asociado con tu app, selecciónalo desde el menú desplegable Nombre del proyecto.
- Si no hay un proyecto de Google existente, ingresa un nuevo Nombre del proyecto.
(Opcional) Edita el ID del proyecto.

Firebase asignará de manera automática un ID único a tu proyecto de Firebase. Este identificador se muestra en los servicios de Firebase visibles de forma pública, por ejemplo:
- URL predeterminada de Realtime Database: your-project-id.firebaseio.com
- Nombre predeterminado del depósito de Cloud Storage: your-project-id.appspot.com
- Subdominio predeterminado de Hosting: your-project-id.firebaseapp.com
Una vez que Firebase aprovisione los recursos para tu proyecto, no podrás cambiar su ID.
Por lo tanto, si quieres usar un identificador específico con tus servicios de Firebase, debes usarlo como el ID del proyecto en este paso de la configuración.
Sigue los pasos de configuración restantes y, luego, haz clic en Crear proyecto (o Agregar Firebase si usas un proyecto de Google existente).

Firebase aprovisiona los recursos para tu proyecto de forma automática. Este proceso suele tardar algunos minutos. Cuando finalice, verás la página de descripción general del proyecto en Firebase console.

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

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.
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.
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.
Nota: El archivo de configuración de Firebase asocia la aplicación con el proyecto de Firebase y sus recursos.
El contenido del archivo se considera público, incluido el ID específico de la plataforma (que ingresaste en el asistente de configuración de Firebase console) y los valores específicos de tu proyecto de Firebase, como la URL de Realtime Database y el nombre del depósito de Storage. Por ello, usa las reglas de seguridad para proteger los datos que almacenes en Realtime Database, Cloud Firestore y Storage.

En el caso de los proyectos de código abierto, por lo general, no se recomienda incluir el archivo de configuración en el control del código fuente, ya que, en la mayoría de los casos, los usuarios deben crear sus propios proyectos de Firebase y dirigir sus apps a sus backends.
Después de agregar el código de inicialización, ejecuta tu app para verificar con la consola 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.

Si aún no tienes un proyecto de Xcode, crea uno ahora.
Crea un Podfile si aún no tienes uno:
```
$ cd your-project directory
$ pod init
```
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.
Instala los pods y abre el archivo .xcworkspace para ver el proyecto en Xcode.
```
$ pod install
$ open your-project.xcworkspace
```
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.

Importa el módulo de Firebase en UIApplicationDelegate:
Swift
```
import Firebase
```
Objective-C
```
@import Firebase;
```
Configura una instancia compartida de FirebaseApp, generalmente en el método application:didFinishLaunchingWithOptions: de la 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.

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).
Descomprímelo y lee el archivo README para saber qué marcos de trabajo incluir en el proyecto.
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.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Última actualización: Marzo 22, 2019