Comienza a usar Firebase Crashlytics

iOS+ Android Flutter Unity

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.

La configuración de Crashlytics requiere realizar tareas en Firebase console y en tu IDE (por ejemplo, agregar un archivo de configuración de Firebase y el SDK de Crashlytics). Para finalizar la configuración, deberás forzar una falla de prueba a fin de enviar el primer informe de fallas a Firebase.

Antes de comenzar

1. Si aún no lo has hecho, agrega Firebase a tu proyecto de Unity. Si aún no tienes un proyecto de Unity, puedes descargar una app de ejemplo.

2. Recomendación: Para obtener funciones como usuarios que no experimentan fallas, registros de rutas de navegación y alertas de velocidad, debes habilitar Google Analytics en tu proyecto de Firebase.

   • Si el proyecto de Firebase actual no tiene habilitado Google Analytics, puedes hacerlo en la pestaña Integraciones de tu  > Configuración del proyecto en Firebase console.

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

Paso 1: Agrega el SDK de Firebase Crashlytics a tu app

Ten en cuenta que, si registraste tu proyecto de Unity con el de Firebase, es posible que ya hayas descargado el SDK de Firebase Unity y agregado el paquete de Crashlytics.

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 el proyecto de Unity, ve a Assets > Import Package > Custom Package.

3. En el SDK que descomprimiste, selecciona importar el SDK de Crashlytics (FirebaseCrashlytics.unitypackage).

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

   Unity 2017.x y las versiones posteriores permiten usar .NET Framework 4.x. Si el proyecto de Unity usa .NET 4.x, importa dotnet4/FirebaseCrashlytics.unitypackage.

4. En la ventana Import Unity Package, haz clic en Import.

Importante: No inhabilites el swizzling de métodos con el SDK de Firebase Unity para plataformas de Apple. El SDK requiere esta función. Sin ella, las funciones clave de Firebase (como el control de tokens de FCM) no funcionan correctamente.

Paso 2: Inicializa Crashlytics

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

   1. Abre la primera escena y crea un GameObject vacío con el nombre CrashlyticsInitializer.

   2. Haz clic en Add Component en el Inspector del objeto nuevo.

   3. Selecciona la 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;
   
                   // 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()
       // ...
   }

Paso 3 (solo para Android): Configura la carga de símbolos

Los pasos que se indican en esta sección solo son necesarios para las apps para Android que usan IL2CPP.

• En las apps para Android que usan el backend de secuencias de comandos Mono de Unity, estos pasos no son necesarios.

• Tampoco son necesarios en las apps de la plataforma de Apple porque el complemento de Firebase Unity Editor configura tu proyecto de Xcode automáticamente para subir símbolos.

El SDK de Unity (8.6.1 o versiones posteriores) de Crashlytics incluye informes de fallas del NDK, lo que permite informar automáticamente sobre las fallas de IL2CPP de Unity en Android. Sin embargo, para ver seguimientos de pila simbolizados sobre fallas de bibliotecas nativas en el panel de Crashlytics, debes subir la información de los símbolos en el tiempo de compilación con Firebase CLI.

Sigue estos pasos para configurar la carga de símbolos:

1. Sigue las instrucciones para instalar Firebase CLI.

   Si ya instalaste la CLI, asegúrate de actualizarla a su versión más reciente.

2. Solo para apps que usan el nivel de API de Android 30 o superior: Actualiza la plantilla AndroidManifest.xml de tu app para inhabilitar el etiquetado de punteros:

   1. Marca la casilla de Android Player Settings > Publishing Settings > Build > Custom Main Manifest.

   2. Abre la plantilla de manifiesto ubicada en Assets/Plugins/Android/AndroidManifest.xml.

   3. Agrega el siguiente atributo a la etiqueta de aplicación: <application android:allowNativeHeapPointerTagging="false" ... />.

Paso 4: Crea tu proyecto y sube símbolos

Nota: Completa los pasos de esta sección para comenzar a usar Crashlytics. En el futuro, complétalos cada vez que crees una compilación de lanzamiento o cualquier compilación para la que quieras ver seguimientos de pila simbolizados en Firebase console.

iOS+ (plataforma de Apple)

1. Desde el diálogo Build Settings, exporta tu proyecto a un lugar de trabajo de Xcode.

2. Crea la app.

   En las plataformas de Apple, el complemento de Firebase Unity Editor configura tu proyecto de Xcode automáticamente para generar y subir un archivo de símbolos compatible con Crashlytics a los servidores de Firebase de cada compilación.

Android

1. En el diálogo Build Settings, realiza una de las siguientes acciones:

   • Exporta a un proyecto de Android Studio para compilar tu propio proyecto.

   • Compila tu APK directamente en Unity Editor.
     Antes de compilar, asegúrate de que la casilla de verificación Create symbols.zip esté marcada en el diálogo Build Settings.

