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.

Antes de comenzar

A fin de usar Crashlytics, debes registrar tu proyecto de Unity y configurarlo para que use 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

  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. Desde el SDK que descomprimiste, selecciona importar los 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

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

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

    2. Haz clic en Agregar componente en el Inspector para el 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()
          // ...
      }

    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

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 los Servicios de Google Play garantizan que el proyecto de Unity tenga las dependencias necesarias para exportar la app a iOS o Android.

Para 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 al 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:

    • Ve a Recursos > 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:

    • Ve a Recursos > Agente de resolución de Servicios de Play > Agente de resolución de Android > Configuración.

Mira un video instructivo

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 la implementación: Para probar la configuración de Crashlytics, fuerza una falla con el fin de generar el informe correspondiente en Firebase console.

  • Personaliza 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.