Primeros pasos con Firebase Crashlytics

Cierre de Fabric: El SDK de Fabric heredado y las versiones anteriores del SDK de Firebase Crashlytics están obsoletos y dejarán de informar las fallas de tu app a partir del 15 de noviembre de 2020. Si migraste tu app desde Fabric y quieres seguir recibiendo informes de fallas en Firebase console, visita la guía de actualización y asegúrate de usar las siguientes versiones del SDK de Firebase Crashlytics (o alguna posterior) según el sistema operativo: 17.0.0 para Android, 4.0.0 para iOS y 6.15.0 para Unity.

iOS Android 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.

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

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

Nota: 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 compatible.

   Unity 5.x y las versiones anteriores usan .NET Framework 3.x, de modo que debes importar dotnet3/FirebaseCrashlytics.unitypackage.

   Unity 2017.x y las versiones posteriores permiten usar el .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 la referencia de métodos con el SDK de Firebase Unity para iOS. El SDK requiere la referencia y, sin ella, algunas funciones clave de Firebase, como el control de token de FCM, no se ejecutan correctamente.

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 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()
       // ...
   }

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

Exportación a un lugar de trabajo de Xcode

Verifica que la estructura y las dependencias sean correctas:

your-export-directory/
    build/
    Classes/
    Data/
    GoogleService-Info.plist                      <-
    Info.plist
    ...
    Libraries/
        ...
        Plugins/
            iOS/
                Firebase/
                    libCrashlyticsiOSWrapper.a FIREBASE CONFIG FILE><-
                    libFirebaseCppApp.a CRASHLYTICS LIBRARY><-
        ...
    ...
    Podfile.lock
    Pods FIREBASE CORE LIBRARY Podfile/><-
        FirebaseCrashlytics/
        Firebase/
        FirebaseAnalytics/
        FirebaseCore/
        FirebaseInstanceID/
        GoogleAppMeasurement/
        GoogleUtilities/
        ...
    Unity-iPhone/ Tests/
    Unity-iPhone.xcodeproj
    Unity-iPhone.xcworkspace DEPENDENCIES Unity-iPhone><-
    UnityData.xcassets COCOAPODS WORKSPACE>

Android

Exportación a un proyecto de Android Studio

Verifica que la estructura y las dependencias sean correctas:

your-export-directory/
    build/
    build.gradle
    ...
    Firebase/                                    <-
    gradle/
    gradle.properties
    gradlew.bat
    libs FIREBASE FOR UNITY/><- DEPENDENCIES
        com.google.android.gms.play-services*
        com.google.firebase.firebase-crashlytics-*
        com.google.firebase.firebase-crashlytics-unity-*
        com.google.firebase.firebase-*
    ...
    src/
>

Exportación a un archivo APK

1. Abre tu APK en Android Studio.
2. Verifica que la estructura y las dependencias sean correctas:

  lib/
     x86/
         libunity.so
         libmono.so
         libFirebaseCppApp-version.so            <- FIREBASE CORE LIBRARY
         libmain.so
     armeabi-v7a/
         libunity.so
         libmono.so
         libFirebaseCppApp-version.so            <- FIREBASE CORE LIBRARY
         libmain.so
  assets/
  classes.dex
  res/
  resources.arsc
  AndroidManifest.xml
  firebase-.properties                             <- FIREBASE PROPERTIES
  play-services.properties                         <- GMS PROPERTIES
  

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.

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 al directorio Pods exportado.

• Para descargar CocoaPods en tu máquina, haz lo siguiente:

  • Navega a Assets > Play Services Resolver > iOS Resolver > Install Cocoapods

• Para habilitar o inhabilitar la generación de podfiles (opcional), haz lo siguiente:

  • Navega a Assets > Play Services Resolver > iOS Resolver > Settings

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 Assets > Play Services Resolver > Android Resolver > Resolve

• Para habilitar o inhabilitar la resolución automática (habilitada según la configuración predeterminada), haz lo siguiente:

  • Navega a Assets > Play Services Resolver > Android Resolver > Settings

Próximos pasos

• Para probar la configuración de Crashlytics, fuerza una falla en Firebase console.

• Agrega informes, registros y claves opcionales, así como seguimiento de errores recuperables para personalizar la configuración del informe de fallas.