Instala Firebase en tu aplicación de Apple

Administrador de paquetes rápido

Firebase recomienda Swift Package Manager para nuevos proyectos.

A través de Xcode

La compatibilidad con Swift Package Manager requiere 14.1 o superior.

  1. Si migra desde un proyecto basado en CocoaPods, ejecute pod deintegrate para eliminar CocoaPods de su proyecto Xcode. El archivo .xcworkspace generado por CocoaPods se puede eliminar de forma segura posteriormente. Si agregas Firebase a un proyecto por primera vez, puedes ignorar este paso.

  2. En Xcode, instale las bibliotecas de Firebase navegando a Archivo> Agregar paquetes

  3. En el mensaje que aparece, seleccione el repositorio de Firebase GitHub:

    https://github.com/firebase/firebase-ios-sdk.git
    
  4. Selecciona la versión de Firebase que deseas usar. Para proyectos nuevos, recomendamos utilizar la versión más reciente de Firebase.

  5. Elija las bibliotecas de Firebase que desea incluir en su aplicación.

Una vez que haya terminado, Xcode comenzará a resolver las dependencias de su paquete y a descargarlas en segundo plano.

A través de Package.swift

Para integrar Firebase a un paquete Swift a través de un manifiesto Package.swift , puedes agregar Firebase a la matriz dependencies de tu paquete. Para obtener más detalles, consulte la documentación de Swift Package Manager .

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

Luego, en cualquier destino que dependa de un producto de Firebase, agréguelo a la matriz dependencies de ese destino.

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

Consideraciones específicas del producto

Algunos productos de Firebase requieren pasos de integración adicionales para funcionar correctamente.

Google analitico

Google Analytics requiere agregar el indicador del vinculador -ObjC a la configuración de compilación de su objetivo si se incluye de forma transitiva.

Crashlíticos

Crashlytics requiere que cargues símbolos de depuración.

Puede utilizar una fase de compilación de script de ejecución para Xcode para cargar automáticamente símbolos de depuración después de la compilación. Encuentre el script de ejecución aquí:

${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run

Otra opción para cargar símbolos es utilizar el script upload-symbols . Coloque el script en un subdirectorio de su archivo de proyecto (por ejemplo scripts/upload-symbols ), luego asegúrese de que el script sea ejecutable:

chmod +x scripts/upload-symbols

Este script se puede utilizar para cargar archivos dSYM manualmente. Para obtener notas de uso e instrucciones adicionales para el script, ejecute upload-symbols sin ningún parámetro.

CacaoPods

Firebase admite la instalación con CocoaPods además de Swift Package Manager.

La distribución CocoaPods de Firebase requiere Xcode 14.1 y CocoaPods 1.12.0 o superior. A continuación se explica cómo instalar Firebase usando CocoaPods:

  1. Crea un Podfile si aún no tienes uno. Desde la raíz del directorio de su proyecto, ejecute el siguiente comando:

    pod init
  2. A tu Podfile, agrega los pods de Firebase que deseas usar en tu aplicación.

    Puedes agregar cualquiera de los productos Firebase compatibles a tu aplicación.

    Análisis habilitado

    # Add the Firebase pod for Google Analytics
    pod 'FirebaseAnalytics'
    
    # 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 'FirebaseAuth'
    pod 'FirebaseFirestore'

    Obtenga más información sobre IDFA, el identificador de publicidad a nivel de dispositivo, en la documentación de Privacidad del usuario y uso de datos y transparencia del seguimiento de aplicaciones de Apple.

    Análisis no habilitado

    # Add the pods for the Firebase products you want to use in your app
    # For example, to use Firebase Authentication and Cloud Firestore
    pod 'FirebaseAuth'
    pod 'FirebaseFirestore'
  3. Instale los pods, luego abra su archivo .xcworkspace para ver el proyecto en Xcode:

    pod install --repo-update
    open your-project.xcworkspace

Consideraciones específicas del producto

Algunos productos de Firebase requieren pasos de integración adicionales para funcionar correctamente.

Crashlíticos

Crashlytics requiere que cargues símbolos de depuración.

Puede utilizar una fase de compilación de script de ejecución para Xcode para cargar automáticamente símbolos de depuración después de la compilación. Encuentre el script de ejecución aquí:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Cartago

El apoyo a Cartago es experimental. Consulta las instrucciones en GitHub para incluir Firebase en tu aplicación a través de Carthage.

Integrar manualmente

Firebase proporciona una distribución XCFramework binaria prediseñada para usuarios que desean integrar Firebase sin utilizar un administrador de dependencias. Para instalar Firebase:

  1. Descargue el zip del SDK del marco . Este archivo contiene fragmentos de arquitectura para todas las arquitecturas de destino disponibles para todos los SDK de Firebase y, por lo tanto, la descarga puede tardar algún tiempo.

  2. Descomprima el archivo y luego revise el README de los marcos que desea incluir en su aplicación.

  3. Agregue el indicador del vinculador -ObjC en su Other Linker Settings en la configuración de compilación de su objetivo.