Primeros pasos con 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

Para comenzar, necesitas una app de Firebase con Firebase Crashlytics habilitado:

android

Para comenzar, necesitas una app de Firebase con Firebase Crashlytics habilitado:

unity [Beta]

Para usar Crashlytics, debes registrar tu proyecto de Unity y configurarlo a fin de 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).

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 tiene varias apps registradas, selecciona tu proyecto de Unity nuevo en la lista 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.

Agrega el SDK de Crashlytics a tu proyecto

ios

1. Agrega marcos de trabajo de Crashlytics a tu lugar de trabajo de Xcode

Para comenzar, agrega los archivos de marco de trabajo del SDK de Crashlytics a tu proyecto. Para la mayoría de los proyectos, la manera más fácil de hacerlo es agregar CocoaPods de Crashlytics; sin embargo, si tu proyecto no admite CocoaPods, puedes agregar los archivos de forma manual.

2. Agrega la secuencia de comandos de ejecución de Crashlytics

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:

  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 nueva fase de compilación y selecciona Nueva fase de ejecución de secuencia de comandos.
  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)

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

android

Incluye el SDK en tus archivos de compilación

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

    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 { // ... // Add repository maven { url 'https://maven.google.com/' } } }

  2. En el archivo de nivel de proyecto build.gradle, actualiza firebase-core a la versión 11.4.2 o posterior y agrega las 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.7' // Add dependency implementation 'com.crashlytics.sdk.android:crashlytics:2.9.9' }

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

unity [Beta]

Paso 1: Agrega 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 tu proyecto de Unity, ve a Elementos > Importar paquete > Paquete personalizado.

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

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

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

Paso 2: Inicializa Crashlytics

  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 intitialized.
                      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 3: Compila 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)

Ejecuta los agentes de resolución de Servicios de Google Play

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 en 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 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 no fatales.

Enviar comentarios sobre...

Si necesitas ayuda, visita nuestra página de asistencia.