This guide contains instructions for the latest version of the Firebase Crashlytics SDK. If you migrated your app from Fabric, make sure it's been upgraded and no longer uses the deprecated legacy Fabric SDK.

Comienza a usar Firebase Crashlytics

En esta guía de inicio rápido, se describe cómo configurar Firebase Crashlytics en tu app con el SDK de Firebase Crashlytics para que puedas obtener informes de fallas completos en Firebase console.

Antes de comenzar

  1. Si aún no lo has hecho, agrega Firebase a tu proyecto de iOS. Si no tienes ninguna app para iOS, puedes descargar la app de muestra.

  2. Opcional: Para obtener métricas de fallas (como los usuarios que no experimentaron fallas), rutas de navegación y eventos personalizados, deberás habilitar Google Analytics en tu proyecto de Firebase.

    1. Si tu proyecto existente de Firebase no tiene habilitado Google Analytics, puedes habilitarlo en la pestaña Integraciones de  > Configuración del proyecto.

      Si quieres crear un nuevo proyecto de Firebase, habilita Google Analytics durante el flujo de trabajo de creación.

    2. Por último, en la consola de Google Analytics, habilita el uso compartido de datos en la pestaña Admin > Account Settings > Data Sharing Settings.

      En el caso de los proyectos más antiguos de Firebase, ten en cuenta que es posible que debas habilitar el uso compartido de datos en la pestaña Integraciones de  > Configuración del proyecto (en Firebase console).

Paso 1: Configura Crashlytics en Firebase console

  1. Haz clic en Crashlytics en el panel de navegación izquierdo de Firebase console.

  2. Si tu proyecto de Firebase contiene varias apps registradas, selecciona la última app que agregaste del cuadro desplegable junto a Crashlytics en la barra superior de la consola.

  3. Haz clic en Habilitar Crashlytics.

Paso 2: Agrega Firebase Crashlytics a tu app

  1. Abre el Podfile que creaste para el proyecto de Firebase y agrega el pod FirebaseCrashlytics. Para obtener una experiencia óptima con Firebase Crashlytics, te recomendamos que agregues también el pod de Firebase para Analytics a tu app a fin de habilitar Google Analytics en tu proyecto. Asegúrate de agregar la versión 6.3.1 de Google Analytics o una posterior para obtener rutas de navegación y usuarios sin fallas en tiempo real.

    pod 'Firebase/Crashlytics'
    
    # Recommended: Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
  2. Instala los pods y vuelve a abrir el archivo .xcworkspace para ver el proyecto en Xcode. Puedes hacerlo con los siguientes comandos:

    pod install
    open your-project.xcworkspace
    
  3. Importa el módulo de Firebase en UIApplicationDelegate:

    Swift

    import Firebase

    Objective‑C

    @import Firebase;
  4. Configura una instancia compartida de FirebaseApp, generalmente en el método application:didFinishLaunchingWithOptions:de tu app:

    Swift

      // Use the Firebase library to configure APIs.
      FirebaseApp.configure()
      

    Objective‑C

      // Use the Firebase library to configure APIs.
      [FIRApp configure];
      
  5. Vuelve a compilar la app.

Paso 3: Inicializa Crashlytics

Para inicializar Crashlytics, agrega una secuencia de comandos de ejecución a la fase de compilación del proyecto. La secuencia de comandos de ejecución permite que Xcode suba automáticamente el archivo dSYM del proyecto cada vez que falle tu app para que Crashlytics genere informes de fallas automáticamente.

  1. Abre tu proyecto en Xcode y selecciona el archivo de proyecto en el navegador del lado izquierdo.

  2. En el menú desplegable Select a project or target, selecciona tu destino de compilación principal.

  3. Selecciona la pestaña Build Phases y, luego, haz clic en  > New Run Script Phase.

  4. Expande la nueva sección Run Script que se muestra. En el campo de secuencia de comandos (ubicado debajo del campo Shell), agrega una nueva secuencia de comandos de ejecución:

    "${PODS_ROOT}/FirebaseCrashlytics/run"
  5. Agrega la ubicación del archivo dSYM de tu app como archivo de entrada para permitir que Crashlytics genere automáticamente los archivos dSYM de las apps grandes con más rapidez. Por ejemplo:

    ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}
    

    También puedes proporcionar la ubicación del archivo Info.plist compilado de tu app en el campo Input Files de la fase de compilación:

    $(SRCROOT)/$(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)

Después de agregar el SDK a tu app, Crashlytics comenzará a trabajar automáticamente para detectar y recopilar informes de fallas.

Paso 4: Ejecuta tu proyecto

Por último, ejecuta la app. En los registros del dispositivo, se mostrará la verificación de Firebase cuando se complete la inicialización.

Próximos pasos