requisitos previos
Instale lo siguiente:
- Xcode 13.3.1 o posterior
Asegúrate de que tu proyecto cumpla con estos requisitos:
- Su proyecto debe apuntar a estas versiones de plataforma o posteriores:
- iOS 11
- mac OS 10.13
- tvOS 12
- reloj OS 6
- Su proyecto debe apuntar a estas versiones de plataforma o posteriores:
Configure un dispositivo Apple físico o use un simulador para ejecutar su aplicación.
Para Cloud Messaging en plataformas Apple, estos son los requisitos previos:
- Configura un dispositivo Apple físico .
- Obtenga una clave de autenticación de notificación push de Apple para su cuenta de desarrollador de Apple .
- Habilite las notificaciones automáticas en Xcode en Aplicación > Capacidades .
- Inicie sesión en Firebase con su cuenta de Google.
Si aún no tiene un proyecto de Xcode y solo quiere probar un producto de Firebase, puede descargar uno de nuestros ejemplos de inicio rápido .
Paso 1 : crea un proyecto de Firebase
Antes de que pueda agregar Firebase a su aplicación de Apple, debe crear un proyecto de Firebase para conectarse a su aplicación. Visite Comprender los proyectos de Firebase para obtener más información sobre los proyectos de Firebase.
Paso 2 : Registre su aplicación con Firebase
Para usar Firebase en su aplicación de Apple, debe registrar su aplicación con su proyecto de Firebase. Registrar su aplicación a menudo se denomina "agregar" su aplicación a su proyecto.
Ve a la consola de Firebase .
En el centro de la página de descripción general del proyecto, haga clic en el icono de iOS+ para iniciar el flujo de trabajo de configuración.
Si ya agregó una aplicación a su proyecto de Firebase, haga clic en Agregar aplicación para mostrar las opciones de la plataforma.
Ingrese el ID del paquete de su aplicación en el campo ID del paquete .
Un ID de paquete identifica de forma única una aplicación en el ecosistema de Apple.
Encuentre su ID de paquete: abra su proyecto en Xcode, seleccione la aplicación de nivel superior en el navegador de proyectos, luego seleccione la pestaña General .
El valor del campo Identificador de paquete es el ID del paquete (por ejemplo,
com.yourcompany.yourproject
).Tenga en cuenta que el valor del ID del paquete distingue entre mayúsculas y minúsculas y no se puede cambiar para esta aplicación de Firebase después de que se haya registrado con su proyecto de Firebase.
(Opcional) Ingrese otra información de la aplicación: apodo de la aplicación e ID de la tienda de aplicaciones.
Apodo de la aplicación : un identificador de conveniencia interno que solo es visible para usted en la consola de Firebase
Id. de App Store : Utilizado por Firebase Dynamic Links para redirigir a los usuarios a su página de App Store y por Google Analytics para importar eventos de conversión a Google Ads . Si su aplicación aún no tiene una ID de App Store, puede agregar la ID más adelante en la configuración de su proyecto .
Haga clic en Registrar aplicación .
Paso 3 : Agregar un archivo de configuración de Firebase
Haga clic en Descargar GoogleService-Info.plist para obtener el archivo de configuración de su plataforma Firebase Apple (
GoogleService-Info.plist
).El archivo de configuración de Firebase contiene identificadores únicos, pero no secretos, para su proyecto. Para obtener más información sobre este archivo de configuración, visite Comprender los proyectos de Firebase .
Puede volver a descargar su archivo de configuración de Firebase en cualquier momento.
Asegúrese de que el nombre del archivo de configuración no tenga caracteres adicionales, como
(2)
.
Mueva su archivo de configuración a la raíz de su proyecto Xcode. Si se le solicita, seleccione agregar el archivo de configuración a todos los destinos.
Si tiene varios ID de paquete en su proyecto, debe asociar cada ID de paquete con una aplicación registrada en la consola de Firebase para que cada aplicación pueda tener su propio archivo GoogleService-Info.plist
.
Paso 4 : agregue los SDK de Firebase a su aplicación
Use Swift Package Manager para instalar y administrar las dependencias de Firebase.
- En Xcode, con su proyecto de aplicación abierto, vaya a Archivo > Agregar paquetes .
- Cuando se le solicite, agregue el repositorio del SDK de las plataformas Apple de Firebase:
- Seleccione la versión SDK que desea utilizar.
Elija las bibliotecas de Firebase que desea usar.
Si Google Analytics está habilitado en su proyecto de Firebase, asegúrese de agregar
FirebaseAnalytics
. Para Analytics sin capacidad de recopilación de IDFA, agregueFirebaseAnalyticsWithoutAdId
en su lugar.
https://github.com/firebase/firebase-ios-sdk
Cuando termine, Xcode comenzará a resolver y descargar automáticamente sus dependencias en segundo plano.
Paso 5 : Inicialice Firebase en su aplicación
El paso final es agregar el código de inicialización a su aplicación. Es posible que ya haya hecho esto como parte de la adición de Firebase a su aplicación. Si está utilizando un proyecto de muestra de inicio rápido , esto se ha hecho por usted.
- Importe el módulo
FirebaseCore
en suUIApplicationDelegate
, así como cualquier otro módulo de Firebase que use el delegado de su aplicación. Por ejemplo, para usar Cloud Firestore y autenticación:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Rápido
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
C objetivo
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Configure una instancia compartida de
FirebaseApp
en el métodoapplication(_:didFinishLaunchingWithOptions:)
del delegado de su aplicación:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Rápido
// Use Firebase library to configure APIs FirebaseApp.configure()
C objetivo
// Use Firebase library to configure APIs [FIRApp configure];
- Si usa SwiftUI, debe crear un delegado de aplicación y adjuntarlo a su estructura de
App
a travésUIApplicationDelegateAdaptor
oNSApplicationDelegateAdaptor
. También debe deshabilitar el intercambio de delegados de aplicaciones. Para obtener más información, consulte las instrucciones de SwiftUI .SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- Si ha incluido el SDK de Firebase para Google Analytics, puede ejecutar su aplicación para enviar una verificación a la consola de Firebase de que instaló Firebase correctamente.
¡Eso es! Puede pasar directamente a los siguientes pasos .
Sin embargo, si tiene problemas para configurarlo, visite la sección de Preguntas frecuentes y resolución de problemas de las plataformas de Apple .
Bibliotecas disponibles
En esta sección, se enumeran los productos de Firebase compatibles con las plataformas de Apple. Obtenga más información sobre estas bibliotecas de la plataforma Apple de Firebase:
Firebase Apple plataformas SDK GitHub repo
Servicio o Producto | vainas | Bibliotecas SwiftPM | ¿Añadir análisis? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' | N / A | |
Analítica | pod 'FirebaseAnalytics' | FirebaseAnalytics | |
Comprobación de la aplicación | pod 'FirebaseAppCheck' | FirebaseAppCheck | |
Distribución de aplicaciones | pod 'FirebaseAppDistribution' | FirebaseAppDistribution | |
Autenticación | pod 'FirebaseAuth' | FirebaseAuth | |
Tienda de fuego en la nube | pod 'FirebaseFirestore' | FirebaseFirestore | |
Cloud Functions para el SDK de cliente de Firebase | pod 'FirebaseFunctions' | FirebaseFunctions | |
Mensajería en la nube | pod 'FirebaseMessaging' | FirebaseMessaging | |
Almacenamiento en la nube | pod 'FirebaseStorage' | FirebaseStorage | |
Crashlytics | pod 'FirebaseCrashlytics' | FirebaseCrashlytics | |
Enlaces dinámicos | pod 'FirebaseDynamicLinks' | FirebaseDynamicLinks | |
Mensajería en la aplicación | pod 'FirebaseInAppMessaging' | FirebaseInAppMessaging | (requerido) |
Instalaciones de base de fuego | pod 'FirebaseInstallations' | FirebaseInstallations | |
API de modelos personalizados de Firebase ML | pod 'FirebaseMLModelDownloader' | FirebaseMLModelDownloader | |
Supervisión del rendimiento | pod 'FirebasePerformance' | FirebasePerformance | |
Base de datos en tiempo real | pod 'FirebaseDatabase' | FirebaseDatabase | |
Configuración remota | pod 'FirebaseRemoteConfig' | FirebaseRemoteConfig |
Integre sin usar Swift Package Manager
Si no quiere usar Swift Package Manager, aún puede aprovechar los SDK de Firebase usando CocoaPods o importando los marcos directamente.
CocoaPods
Obtenga más información sobre la integración de CocoaPods en nuestra guía .
Marcos
Además de admitir la plataforma iOS, el zip ahora incluye archivos .xcframework
. Para obtener más información, consulte el archivo LÉAME del SDK de las plataformas Apple de Firebase en GitHub .
Descargue el marco SDK zip . Este es un archivo de ~200 MB y puede tardar algún tiempo en descargarse.
Descomprima el archivo, luego revise el
README
para los marcos que desea incluir en su aplicación.Agregue el indicador del vinculador
-ObjC
en susOther Linker Settings
del vinculador en la configuración de compilación de su objetivo.
Próximos pasos
Más información sobre Firebase:
Visite Comprender los proyectos de Firebase para obtener más información sobre los proyectos de Firebase y las prácticas recomendadas para los proyectos.
Explora las aplicaciones de muestra de Firebase .
Obtén experiencia práctica con Firebase iOS Codelab .
Explore el código fuente abierto en GitHub .
Prepárese para lanzar su aplicación:
- Configura alertas de presupuesto para tu proyecto en Google Cloud Console.
- Supervise el panel de uso y facturación en la consola de Firebase para obtener una imagen general del uso de su proyecto en varios servicios de Firebase.
- Revise la lista de verificación de lanzamiento de Firebase .
¿Tiene problemas con Firebase y su proyecto de Apple? Visite la sección de solución de problemas y preguntas frecuentes de las plataformas de Apple .
Agregue los servicios de Firebase a su aplicación:
Obtenga información sobre el comportamiento de los usuarios con Analytics .
Configure la autenticación de usuario con Autenticación .
Almacene datos, como información del usuario, con Cloud Firestore o Realtime Database .
Almacene archivos, como fotos y videos, con Cloud Storage .
Active el código de back-end que se ejecuta en un entorno seguro con Cloud Functions .
Envía notificaciones con Cloud Messaging .
Averigüe cuándo y por qué su aplicación falla con Crashlytics .
requisitos previos
Instale lo siguiente:
- Xcode 13.3.1 o posterior
Asegúrate de que tu proyecto cumpla con estos requisitos:
- Su proyecto debe apuntar a estas versiones de plataforma o posteriores:
- iOS 11
- mac OS 10.13
- tvOS 12
- reloj OS 6
- Su proyecto debe apuntar a estas versiones de plataforma o posteriores:
Configure un dispositivo Apple físico o use un simulador para ejecutar su aplicación.
Para Cloud Messaging en plataformas Apple, estos son los requisitos previos:
- Configura un dispositivo Apple físico .
- Obtenga una clave de autenticación de notificación push de Apple para su cuenta de desarrollador de Apple .
- Habilite las notificaciones automáticas en Xcode en Aplicación > Capacidades .
- Inicie sesión en Firebase con su cuenta de Google.
Si aún no tiene un proyecto de Xcode y solo quiere probar un producto de Firebase, puede descargar uno de nuestros ejemplos de inicio rápido .
Paso 1 : crea un proyecto de Firebase
Antes de que pueda agregar Firebase a su aplicación de Apple, debe crear un proyecto de Firebase para conectarse a su aplicación. Visite Comprender los proyectos de Firebase para obtener más información sobre los proyectos de Firebase.
Paso 2 : Registre su aplicación con Firebase
Para usar Firebase en su aplicación de Apple, debe registrar su aplicación con su proyecto de Firebase. Registrar su aplicación a menudo se denomina "agregar" su aplicación a su proyecto.
Ve a la consola de Firebase .
En el centro de la página de descripción general del proyecto, haga clic en el icono de iOS+ para iniciar el flujo de trabajo de configuración.
Si ya agregó una aplicación a su proyecto de Firebase, haga clic en Agregar aplicación para mostrar las opciones de la plataforma.
Ingrese el ID del paquete de su aplicación en el campo ID del paquete .
Un ID de paquete identifica de forma única una aplicación en el ecosistema de Apple.
Encuentre su ID de paquete: abra su proyecto en Xcode, seleccione la aplicación de nivel superior en el navegador de proyectos, luego seleccione la pestaña General .
El valor del campo Identificador de paquete es el ID del paquete (por ejemplo,
com.yourcompany.yourproject
).Tenga en cuenta que el valor del ID del paquete distingue entre mayúsculas y minúsculas y no se puede cambiar para esta aplicación de Firebase después de que se haya registrado con su proyecto de Firebase.
(Opcional) Ingrese otra información de la aplicación: apodo de la aplicación e ID de la tienda de aplicaciones.
Apodo de la aplicación : un identificador de conveniencia interno que solo es visible para usted en la consola de Firebase
Id. de App Store : Utilizado por Firebase Dynamic Links para redirigir a los usuarios a su página de App Store y por Google Analytics para importar eventos de conversión a Google Ads . Si su aplicación aún no tiene una ID de App Store, puede agregar la ID más adelante en la configuración de su proyecto .
Haga clic en Registrar aplicación .
Paso 3 : Agregar un archivo de configuración de Firebase
Haga clic en Descargar GoogleService-Info.plist para obtener el archivo de configuración de su plataforma Firebase Apple (
GoogleService-Info.plist
).El archivo de configuración de Firebase contiene identificadores únicos, pero no secretos, para su proyecto. Para obtener más información sobre este archivo de configuración, visite Comprender los proyectos de Firebase .
Puede volver a descargar su archivo de configuración de Firebase en cualquier momento.
Asegúrese de que el nombre del archivo de configuración no tenga caracteres adicionales, como
(2)
.
Mueva su archivo de configuración a la raíz de su proyecto Xcode. Si se le solicita, seleccione agregar el archivo de configuración a todos los destinos.
Si tiene varios ID de paquete en su proyecto, debe asociar cada ID de paquete con una aplicación registrada en la consola de Firebase para que cada aplicación pueda tener su propio archivo GoogleService-Info.plist
.
Paso 4 : agregue los SDK de Firebase a su aplicación
Use Swift Package Manager para instalar y administrar las dependencias de Firebase.
- En Xcode, con su proyecto de aplicación abierto, vaya a Archivo > Agregar paquetes .
- Cuando se le solicite, agregue el repositorio del SDK de las plataformas Apple de Firebase:
- Seleccione la versión SDK que desea utilizar.
Elija las bibliotecas de Firebase que desea usar.
Si Google Analytics está habilitado en su proyecto de Firebase, asegúrese de agregar
FirebaseAnalytics
. Para Analytics sin capacidad de recopilación de IDFA, agregueFirebaseAnalyticsWithoutAdId
en su lugar.
https://github.com/firebase/firebase-ios-sdk
Cuando termine, Xcode comenzará a resolver y descargar automáticamente sus dependencias en segundo plano.
Paso 5 : Inicialice Firebase en su aplicación
El paso final es agregar el código de inicialización a su aplicación. Es posible que ya haya hecho esto como parte de la adición de Firebase a su aplicación. Si está utilizando un proyecto de muestra de inicio rápido , esto se ha hecho por usted.
- Importe el módulo
FirebaseCore
en suUIApplicationDelegate
, así como cualquier otro módulo de Firebase que use el delegado de su aplicación. Por ejemplo, para usar Cloud Firestore y autenticación:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Rápido
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
C objetivo
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Configure una instancia compartida de
FirebaseApp
en el métodoapplication(_:didFinishLaunchingWithOptions:)
del delegado de su aplicación:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Rápido
// Use Firebase library to configure APIs FirebaseApp.configure()
C objetivo
// Use Firebase library to configure APIs [FIRApp configure];
- Si usa SwiftUI, debe crear un delegado de aplicación y adjuntarlo a su estructura de
App
a travésUIApplicationDelegateAdaptor
oNSApplicationDelegateAdaptor
. También debe deshabilitar el intercambio de delegados de aplicaciones. Para obtener más información, consulte las instrucciones de SwiftUI .SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- Si ha incluido el SDK de Firebase para Google Analytics, puede ejecutar su aplicación para enviar una verificación a la consola de Firebase de que instaló Firebase correctamente.
¡Eso es! Puede pasar directamente a los siguientes pasos .
Sin embargo, si tiene problemas para configurarlo, visite la sección de Preguntas frecuentes y resolución de problemas de las plataformas de Apple .
Bibliotecas disponibles
En esta sección, se enumeran los productos de Firebase compatibles con las plataformas de Apple. Obtenga más información sobre estas bibliotecas de la plataforma Apple de Firebase:
Firebase Apple plataformas SDK GitHub repo
Servicio o Producto | vainas | Bibliotecas SwiftPM | ¿Añadir análisis? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' | N / A | |
Analítica | pod 'FirebaseAnalytics' | FirebaseAnalytics | |
Comprobación de la aplicación | pod 'FirebaseAppCheck' | FirebaseAppCheck | |
Distribución de aplicaciones | pod 'FirebaseAppDistribution' | FirebaseAppDistribution | |
Autenticación | pod 'FirebaseAuth' | FirebaseAuth | |
Tienda de fuego en la nube | pod 'FirebaseFirestore' | FirebaseFirestore | |
Cloud Functions para el SDK de cliente de Firebase | pod 'FirebaseFunctions' | FirebaseFunctions | |
Mensajería en la nube | pod 'FirebaseMessaging' | FirebaseMessaging | |
Almacenamiento en la nube | pod 'FirebaseStorage' | FirebaseStorage | |
Crashlytics | pod 'FirebaseCrashlytics' | FirebaseCrashlytics | |
Enlaces dinámicos | pod 'FirebaseDynamicLinks' | FirebaseDynamicLinks | |
Mensajería en la aplicación | pod 'FirebaseInAppMessaging' | FirebaseInAppMessaging | (requerido) |
Instalaciones de base de fuego | pod 'FirebaseInstallations' | FirebaseInstallations | |
API de modelos personalizados de Firebase ML | pod 'FirebaseMLModelDownloader' | FirebaseMLModelDownloader | |
Supervisión del rendimiento | pod 'FirebasePerformance' | FirebasePerformance | |
Base de datos en tiempo real | pod 'FirebaseDatabase' | FirebaseDatabase | |
Configuración remota | pod 'FirebaseRemoteConfig' | FirebaseRemoteConfig |
Integre sin usar Swift Package Manager
Si no quiere usar Swift Package Manager, aún puede aprovechar los SDK de Firebase usando CocoaPods o importando los marcos directamente.
CocoaPods
Obtenga más información sobre la integración de CocoaPods en nuestra guía .
Marcos
Además de admitir la plataforma iOS, el zip ahora incluye archivos .xcframework
. Para obtener más información, consulte el archivo LÉAME del SDK de las plataformas Apple de Firebase en GitHub .
Descargue el marco SDK zip . Este es un archivo de ~200 MB y puede tardar algún tiempo en descargarse.
Descomprima el archivo, luego revise el
README
para los marcos que desea incluir en su aplicación.Agregue el indicador del vinculador
-ObjC
en susOther Linker Settings
del vinculador en la configuración de compilación de su objetivo.
Próximos pasos
Más información sobre Firebase:
Visite Comprender los proyectos de Firebase para obtener más información sobre los proyectos de Firebase y las prácticas recomendadas para los proyectos.
Explora las aplicaciones de muestra de Firebase .
Obtén experiencia práctica con Firebase iOS Codelab .
Explore el código fuente abierto en GitHub .
Prepárese para lanzar su aplicación:
- Configura alertas de presupuesto para tu proyecto en Google Cloud Console.
- Supervise el panel de uso y facturación en la consola de Firebase para obtener una imagen general del uso de su proyecto en varios servicios de Firebase.
- Revise la lista de verificación de lanzamiento de Firebase .
¿Tiene problemas con Firebase y su proyecto de Apple? Visite la sección de solución de problemas y preguntas frecuentes de las plataformas de Apple .
Agregue los servicios de Firebase a su aplicación:
Obtenga información sobre el comportamiento de los usuarios con Analytics .
Configure la autenticación de usuario con Autenticación .
Almacene datos, como información del usuario, con Cloud Firestore o Realtime Database .
Almacene archivos, como fotos y videos, con Cloud Storage .
Active el código de back-end que se ejecuta en un entorno seguro con Cloud Functions .
Envía notificaciones con Cloud Messaging .
Averigüe cuándo y por qué su aplicación falla con Crashlytics .