Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Agrega Firebase a tu proyecto de iOS

Requisitos previos

  • Instala lo siguiente:

    • Xcode 12.2 o una versión más reciente
    • CocoaPods 1.10.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.

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.

  1. Dirígete a Firebase console.

  2. 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.

  3. Ingresa el ID del paquete de la app en el campo ID del paquete de iOS.

  4. Ingresa otra información, como el Sobrenombre de la app y el ID de App Store (opcional).

  5. Haz clic en Registrar app.

Paso 3: Agrega un archivo de configuración de Firebase

  1. Haz clic en Descargar GoogleService-Info.plist a fin de obtener el archivo de configuración de Firebase para iOS (GoogleService-Info.plist).

  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 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 Swift Package Manager en su lugar.

¿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.

  1. Crea un Podfile si aún no tienes uno:

    cd your-project-directory
    pod init

  2. 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'

# For Analytics without IDFA collection capability, use this pod instead
# pod ‘Firebase/AnalyticsWithoutAdIdSupport’

# 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'

    Obtén más información sobre el IDFA, el identificador de publicidad a nivel del dispositivo, en la documentación de Apple sobre el uso de datos y la privacidad de los usuarios y App Tracking Transparency.

    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'

  3. 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.

  1. Importa el módulo de Firebase en UIApplicationDelegate:

    Swift

    import Firebase

    Objective‑C

    @import Firebase;
  2. Configura una instancia compartida de FirebaseApp, generalmente en el método application:didFinishLaunchingWithOptions: de tu app:

    Swift

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Objective‑C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. 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.

Sin embargo, si tienes problemas con la configuración, visita la página de Preguntas frecuentes y solución de problemas de iOS.

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:

Servicio o producto Pods ¿Agregar Analytics?
AdMob pod 'Google-Mobile-Ads-SDK'
Analytics pod 'Firebase/Analytics'
Verificación de aplicaciones pod 'Firebase/AppCheck'
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'
Crashlytics pod 'Firebase/Crashlytics'
Dynamic Links pod 'Firebase/DynamicLinks'
In‑App Messaging pod 'Firebase/InAppMessaging'
(obligatorio)
Instalaciones de Firebase pod 'Firebase/Installations'
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.

  1. 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.

  2. Descomprime el archivo y revisa el archivo README de los frameworks que quieres incluir en tu app.

  3. Agrega la marca del vinculador ObjC en tu Other Linker Settings en la configuración de compilación de tu destino.

Swift Package Manager

Obtén más información sobre la integración de Swift Package Manager en nuestra guía.

Próximos pasos

Obtén información acerca de Firebase:

Agrega los servicios de Firebase a tu app: