Opciones para instalar Firebase en tu app para Apple

Swift Package Manager

Firebase recomienda Swift Package Manager para proyectos nuevos.

Mediante Xcode

La compatibilidad con Swift Package Manager requiere la versión 15.2 o una posterior.

  1. Si migras desde un proyecto basado en CocoaPods, ejecuta pod deintegrate para quitar CocoaPods de tu proyecto de Xcode. El archivo .xcworkspace generado por CocoaPods se puede borrar después de forma segura. Si es la primera vez que agregas Firebase a un proyecto, puedes omitir este paso.

  2. En Xcode, navega a File > Add Packages para instalar las bibliotecas de Firebase.

  3. En el mensaje que aparece, selecciona el siguiente repositorio de Firebase en GitHub:

    https://github.com/firebase/firebase-ios-sdk.git

  4. Selecciona la versión de Firebase que quieres usar. Para los proyectos nuevos, te recomendamos usar la versión más reciente de Firebase.

  5. Elige las bibliotecas de Firebase que quieres incluir en tu app.

Cuando termines, Xcode comenzará a resolver las dependencias de tus paquetes y las descargará en segundo plano.

Por Package.swift

Para integrar Firebase en un paquete Swift mediante un manifiesto Package.swift, puedes agregar Firebase al array dependencies de tu paquete. Para obtener más detalles, consulta la documentación de Swift Package Manager.

dependencies: [

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

],

Luego, agrégalo al array dependencies de ese destino en cualquier objetivo que dependa de un producto de Firebase.

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

Google Analytics requiere que agregues la marca del vinculador -ObjC a la configuración de la compilación del destino si se incluye de forma transitiva.

Crashlytics

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

Puedes usar una fase de compilación de la secuencia de comandos de ejecución para Xcode a fin de subir automáticamente símbolos de depuración después de la compilación. Busca la secuencia de comandos de ejecución aquí:

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

Como alternativa para subir símbolos, puedes usar la secuencia de comandos upload-symbols. Coloca la secuencia de comandos en un subdirectorio del archivo de tu proyecto (por ejemplo, scripts/upload-symbols) y, luego, asegúrate de que esta sea ejecutable:

chmod +x scripts/upload-symbols

Esta secuencia de comandos se puede usar para subir manualmente archivos dSYM. Si quieres obtener notas de uso, así como instrucciones adicionales para la secuencia de comandos, ejecuta upload-symbols sin ningún parámetro.

CocoaPods

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

La distribución de CocoaPods de Firebase requiere Xcode 15.2 y CocoaPods 1.12.0 o una versión posterior. Aquí te mostramos cómo instalar Firebase con CocoaPods:

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

    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 admitidos a tu app.

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

    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.

    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 'FirebaseAuth'
pod 'FirebaseFirestore'

  3. Instala los pods y abre el archivo .xcworkspace para ver el proyecto en Xcode. Puedes hacerlo con los siguientes comandos:

    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 subas símbolos de depuración.

Puedes usar una fase de compilación de la secuencia de comandos de ejecución para Xcode a fin de subir automáticamente símbolos de depuración después de la compilación. Busca la secuencia de comandos de ejecución aquí:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Carthage

La compatibilidad con Carthage es experimental. Consulta las instrucciones en GitHub para incluir Firebase en tu app a través de Carthage.

Realiza la integración de forma manual

Firebase proporciona una distribución XCFramework binaria compilada previamente para los usuarios que quieran integrar Firebase sin usar un administrador de dependencias. Para instalar Firebase, sigue estos pasos:

  1. Descarga el archivo ZIP del framework del SDK. Este archivo contiene fragmentos de arquitectura para todas las arquitecturas de destino disponibles de todos los SDK de Firebase, 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 la sección Other Linker Settings de la configuración de compilación de tu destino.