Instala Firebase en tu aplicación de Apple

Administrador de paquetes Swift

A partir de la versión 8.0.0 de Firebase Apple SDK, la compatibilidad con Swift Package Manager de Firebase ya no es beta y está disponible para su uso general. CocoaPods no es necesario para los usuarios de Swift Package Manager.

Para las versiones 8 y posteriores de Firebase, Swift Package Manager es el método de instalación recomendado.

Vía Xcode

La compatibilidad con Swift Package Manager requiere 13.3.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 después. Si está agregando Firebase a un proyecto por primera vez, puede 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 quieras usar. Para nuevos proyectos, recomendamos usar la última versión 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 las descargará en segundo plano.

A través Package.swift

Para integrar Firebase a un paquete Swift a través de un manifiesto Package.swift , puede agregar Firebase a la matriz de dependencies de su 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 de 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 de -ObjC a la configuración de compilación de su objetivo si se incluye de forma transitiva.

Crashlytics

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

Puede usar una fase de compilación de script de ejecución para que Xcode cargue automáticamente los 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 usar 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 usar para cargar manualmente archivos dSYM. Para obtener notas de uso e instrucciones adicionales para el script, ejecute upload-symbols sin ningún parámetro.

CocoaPods

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

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

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

   pod init

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

   Puede agregar cualquiera de los productos compatibles de Firebase a su 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 de usuario y uso de datos y Transparencia de 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.

Crashlytics

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

Puede usar una fase de compilación de script de ejecución para que Xcode cargue automáticamente los 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. Consulte las instrucciones en GitHub para incluir Firebase en su aplicación a través de Carthage.

Integrar manualmente

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

1. Descargue el marco SDK zip . 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, luego revise el README para los marcos que desea incluir en su aplicación.

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