Requisitos previos
Instala Xcode 10.1 o una versión más reciente.
Instala CocoaPods 1.4.0 o una versión más reciente.
Abre tu proyecto en Xcode.
Tu proyecto debe orientarse a iOS 8 o una versión más reciente.
Los proyectos Swift deben usar la versión 3.0 o una más reciente.
Configura un dispositivo iOS físico o un simulador para ejecutar la app.
Para Cloud Messaging, necesitarás los siguientes elementos:
- 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
En todos los demás productos de Firebase, puedes usar un dispositivo iOS físico o un simulador.
Accede a Firebase con tu Cuenta de Google.
Si aún no tienes un proyecto de Xcode, puedes descargar uno de nuestros ejemplos de inicio rápido si solo quieres probar un producto de Firebase.
Paso 1: Crea un proyecto de Firebase
A fin de poder agregar Firebase a tu app para iOS, debes crear un proyecto de Firebase y conectarlo a la app. Consulta Información sobre los proyectos de Firebase para obtener detalles acerca del tema.
Paso 2: Registra tu app con Firebase
Cuando tengas un proyecto de Firebase, podrás agregarle tu app para iOS.
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.
En el centro de la página de descripción general del proyecto en Firebase console, 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.
- Para encontrar el ID del paquete, abre tu app en Xcode y accede a la pestaña General en el directorio
Runner
de nivel superior. El valor del campo Bundle Identifier (Identificador de paquete) es el ID del paquete de iOS (por ejemplo,com.yourcompany.yourproject
).
- Para encontrar el ID del paquete, abre tu app en Xcode y accede a la pestaña General en el directorio
Ingresa otra información de la app si el flujo de trabajo de configuración lo solicita (opcional).
Sobrenombre de la app: Es un identificador interno y conveniente que solo tú puedes ver en Firebase console.
ID de App Store: Firebase Dynamic Links lo usa para redireccionar a los usuarios a tu página de App Store, y Google Analytics para Firebase lo usa a fin de importar eventos de conversión a Google Ads. Si tu app aún no tiene ID de App Store, puedes agregarlo más adelante en la Configuración del proyecto.
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
).Puedes volver a descargar el archivo de configuración de Firebase para iOS cuando quieras.
Asegúrate de que no se hayan agregado caracteres adicionales, como
(2)
, al nombre del archivo de configuración.
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 con una app registrada en Firebase console a fin de 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. Si prefieres no usarlo, puedes integrar los marcos de trabajo del SDK directamente.
Ten en cuenta que, si usas una de las muestras de inicio rápido, estas ya contienen el proyecto de Xcode y el Podfile (con pods), pero, de todas formas, debes agregar tu archivo de configuración de Firebase y, luego, instalar los pods.
Puedes agregar cualquiera de los productos de Firebase admitidos a tu app para iOS. Recomendamos que comiences con Google Analytics para Firebase.
Crea un Podfile si aún no tienes uno:
cd your-project-directory
pod init
En tu Podfile, agrega los pods que deseas usar en tu app. Por ejemplo, para Analytics, agrega el siguiente contenido:
pod 'Firebase/Analytics'
Este pod agregará las bibliotecas necesarias a fin de comenzar a usar Firebase en tu app para iOS junto con Google Analytics para Firebase.
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 lo hayas hecho cuando agregaste Firebase a la 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];
Después de agregar el código de inicialización, ejecuta tu app para verificar con Firebase console que instalaste Firebase correctamente.
Pods disponibles
Los siguientes pods están disponibles para los distintos productos Firebase.
Producto | Pod |
---|---|
AdMob | pod 'Firebase/AdMob' |
Analytics | pod 'Firebase/Analytics' |
Authentication | pod 'Firebase/Auth' |
Cloud Firestore | pod 'Firebase/Firestore' |
SDK de cliente de Cloud Functions para Firebase | pod 'Firebase/Functions' |
Cloud Messaging | pod 'Firebase/Messaging' |
Cloud Storage | pod 'Firebase/Storage' |
Crashlytics | pod 'Fabric' pod 'Crashlytics' |
Dynamic Links | pod 'Firebase/DynamicLinks' |
In-App Messaging | pod 'Firebase/InAppMessaging' |
Visualización de In-App Messaging | pod 'Firebase/InAppMessagingDisplay' |
Kit de AA: API de Vision | pod 'Firebase/MLVision' |
Kit de AA: Modelo de etiquetado de imágenes | pod 'Firebase/MLVisionLabelModel' |
Kit de AA: Modelo de escaneo de códigos de barras | pod 'Firebase/MLVisionBarcodeModel' |
Kit de AA: Modelo de reconocimiento de texto | pod 'Firebase/MLVisionTextModel' |
Kit de AA: Modelo de detección de rostro | pod 'Firebase/MLVisionFaceModel' |
Kit de AA: Modelo de detección y seguimiento de objetos | pod 'Firebase/MLVisionObjectDetection' |
Kit de AA: API de Natural Language | pod 'Firebase/MLNaturalLanguage' |
Kit de AA: Modelo de identificación de idiomas | pod 'Firebase/MLNLLanguageID' |
Kit de AA: Modelo de traducción | pod 'Firebase/MLNLTranslate' |
Kit de AA: Modelo de Respuesta inteligente | pod 'Firebase/MLNLSmartReply' |
Kit de AA: API de Custom Model | pod 'Firebase/MLModelInterpreter' |
Kit de AA: API de AutoML Vision Edge | pod 'Firebase/MLVisionAutoML' |
Performance Monitoring | pod 'Firebase/Performance' |
Realtime Database | pod 'Firebase/Database' |
Remote Config | pod 'Firebase/RemoteConfig' |
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 archivo ZIP del marco de trabajo del SDK. Se trata de un archivo de aproximadamente 1 GB, por lo que la descarga puede tardar un poco.
Descomprime el archivo y revisa el archivo
README
de los marcos de trabajo que deseas incluir en tu app.Agrega la marca del vinculador
ObjC
a la secciónOther Linker Settings
de la configuración de compilación del destino.
Pasos siguientes
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 personal con el Codelab de Firebase para iOS.
Explora el código fuente abierto en GitHub.
Prepárate para iniciar tu app:
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 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.