Ir a la consola

Comienza a usar Firebase Crashlytics

En esta guía de inicio rápido, se muestra cómo configurar Firebase Crashlytics para obtener informes de fallas completos en Firebase console.

ios

android

unity [Beta]

Antes de comenzar

ios

A fin de poder usar Crashlytics, debes registrar tu app para iOS y configurarla para usar Firebase.

  • Si tu app para iOS ya usa Firebase, significa que ya está registrada y configurada para esa plataforma.

  • SI no tienes la app para iOS, puedes descargar la app de muestra.

Ten en cuenta que agregar Firebase a tu app para iOS implica realizar tareas en Firebase console y en tu proyecto abierto de Xcode (por ejemplo, descargar archivos de configuración de Firebase desde la consola y transferirlos a tu proyecto de Xcode).

android

A fin de usar Crashlytics, debes registrar tu app para Android y configurarla para usar Firebase.

  • Si tu app para Android ya usa Firebase, significa que ya está registrada y configurada para esa plataforma.

  • SI no tienes la app para Android, puedes descargar la app de muestra.

Ten en cuenta que agregar Firebase a tu app para Android implica realizar tareas en Firebase console y en tu proyecto abierto de Android (por ejemplo, descargar archivos de configuración de Firebase desde la consola y transferirlos a tu proyecto de Android).

unity [Beta]

A fin de usar Crashlytics, debes registrar tu proyecto de Unity y configurarlo para usar Firebase.

  • Si tu proyecto de Unity ya usa Firebase, significa que ya está registrado y configurado para Firebase.

  • Si aún no tienes un proyecto de Unity, puedes descargar una app de muestra.

Ten en cuenta que agregar Firebase a tu proyecto de Unity implica realizar tareas en Firebase console y en tu proyecto abierto de Unity (por ejemplo, descargar archivos de configuración de Firebase desde la consola y transferirlos a tu proyecto de Unity).

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 Configurar Crashlytics.

  4. Selecciona Esta app es nueva en Crashlytics y no tiene ninguna versión del SDK.

Paso 2: Agrega el SDK de Crashlytics

ios

Para comenzar, agrega los archivos de marco de trabajo del SDK de Crashlytics al lugar de trabajo de Xcode de tu proyecto. Para la mayoría de los proyectos, es más fácil hacerlo si se agregan los CocoaPods a Crashlytics. Pero si tu proyecto no admite CocoaPods, puedes agregar los archivos de forma manual.

