Catch up on everthing we announced at this year's Firebase Summit. Learn more

Agrega Firebase a tu proyecto de Apple

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:

    • Debe orientarse a estas versiones de las plataformas o a otras más recientes:
      • iOS 10
      • macOS 10.12
      • tvOS 12
      • watchOS 6
  • Configura un dispositivo Apple físico o usa un simulador 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 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

Cuando tengas un proyecto de Firebase, podrás agregarle tu app para Apple.

Consulta 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 plataforma.

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

  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 plataformas de Apple (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 Apple.

    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 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 y sus Pods. Obtén más información sobre estas bibliotecas de Firebase para plataformas de Apple:

Servicio o producto Pods Bibliotecas de SwiftPM ¿Agregar Analytics?
AdMob pod 'Google-Mobile-Ads-SDK' N/A
Analytics pod 'Firebase/Analytics' FirebaseAnalytics
Verificación de aplicaciones pod 'Firebase/AppCheck' FirebaseAppCheck
App Distribution pod 'Firebase/AppDistribution' FirebaseAppDistribution
Authentication pod 'Firebase/Auth' FirebaseAuth
Cloud Firestore pod 'Firebase/Firestore' FirebaseFirestore
SDK cliente de Cloud Functions para Firebase pod 'Firebase/Functions' FirebaseFunctions
Cloud Messaging pod 'Firebase/Messaging' FirebaseMessaging
Cloud Storage pod 'Firebase/Storage' FirebaseStorage
Crashlytics pod 'Firebase/Crashlytics' FirebaseCrashlytics
Dynamic Links pod 'Firebase/DynamicLinks' FirebaseDynamicLinks
In‑App Messaging pod 'Firebase/InAppMessaging' FirebaseInAppMessaging
(obligatorio)
Instalaciones de Firebase pod 'Firebase/Installations' FirebaseInstallations
API de Firebase ML Custom Model pod 'Firebase/MLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'Firebase/Performance' FirebasePerformance
Realtime Database pod 'Firebase/Database' FirebaseDatabase
Remote Config pod 'Firebase/RemoteConfig' FirebaseRemoteConfig

Realiza la integración sin un administrador de dependencias

Para sacar provecho de los SDK de Firebase sin usar CocoaPods, puedes importar los frameworks de forma directa.

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 .

  1. Descarga el archivo ZIP del framework 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: