Requisitos previos
Instala lo siguiente:
- Xcode 12.0 o versiones posteriores
- CocoaPods 1.9.0 o una versión más reciente
Asegúrate de que tu proyecto cumpla con estos requisitos:
- Tu proyecto debe orientarse a iOS 10 o una versión más reciente.
Configura un dispositivo iOS físico o usa el simulador de iOS para ejecutar tu app.
- Accede a Firebase con tu Cuenta de Google.
Si solo quieres probar un producto de Firebase, pero aún no tienes un proyecto de Xcode, puedes descargar una de estas muestras de inicio rápido.
Paso 1: Crea un proyecto de Firebase
Antes de que puedas agregar Firebase a tu app para iOS, debes crear un proyecto de Firebase y conectarlo a la app. Visita Información sobre los proyectos de Firebase para obtener más detalles sobre este tema.
Paso 2: Registra tu app con Firebase
Cuando tengas un proyecto de Firebase, podrás agregarle tu app para iOS.
Consulta la Información sobre los proyectos de Firebase a fin de obtener detalles sobre prácticas recomendadas y consideraciones que debes tener para agregar apps a un proyecto de Firebase, entre ellas cómo manejar diversas variantes de compilación.
Dirígete a Firebase console.
En el centro de la página de descripción general del proyecto, haz clic en el ícono de iOS (
) para iniciar el flujo de trabajo de configuración.Si ya agregaste una app a tu proyecto de Firebase, haz clic en Agregar app para que se muestren las opciones de la plataforma.
Ingresa el ID del paquete de la app en el campo ID del paquete de iOS.
Ingresa otra información, como el Sobrenombre de la app y el ID de App Store (opcional).
Haz clic en Registrar app.
Paso 3: Agrega un archivo de configuración de Firebase
Haz clic en Descargar GoogleService-Info.plist a fin de obtener el archivo de configuración de Firebase para iOS (
GoogleService-Info.plist
).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 destinos.
Si tienes varios ID de paquete en tu proyecto, debes asociar cada uno de ellos a una app registrada en Firebase console para que cada app tenga su propio archivo GoogleService-Info.plist
.
Paso 4: Agrega los SDK de Firebase a tu app
Te recomendamos que uses CocoaPods para instalar las bibliotecas de Firebase. Sin embargo, si prefieres no usarlo, puedes integrar directamente los frameworks del SDK o usar la versión beta de Swift Package Manager.
¿Estás usando una de las muestras de inicio rápido? El proyecto de Xcode y el Podfile (con pods) ya están presentes en las muestras, pero deberás agregar tu archivo de configuración de Firebase y, luego, instalar los pods.
Crea un Podfile si aún no tienes uno:
cd your-project-directory
pod init
En tu Podfile, agrega los pods de Firebase que deseas usar en tu app.
Puedes agregar cualquiera de los productos de Firebase compatibles a tu app para iOS.
Si Analytics está habilitado
platform :ios, ‘10.0’
# Add the Firebase pod for Google Analytics pod 'Firebase/Analytics'
# Add the pods for any other Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'Si Analytics está inhabilitado
platform :ios, ‘10.0’
# Add the pods for the Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'Instala los pods y abre el archivo
.xcworkspace
para ver el proyecto en Xcode. Puedes hacerlo con los siguientes comandos:pod install
open your-project.xcworkspace
Paso 5: 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 un proyecto de ejemplo 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étodoapplication:didFinishLaunchingWithOptions:
de tu app:Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- Si agregaste Firebase Analytics, puedes ejecutar tu app para enviar la verificación a Firebase console de que instalaste Firebase correctamente.
Listo. Puedes avanzar a los pasos siguientes.
Pods disponibles
En esta sección, se enumeran los productos de Firebase compatibles con iOS y sus Pods. Obtén más información sobre estas bibliotecas de Firebase para iOS:
Repositorio de GitHub del SDK de Firebase iOS
Servicio o producto | Pods | ¿Agregar Analytics? |
---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' |
|
Analytics | pod 'Firebase/Analytics' |
|
App Distribution | pod 'Firebase/AppDistribution' |
|
Authentication | pod 'Firebase/Auth' |
|
Cloud Firestore | pod 'Firebase/Firestore' |
|
SDK cliente de Cloud Functions para Firebase | pod 'Firebase/Functions' |
|
Cloud Messaging | pod 'Firebase/Messaging' |
|
Cloud Storage | pod 'Firebase/Storage' |
|
Firebase Crashlytics | pod 'Firebase/Crashlytics' |
|
Dynamic Links | pod 'Firebase/DynamicLinks' |
|
In‑App Messaging | pod 'Firebase/InAppMessaging' |
(obligatorio) |
API de Firebase ML Custom Model | pod 'Firebase/MLModelDownloader' |
|
Performance Monitoring | pod 'Firebase/Performance' |
|
Realtime Database | pod 'Firebase/Database' |
|
Remote Config | pod 'Firebase/RemoteConfig' |
Realiza la integración sin CocoaPods
Para sacar provecho de los SDK de Firebase sin usar CocoaPods, puedes importar los frameworks de forma directa o usar Swift Package Manager.
Frameworks
Además de ser compatible con la plataforma de iOS, el archivo ZIP ahora incluye archivos .xcframework que agregan compatibilidad con Catalyst basada en la comunidad. Para obtener más detalles, consulta el archivo README del SDK de Firebase iOS en GitHub.
Descarga el archivo ZIP del marco de trabajo del SDK. Se trata de un archivo de aproximadamente 200 MB, por lo que la descarga puede tardar un poco.
Descomprime el archivo y revisa el archivo
README
de los frameworks que quieres incluir en tu app.Agrega la marca del vinculador
ObjC
en tuOther Linker Settings
en la configuración de compilación de tu destino.
Swift Package Manager
La compatibilidad con Swift Package Manager está en versión beta. Sigue la documentación en GitHub y envía tus comentarios a la Herramienta de seguimiento de errores de GitHub.
Próximos pasos
Obtén información acerca de Firebase:
Consulta la Información sobre los proyectos de Firebase a fin de obtener detalles acerca del tema y también recomendaciones para los proyectos.
Explora las apps de muestra de Firebase.
Obtén experiencia práctica con el Codelab de Firebase iOS.
Explora el código fuente abierto en GitHub.
Prepárate para iniciar tu app:
- Configura alertas de presupuesto para tu proyecto en Google Cloud Console.
- Supervisa el panel de uso y facturación en Firebase console.
- Revisa la Lista de tareas para el lanzamiento de Firebase.
Agrega los servicios de Firebase a tu app:
Obtén estadísticas sobre el comportamiento de los usuarios con Analytics.
Configura la autenticación de usuarios con Authentication.
Almacena datos, como la información del usuario, con Cloud Firestore o Realtime Database.
Almacena archivos, como fotos y videos, con Cloud Storage.
Activa código de backend que se ejecuta en un entorno seguro con Cloud Functions.
Envía notificaciones con Cloud Messaging.
Usa Crashlytics para descubrir cómo y por qué falla la app.