android

  1. En tu nivel de proyecto build.gradle, actualiza tus google-services a la versión 3.1.2 o posterior y luego agrega los repositorios de Crashlytics y la siguiente dependencia:

    buildscript {
        repositories {
            // ...
    
            // Add repository
            maven {
               url 'https://maven.fabric.io/public'
            }
        }
        dependencies {
            // ...
    
            // Check for v3.1.2 or higher
            classpath 'com.google.gms.google-services:4.2.0'
    
            // Add dependency
            classpath 'io.fabric.tools:gradle:1.26.1'
        }
    }
    
    allprojects { // ... repositories { // ... // Check that you have the following line (if not, add it): google() // Google's Maven repository // ... } }

  2. En el archivo build.gradle de nivel de app, actualiza tu firebase-core a la versión v11.4.2 o posterior y, luego, agrega las siguientes dependencias de Crashlytics:

    apply plugin: 'com.android.application'
    apply plugin: 'io.fabric'
    
    dependencies { // ... // Check for v11.4.2 or higher implementation 'com.google.firebase:firebase-core:16.0.8' // Add dependency implementation 'com.crashlytics.sdk.android:crashlytics:2.9.9' }

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

unity [Beta]

  1. Descarga el SDK de Firebase Unity y descomprímelo en el lugar que prefieras.

    El SDK de Firebase Unity no es específico para cada plataforma.

  2. Abre tu proyecto de Unity, ve a Elementos > Importar paquete > Paquete personalizado.

  3. En el SDK que descomprimiste, selecciona la opción para importar el SDK de Crashlytics (FirebaseCrashlytics.unitypackage).

    También puedes importar cualquier otro producto de Firebase admitido.

  4. En la ventana Importar paquete de Unity, haz clic en Importar.

Paso 3: Inicializa Crashlytics

ios

Los marcos de trabajo que agregaste incluyen una secuencia de comandos de ejecución que inicializa Crashlytics. Agrégala a las fases de compilación de tu proyecto como sigue:

  1. Abre tu proyecto en Xcode y selecciona el archivo de proyecto en el Navegador.

  2. Selecciona el destino de compilación principal en el menú desplegable Selecciona un proyecto o un destino.

  3. Abre la pestaña Fases de compilación del destino.

  4. Haz clic en Agregar una fase de compilación nueva, luego selecciona Nueva fase de secuencia de comandos ejecutable.

  5. Agrega la siguiente línea al cuadro de texto Ingresa una secuencia de comandos:

    Instalación con CocoaPods
    "${PODS_ROOT}/Fabric/run"
    Instalación manual
    "${PROJECT_DIR}/Fabric.framework/run"

  6. Solo para Xcode 10: Agrega la ubicación del archivo Info.plist compilado de tu app al campo Archivos de entrada de la fase de compilación:

    $(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.

android

En las apps para Android, un gancho en el archivo AndroidManifest.xml inicializa de forma automática el SDK de Firebase.

unity [Beta]

  1. Crea una secuencia de comandos nueva en C# y agrégala a GameObject en el ambiente.

    1. Abre tu primer ambiente y crea un GameObject vacío con el nombre CrashlyticsInitializer.

    2. Haz clic en Agregar componente en el Inspector para el objeto nuevo.

    3. Selecciona tu secuencia de comandos CrashlyticsInit para agregarla al objeto CrashlyticsInitializer.

  2. Inicializa Crashlytics en el método Start de la secuencia de comandos:

      using System.Collections;
      using System.Collections.Generic;
      using UnityEngine;
    
      // Import Firebase
      using Firebase;
    
      public class CrashlyticsInit : MonoBehaviour {
          // Use this for initialization
          void Start () {
              // Initialize Firebase
              Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => {
                  var dependencyStatus = task.Result;
                  if (dependencyStatus == Firebase.DependencyStatus.Available)
                  {
                      // Create and hold a reference to your FirebaseApp,
                      // where app is a Firebase.FirebaseApp property of your application class.
                      // Crashlytics will use the DefaultInstance, as well;
                      // this ensures that Crashlytics is initialized.
                      Firebase.FirebaseApp app = Firebase.FirebaseApp.DefaultInstance;
    
                      // WARNING: Do not call Crashlytics APIs from asynchronous tasks;
                      // they are not currently supported.
    
                      // Set a flag here for indicating that your project is ready to use Firebase.
                  }
                  else
                  {
                      UnityEngine.Debug.LogError(System.String.Format(
                        "Could not resolve all Firebase dependencies: {0}",dependencyStatus));
                      // Firebase Unity SDK is not safe to use here.
                  }
              });
          }
    
        // Update is called once per frame
        void Update()
          // ...
      }

Una vez que agregues el SDK a tu app y se inicialice, Crashlytics comenzará a trabajar automáticamente para detectar y recopilar informes de fallas.

Paso 4: Compila o ejecuta tu proyecto

ios

Ejecuta la app para enviar la verificación a Firebase de que lo integraste correctamente.

En los registros de tu dispositivo, se mostrará la verificación de Firebase cuando se complete la inicialización.

android

Ejecuta la app para enviar la verificación a Firebase de que lo integraste correctamente.

En los registros de tu dispositivo, se mostrará la verificación de Firebase que indica que se completó la inicialización. Si ejecutas tu app en un emulador que tiene acceso a redes, Firebase console notificará que se completó la conexión de tu app.

unity [Beta]

Verifica que el proyecto se haya exportado correctamente a Android o iOS.

Si te parece que faltan archivos después de comparar el proyecto con las configuraciones de exportación que se muestran abajo, abre Unity Editor y ejecuta el agente de resolución de Servicios de Google Play.

iOS

Android

Ejecuta el agente de resolución (opcional)

Los agentes de resolución de Servicios de Google Play garantizan que el proyecto de Unity tenga las dependencias necesarias para exportar tu app a iOS o Android.

Si quieres obtener más información sobre el agente de resolución, consulta el archivo README del agente de resolución del archivo JAR de Unity.

iOS

El agente de resolución de iOS se ejecuta automáticamente y usa Cocoapods para agregar las dependencias de iOS en el directorio Pods exportado.

  • Para descargar CocoaPods en tu plataforma, haz lo siguiente:

    • Navega a Elementos > Agente de resolución de Servicios de Play > Agente de resolución de iOS > Instalar CocoaPods.
  • Para habilitar o inhabilitar la generación de podfiles (opcional), haz lo siguiente:

    • Navega a Elementos > Agente de resolución de Servicios de Play > Agente de resolución de iOS > Configuración.

Android

El agente de resolución de Android se ejecuta automáticamente y usa gradle para agregar las dependencias de Android a Assets/Plugins/Android.

  • Para ejecutar el agente de resolución de forma manual, haz lo siguiente:

    • Navega a Elementos > Agente de resolución de Servicios de Play > Agente de resolución de Android > Resolver.
  • Para habilitar o inhabilitar la resolución automática (habilitada según la configuración predeterminada), haz lo siguiente:

    • Navega a Elementos > Agente de resolución de Servicios de Play > Agente de resolución de Android > Configuración.

Mira un video instructivo

ios

Para obtener orientación detallada sobre cómo comenzar con Crashlytics, mira el siguiente video instructivo:

Puedes encontrar más videos en el canal de YouTube de Firebase.

android

Para obtener orientación detallada sobre cómo comenzar con Crashlytics, mira el siguiente video instructivo:

Puedes encontrar más videos en el canal de YouTube de Firebase.

Pasos siguientes

  • Prueba tu implementación: Para probar la configuración de Crashlytics, fuerza una falla con el fin de generar el informe correspondiente en Firebase console.

  • Personaliza los informes de fallas: Crashlytics comienza a recopilar informes de fallas automáticamente apenas agregas el SDK, pero también puedes personalizar la configuración si agregas informes de aceptación, registros y claves, y haces un seguimiento de los errores recuperables.