Requisitos previos
Instala lo siguiente:
- Xcode 15.2 o una versión posterior
Asegúrate de que tu proyecto cumpla con estos requisitos:
- Se debe seleccionar como objetivo a estas versiones de las plataformas o a otras más recientes:
- iOS 13
- macOS 10.15
- tvOS 13
- watchOS 7
- Se debe seleccionar como objetivo a estas versiones de las plataformas o a otras más recientes:
Configura un dispositivo Apple físico o usa un simulador 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 Apple, debes crear un proyecto de Firebase y conectarlo a ella. Visita Información sobre los proyectos de Firebase para obtener más detalles sobre este tema.
Paso 2: Registra tu app con Firebase
Si quieres usar Firebase en tu app para Apple, debes registrar la app con el proyecto de Firebase. El registro de tu app a menudo se conoce como “agregar” la app a tu proyecto.
Ir 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 plataforma.
Ingresa el ID del paquete de la app en el campo ID del paquete.
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 plataformas de Apple (
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 IDs 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
Usa Swift Package Manager para instalar y administrar las dependencias de Firebase.
- En Xcode, con tu proyecto de app abierto, navega a File > Add Packages.
- Cuando se te solicite, agrega el repositorio del SDK de Firebase para plataformas de Apple:
- Selecciona la versión del SDK que quieres usar.
Elige las bibliotecas de Firebase que quieres usar.
Si Google Analytics está habilitado en tu proyecto de Firebase, asegúrate de agregar
FirebaseAnalytics
. Si usas Analytics sin la capacidad de recopilación de IDFA, agregaFirebaseAnalyticsWithoutAdId
.
https://github.com/firebase/firebase-ios-sdk
Cuando termines, Xcode comenzará a resolver y descargar automáticamente tus dependencias en segundo plano.
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
FirebaseCore
en tuUIApplicationDelegate
, así como cualquier otro módulo de Firebase que use el delegado de la app. Por ejemplo, para usar Cloud Firestore y Authentication:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Configura una instancia compartida de
FirebaseApp
en el métodoapplication(_:didFinishLaunchingWithOptions:)
del delegado de la app:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- Si usas SwiftUI, debes crear un delegado de la aplicación y adjuntarlo
al struct de tu
App
a través deUIApplicationDelegateAdaptor
oNSApplicationDelegateAdaptor
. También debes inhabilitar el swizzling del delegado de la app. Para obtener más información, consulta 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 incluiste el SDK de Firebase para Google Analytics, puedes ejecutar la app a fin de enviar la verificación a Firebase console de que instalaste Firebase correctamente.
Listo. Puedes avanzar a los pasos siguientes.
Sin embargo, si tienes problemas con la configuración, visita la página de Preguntas frecuentes y solució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. Más información sobre estas bibliotecas de Firebase para plataformas de Apple:
Repositorio de GitHub del SDK de Firebase para plataformas de Apple
Servicio o producto | Pods | Bibliotecas de SwiftPM | Google Analytics.">¿Agregar Analytics? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' |
N/A | |
Analytics | pod 'FirebaseAnalytics' |
FirebaseAnalytics |
|
App Check | pod 'FirebaseAppCheck' |
FirebaseAppCheck |
|
App Distribution | pod 'FirebaseAppDistribution' |
FirebaseAppDistribution |
|
Authentication | pod 'FirebaseAuth' |
FirebaseAuth |
|
Cloud Firestore | pod 'FirebaseFirestore' |
FirebaseFirestore |
|
Cloud Functions for Firebase Client SDK | pod 'FirebaseFunctions' |
FirebaseFunctions |
|
Cloud Messaging | pod 'FirebaseMessaging' |
FirebaseMessaging |
|
Cloud Storage | pod 'FirebaseStorage' |
FirebaseStorage |
|
Crashlytics | pod 'FirebaseCrashlytics' |
FirebaseCrashlytics |
|
Dynamic Links | pod 'FirebaseDynamicLinks' |
FirebaseDynamicLinks |
|
In-App Messaging | pod 'FirebaseInAppMessaging' |
FirebaseInAppMessaging |
(obligatorio) |
Instalaciones de Firebase | pod 'FirebaseInstallations' |
FirebaseInstallations |
|
APIs de Firebase ML Custom Model | pod 'FirebaseMLModelDownloader' |
FirebaseMLModelDownloader |
|
Performance Monitoring | pod 'FirebasePerformance' |
FirebasePerformance |
|
Realtime Database | pod 'FirebaseDatabase' |
FirebaseDatabase |
|
Remote Config | pod 'FirebaseRemoteConfig' |
FirebaseRemoteConfig |
|
Vertex AI in Firebase | N/A | FirebaseVertexAI-Preview |
Integra sin usar Swift Package Manager
Para sacar provecho de los SDK de Firebase sin usar Swift Package Manager, puedes usar CocoaPods o importar los frameworks directamente.
CocoaPods
Obtén más información sobre la integración de CocoaPods en nuestra guía.
Frameworks
Además de ser compatible con la plataforma de iOS, el archivo ZIP ahora incluye archivos
.xcframework
. A fin de obtener más detalles, consulta el archivo README del SDK de Firebase para plataformas de Apple en GitHub.
Descarga el archivo ZIP del framework del SDK. Se trata de un archivo de aprox. 200 MB, por lo que la descarga puede tardar un poco.
Descomprime el archivo y, luego, integra los frameworks que quieras incluir en la app.
Puedes encontrar las instrucciones de integración en los siguientes lugares:
- En el repositorio del SDK de Firebase iOS en GitHub
- En el archivo
README.md
dentro de la distribución ZIP descargada
Para obtener información sobre las versiones o dependencias del framework, consulta el archivo
METADATA.md
en la distribución ZIP descargada.Agrega la marca del vinculador
-ObjC
en tuOther Linker Settings
en la configuración de compilación de tu destino.
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:
- Establece alertas de presupuesto para tu proyecto en la consola de Google Cloud.
- Supervisa el panel Uso y facturación en Firebase console para obtener un panorama general del uso de tu proyecto en varios servicios de Firebase.
- Revisa la Lista de tareas para el lanzamiento de Firebase.
¿Tienes problemas con Firebase y tu proyecto de Apple? Visita la página de Preguntas frecuentes y solución de problemas para plataformas de Apple.
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 cuándo y por qué falla la app.