2. Una vez que finalice la compilación, genera un archivo de símbolos compatible con Crashlytics y súbelo a los servidores de Firebase ejecutando el siguiente comando de Firebase CLI:

   firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/SYMBOLS

   • FIREBASE_APP_ID: El ID de la app para Android de Firebase (no el nombre del paquete)
     ID de ejemplo de la app para Android de Firebase: 1:567383003300:android:17104a2ced0c9b9b

     ¿Necesitas encontrar el ID de la app de Firebase?

     Puedes hacerlo de las siguientes dos maneras:

     • En el archivo google-services.json, el ID de la app es el valor mobilesdk_app_id.

     • En Firebase console, ve a Configuración del proyecto. Desplázate hacia abajo hasta la tarjeta Tus apps y, luego, haz clic en la app de Firebase que quieres para buscar su ID.

   • PATH/TO/SYMBOLS es la ruta de acceso al archivo de símbolos que genera la CLI

     • Si se exportó a un proyecto de Android Studio: PATH/TO/SYMBOLS es el directorio unityLibrary/symbols que se crea en la raíz del proyecto exportado después de compilar la app con Gradle o Android Studio.

     • Si se compiló el APK directamente en Unity: PATH/TO/SYMBOLS es la ruta de acceso del archivo de símbolos comprimido que se generó en el directorio raíz del proyecto cuando finalizó la compilación (por ejemplo: myproject/myapp-1.0-v100.symbols.zip).

   Consulta las opciones avanzadas para usar el comando de Firebase CLI a fin de subir y generar archivos de símbolos

   Marca	Descripción
   --generator=csym	Usa el generador de archivos de símbolos cSYM heredado en lugar del generador de Breakpad predeterminado. No se recomienda utilizarlo. Recomendamos usar el generador de archivos de símbolos de Breakpad predeterminado.
   --generator=breakpad	Usa el generador de archivos de símbolos de Breakpad. Ten en cuenta que la configuración predeterminada para generar archivos de símbolos es Breakpad. Solo debes usar esta marca si agregaste symbolGenerator { csym() } a la configuración de tu compilación y quieres anularla para usar Breakpad.
   --dry-run	Genera los archivos de símbolos, pero no los sube. Esta marca es útil si quieres inspeccionar el contenido de los archivos que se envían.
   --debug	Proporciona información de depuración adicional.

Paso 5: Fuerza una falla de prueba para finalizar la configuración

Para finalizar la configuración de Crashlytics y ver los datos iniciales en el panel de Crashlytics de Firebase console, debes forzar una falla de prueba.

1. Busca un GameObject existente y agrégale la siguiente secuencia de comandos. Esta secuencia de comandos causará una falla de prueba unos segundos después de ejecutar la app.

   using System;
   using UnityEngine;
   
   public class CrashlyticsTester : MonoBehaviour {
   
       int updatesBeforeException;
   
       // Use this for initialization
       void Start () {
         updatesBeforeException = 0;
       }
   
       // Update is called once per frame
       void Update()
       {
           // Call the exception-throwing method here so that it's run
           // every frame update
           throwExceptionEvery60Updates();
       }
   
       // A method that tests your Crashlytics implementation by throwing an
       // exception every 60 frame updates. You should see non-fatal errors in the
       // Firebase console a few minutes after running your app with this method.
       void throwExceptionEvery60Updates()
       {
           if (updatesBeforeException > 0)
           {
               updatesBeforeException--;
           }
           else
           {
               // Set the counter to 60 updates
               updatesBeforeException = 60;
   
               // Throw an exception to test your Crashlytics implementation
               throw new System.Exception("test exception please ignore");
           }
       }
   }
   

2. Compila tu app y sube la información de los símbolos después de que termine el proceso.

   • iOS+: El complemento Firebase Unity Editor configura tu proyecto de Xcode para subir tu archivo de símbolos automáticamente.

   • Android: En el caso de tus apps para Android que usan IL2CPP, ejecuta el comando crashlytics:symbols:upload de Firebase CLI a fin de subir el archivo de símbolos.

3. Ejecuta la app. Después de hacerlo, revisa el registro del dispositivo y espera a que se active la excepción desde CrashlyticsTester.

   • iOS+: Puedes ver los registros en el panel inferior de Xcode.

   • Android: Ejecuta el comando adb logcat en la terminal para ver los registros.

4. Cuando veas la excepción en el registro del dispositivo, reinicia la app para que pueda enviar el informe de fallas a Firebase.

5. Ve al panel de Crashlytics en Firebase console para ver la falla de prueba.

   Si actualizaste la consola y sigues sin poder ver la falla de prueba después de cinco minutos, habilita el registro de depuración para confirmar si tu app está enviando informes de fallas.

Eso es todo. Ahora Crashlytics supervisa tu app para detectar fallas. Visita el panel de Crashlytics para ver y analizar todos los informes y estadísticas.

Próximos pasos

• Personaliza la configuración de informes de fallas agregando informes, registros y claves opcionales, así como seguimiento de errores recuperables.