Instala Firebase en tu aplicación de Apple

Administrador de paquetes Swift

A partir de la V8.0.0 del SDK de Apple Firebase, de Firebase Swift Gestor de paquetes de apoyo está fuera de beta y está generalmente disponible para su uso. CocoaPods no es necesario para los usuarios de Swift Package Manager.

Para las versiones 12.5 y superiores de Xcode, Swift Package Manager es el método de instalación recomendado.

A través de Xcode

La compatibilidad con Swift Package Manager requiere Xcode 12.5 o superior.

  1. Si está migrando desde un proyecto basado en CocoaPods, ejecute pod deintegrate para eliminar CocoaPods de su proyecto Xcode. El CocoaPods-generados .xcworkspace de archivos de forma segura se puede eliminar después. Si está agregando Firebase a un proyecto por primera vez, este paso puede ignorarse.

  2. En Xcode, instalar las librerías base de fuego mediante la navegación a Archivo> Paquetes Swift> Agregar paquete de dependencias ...

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

    https://github.com/firebase/firebase-ios-sdk.git
    
  4. Seleccione la versión de Firebase que desea usar. Para proyectos nuevos, recomendamos usar 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.

Via Package.swift

Para integrar Firebase a un paquete de Swift a través de un Package.swift manifiesto, se puede añadir a la Firebase dependencies variedad de su paquete. Para más detalles, consulte la documentación de Swift Administrador de paquetes .

dependencies: [

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

],

Luego, en cualquier objetivo que depende de un producto Firebase, añadirlo a la dependencies gama de ese objetivo.

.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 añadir el -ObjC bandera enlazador de configuración de generación de su objetivo si se incluye de forma transitiva.

Crashlytics

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

Puede utilizar una fase de ejecución de la secuencia de comandos para que Xcode cargue automáticamente los símbolos de depuración posteriores a la compilación. Encuentre el script de ejecución aquí:

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

Otra opción para los símbolos de subida es utilizar la upload-symbols la escritura. Coloque la secuencia de comandos en un subdirectorio de su archivo de proyecto (por ejemplo, scripts/upload-symbols ), a continuación, asegúrese de que el guión es ejecutable:

chmod +x scripts/upload-symbols

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

CocoaPods

Firebase admite la instalación con CocoaPods además de Swift Administrador de paquetes.

La distribución CocoaPods de Firebase requiere Xcode 12.5 y CocoaPods 1.10.0 o superior. Aquí se explica cómo instalar Firebase usando CocoaPods:

  1. Cree un Podfile si aún no tiene uno. Desde la raíz del directorio de tu proyecto, ejecuta el siguiente comando:

    pod init
  2. A su Podfile, agregue los pods de Firebase que desea usar en su aplicación.

    Puede añadir cualquiera de los productos de base de fuego apoyados a su aplicación.

    Analytics habilitado

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

    Más información sobre el IDFA, el identificador de publicidad a nivel del dispositivo, de Apple en la privacidad del usuario y el uso de datos y aplicación de seguimiento Transparencia documentación.

    Analytics 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 'Firebase/Auth'
    pod 'Firebase/Firestore'
  3. Instalar las vainas, a continuación, abra su .xcworkspace archivo 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.

Crashlytics

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

Puede utilizar una fase de ejecución de secuencia de comandos para que Xcode cargue automáticamente los símbolos de depuración posteriores a la compilación. Encuentre el script de ejecución aquí:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Cartago

El apoyo de Cartago es experimental. Ver las instrucciones en GitHub para la inclusión de Firebase en su aplicación a través de Cartago.

Integrar manualmente

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

  1. Descargar el zip marco SDK . Este archivo contiene porciones de arquitectura para todas las arquitecturas de destino disponibles para todos los SDK de Firebase y, por lo tanto, es posible que tarde algún tiempo en descargarse.

  2. Descomprimir el archivo, a continuación, revise el README de los marcos que desea incluir en su aplicación.

  3. Añadir el -ObjC bandera enlazador en sus Other Linker Settings de configuración de generación de su objetivo.