En esta página se ofrece ayuda para solucionar problemas y respuestas a preguntas frecuentes sobre el uso de Crashlytics. Si no encuentras lo que buscas o necesitas más ayuda, ponte en contacto con el equipo de Asistencia de Firebase.
En esta página, encontrarás información sobre los siguientes tipos de temas:
Solución de problemas generales, incluidas preguntas sobre la visualización de datos o el trabajo con datos en la consola de Firebase, y preguntas sobre problemas que han vuelto a aparecer.
Asistencia específica de cada plataforma, incluidas preguntas concretas sobre plataformas de Apple, Android, Web y Unity.
Asistencia para integraciones, incluidas preguntas sobre BigQuery.
Solución de problemas generales y preguntas frecuentes
Ver diferentes formatos (y, a veces, variantes) de algunos problemas en la tabla Problemas
Es posible que observes dos formatos diferentes para los problemas que aparecen en la tabla Problemas de la consola de Firebase. También puede que veas una función llamada "variantes" en algunos de tus problemas. A continuación, te indicamos por qué.
A principios del 2023, lanzamos un motor de analíticas mejorado para agrupar eventos, así como un diseño actualizado y algunas funciones avanzadas para nuevos problemas (como las variantes). Consulta nuestra reciente entrada de blog para conocer todos los detalles, aunque puedes leer los aspectos más destacados a continuación.
Crashlytics analiza todos los eventos de tu aplicación (como fallos, errores no graves y errores ANR) y crea grupos de eventos llamados problemas. Todos los eventos de un problema tienen un punto de fallo común.
Para agrupar los eventos en estos problemas, el motor de analíticas mejorado ahora examina muchos aspectos del evento, como los marcos del rastreo de la pila, el mensaje de excepción, el código de error y otras características de la plataforma o del tipo de error.
Sin embargo, dentro de este grupo de eventos, los rastreos de la pila que provocan el fallo pueden ser diferentes. Un rastreo de la pila diferente podría significar una causa raíz diferente. Para representar esta posible diferencia dentro de un problema, ahora creamos variantes dentro de los problemas. Cada variante es un subgrupo de eventos de un problema que tienen el mismo punto de fallo y un rastreo de la pila similar. Con las variantes, puedes depurar los rastreos de la pila más habituales de un problema y determinar si hay diferentes causas principales que provocan el fallo.
Esto es lo que experimentarás con estas mejoras:
Metadatos renovados que se muestran en la fila del problema
Ahora es más fácil entender y clasificar los problemas de tu aplicación.Menos incidencias duplicadas
Un cambio en el número de línea no genera una nueva incidencia.Depuración más sencilla de problemas complejos con varias causas principales
Usa variantes para depurar los rastreos de la pila más habituales de un problema.Alertas y señales más significativas
Un problema nuevo representa un error nuevo.Búsqueda más potente
Cada problema contiene más metadatos que se pueden buscar, como el tipo de excepción y el nombre del paquete.
Estas mejoras se están implementando de la siguiente manera:
Cuando recibamos nuevos eventos de tu aplicación, comprobaremos si coinciden con un problema que ya exista.
Si no hay ninguna coincidencia, aplicaremos automáticamente nuestro algoritmo de agrupación de eventos más inteligente al evento y crearemos un nuevo problema con el diseño de metadatos renovado.
Esta es la primera gran actualización que hacemos en nuestra agrupación de eventos. Si tienes comentarios o detectas algún problema, envíanos un informe.
No se muestran los registros de rutas de navegación
Si no ves registros de rutas de navegación (iOS+ | Android | Flutter | Unity), te recomendamos que compruebes la configuración de Google Analytics en tu aplicación. Debes cumplir los siguientes requisitos:
Has habilitado Google Analytics en tu proyecto de Firebase.
Has habilitado la opción Compartir datos para Google Analytics. Consulta más información sobre este ajuste en el artículo Gestionar las opciones para compartir datos de Analytics.
Has añadido a tu aplicación el SDK de Firebase para Google Analytics: iOS+ | Android | Flutter | Unity.
Este SDK debe añadirse además del SDK de Crashlytics.Estás usando las versiones más recientes del SDK de Firebase en todos los productos que utilizas en tu aplicación (iOS+ | Android | Flutter | Unity).
En el caso de las plataformas de Apple y las aplicaciones Android, comprueba que estés usando como mínimo la siguiente versión del SDK de Firebase para Google Analytics:
iOS+: v6.3.1 o una versión posterior (v8.9.0 o una versión posterior para macOS y tvOS) |Android: v17.2.3 o una versión posterior (BoM v24.7.1 o una versión posterior) .
No veo las alertas de velocidad
Si no ves alertas de velocidad, asegúrate de que estás usando la versión
No recibo alertas de Crashlytics (permisos)
Para recibir o configurar alertas de Crashlytics, los miembros del proyecto deben tener los permisos de gestión de identidades y accesos necesarios. Puedes gestionar los ajustes de las alertas y definir las preferencias de alertas de tu cuenta en la consola de Firebase, en la página
En la siguiente tabla se indican los permisos necesarios y los roles predefinidos que incluyen esos permisos de forma predeterminada:
| Función | Permiso necesario para recibir la alerta | Roles que incluyen el permiso necesario de forma predeterminada |
|---|---|---|
| Crashlytics: alertas de aplicaciones móviles | firebase.projects.update |
|
| Crashlytics: alertas de aplicaciones web |
|
Para obtener más información sobre cómo configurar alertas, consulta Configurar y recibir alertas de Crashlytics. Para obtener más información sobre los roles y permisos de gestión de identidades y accesos, consulta el artículo Permisos y acceso a Firebase.
No se muestran las métricas de sesiones sin fallos (o se muestran métricas poco fiables)
Si no ves métricas de usuarios o sesiones sin fallos, o si las métricas que ves no son fiables, comprueba lo siguiente:
Asegúrate de que usas la versión
Asegúrate de que la configuración de recogida de datos no afecte a la calidad de tus métricas de sesiones sin fallos:
Si habilitas los informes de aceptación inhabilitando los informes de fallos automáticos, la información sobre fallos solo se podrá enviar a Crashlytics desde los usuarios que hayan aceptado explícitamente la recogida de datos. Por lo tanto, la precisión de las métricas de usuarios sin fallos se verá afectada, ya que Crashlytics solo tiene información sobre fallos de los usuarios que han aceptado compartirla (en lugar de todos tus usuarios). Esto significa que tus métricas de fallos pueden ser menos fiables y reflejar menos la estabilidad general de tu aplicación.
Si tienes inhabilitada la recogida de datos automática, puedes usar
sendUnsentReportspara enviar informes almacenados en caché en el dispositivo a Crashlytics. Si usas este método, se enviarán datos de fallos a Crashlytics, pero no datos de sesiones, lo que hará que los gráficos de la consola muestren valores bajos o nulos en las métricas de sesiones sin fallos.
¿Cómo se calculan los usuarios sin fallos?
Consulta Interpretar las métricas sin fallos.
¿Quién puede ver, escribir y eliminar notas sobre un problema?
Las notas permiten a los miembros del proyecto comentar problemas específicos con preguntas, actualizaciones de estado, etc.
Cuando un miembro del proyecto publica una nota, se etiqueta con el correo de su cuenta de Google. Esta dirección de correo, junto con la nota, es visible para todos los miembros del proyecto que tengan acceso para ver la nota.
A continuación, se describen los accesos necesarios para ver, escribir y eliminar notas:
Los miembros del proyecto que tengan cualquiera de los siguientes roles pueden ver y eliminar las notas de un problema, así como escribir notas nuevas.
Los miembros del proyecto que tengan alguno de los siguientes roles pueden ver las notas publicadas en un problema, pero no pueden eliminarlas ni escribirlas.
- Lector, Lector de Firebase, Lector de calidad o Lector de Crashlytics de proyectos
¿Qué es un problema de regresión?
Se produce una regresión cuando has cerrado un problema, pero Crashlytics recibe un nuevo informe que indica que el problema ha vuelto a ocurrir. Crashlytics vuelve a abrir automáticamente estos problemas de regresión para que puedas solucionarlos según corresponda en tu aplicación.
A continuación, se muestra un ejemplo de cómo Crashlytics categoriza un problema como regresión:
- Por primera vez, Crashlytics recibe un informe sobre fallos sobre el fallo "A". Crashlytics abre un problema correspondiente a ese fallo (problema "A").
- Corriges este error rápidamente, cierras el problema "A" y, a continuación, publicas una nueva versión de tu aplicación.
- Crashlytics recibe otra denuncia sobre el problema "A" después de que lo hayas cerrado.
- Si el informe procede de una versión de la aplicación que Crashlytics conocía cuando cerraste el problema (es decir, que la versión había enviado un informe de cualquier fallo), Crashlytics no considerará que el problema haya regresado. El problema permanecerá cerrado.
- Si el informe procede de una versión de la aplicación que Crashlytics no conocía cuando cerraste el problema (es decir, que la versión nunca había enviado ningún informe de fallos), Crashlytics considerará que el problema ha vuelto a aparecer y lo volverá a abrir.
Cuando se produce una regresión, enviamos una alerta de detección de regresión y añadimos una señal de regresión al problema para informarte de que Crashlytics ha vuelto a abrir el problema. Si no quieres que un problema se vuelva a abrir debido a nuestro algoritmo de regresión, siléncialo en lugar de cerrarlo.
¿Por qué veo problemas de regresión en versiones anteriores de la aplicación?
Si un informe procede de una versión antigua de la aplicación que nunca había enviado ningún informe de fallos cuando cerraste el problema, Crashlytics considerará que el problema ha vuelto a aparecer y lo volverá a abrir.
Esto puede ocurrir en la siguiente situación: has corregido un error y has lanzado una nueva versión de tu aplicación, pero todavía hay usuarios que usan versiones anteriores sin la corrección de errores. Si, por casualidad, una de esas versiones anteriores nunca había enviado ningún informe de fallos cuando cerraste el problema y esos usuarios empiezan a encontrarse con el error, esos informes de fallos activarían un problema de regresión.
Si no quieres que un problema se vuelva a abrir debido a nuestro algoritmo de regresión, siléncialo en lugar de cerrarlo.
Asistencia específica de la plataforma
En las siguientes secciones se ofrece asistencia para la solución de problemas específicos de cada plataforma y se incluyen preguntas frecuentes: iOS+ | Android | Web | Unity.
Compatibilidad con plataformas de Apple
Faltan dSYMs o no se suben
Para subir los dSYMs de tu proyecto y obtener un resultado detallado, comprueba lo siguiente:
Asegúrate de que la fase de compilación de tu proyecto contenga el script de ejecución de Crashlytics, que permite que Xcode suba los dSYMs de tu proyecto en el momento de la compilación (consulta las instrucciones para añadir el script en Inicializar Crashlytics). Después de actualizar tu proyecto, fuerza un fallo y confirma que aparece en el panel de control de Crashlytics.
Si ves la alerta "Falta dSYM" en la consola de Firebase, comprueba en Xcode que se estén produciendo dSYMs correctamente para la compilación.
Si Xcode produce dSYMs correctamente y sigues viendo que faltan dSYMs, es probable que la herramienta de ejecución de scripts se esté bloqueando al subir los dSYMs. En este caso, prueba lo siguiente:
Asegúrate de usar la versión más reciente de Crashlytics.
Sube los archivos dSYM que faltan manualmente:
- Opción 1: Usa la opción "Arrastrar y soltar" de la consola en la pestaña dSYMs para subir un archivo ZIP que contenga los archivos dSYM que faltan.
- Opción 2: Usa la secuencia de comandos
upload-symbolspara subir los archivos dSYM que faltan para los UUIDs proporcionados en la pestaña dSYMs.
Si siguen faltando dSYMs o las subidas siguen fallando, ponte en contacto con el equipo de Asistencia de Firebase e incluye tus registros.
Los fallos no se han simbolizado correctamente
Si parece que los rastreos de la pila no se han simbolizado correctamente, comprueba lo siguiente:
Si los fotogramas de la biblioteca de tu aplicación no incluyen referencias al código de tu aplicación, asegúrate de que
no esté definido como marca de compilación.-fomit-frame-pointerSi ves varios marcos de
(Missing)para la biblioteca de tu aplicación, comprueba si hay dSYMs opcionales que se hayan indicado como ausentes (para la versión de la aplicación afectada) en la pestaña Crashlytics dSYMs de la consola de Firebase. Si es así, sigue el paso de solución de problemas "Alerta de dSYM que falta" de la sección Preguntas frecuentes sobre dSYMs que faltan o no se suben de esta página. Ten en cuenta que, al subir estos dSYMs, no se simbolizarán los fallos que ya se hayan producido, pero se asegurará la simbolización de los fallos futuros.
¿Puedo usar Crashlytics para macOS o tvOS?
Sí, puedes implementar el Crashlytics en proyectos de macOS y tvOS. Asegúrate de incluir la versión 8.9.0 o una posterior del SDK de Firebase para Google Analytics, de modo que los fallos tengan acceso a las métricas recogidas por Google Analytics (usuarios sin fallos, última versión, alertas de velocidad y registros de rutas de navegación).
¿Puedo usar Crashlytics en un proyecto de Firebase con varias aplicaciones en diferentes plataformas de Apple?
Ahora puedes informar de fallos de varias aplicaciones en un solo proyecto de Firebase, incluso si las aplicaciones se han creado para diferentes plataformas de Apple (por ejemplo, iOS, tvOS y Mac Catalyst). Antes, tenías que separar las aplicaciones en proyectos de Firebase individuales si contenían el mismo ID de bundle.
Compatibilidad con Android
¿Por qué solo se registran los errores ANR en Android 11 y versiones posteriores?
Crashlytics admite informes de errores ANR de aplicaciones Android en dispositivos con Android 11 y versiones posteriores. La API subyacente que usamos para recoger errores ANR (getHistoricalProcessExitReasons) es más fiable que los enfoques basados en SIGQUIT o en watchdog. Esta API solo está disponible en dispositivos con Android 11 y versiones posteriores.
¿Por qué faltan los BuildIds de algunos errores ANR?
Si faltan BuildIds en algunos de tus errores ANR, sigue estos pasos para solucionar el problema:
Asegúrate de que estés usando una versión actualizada del SDK para Android de Crashlytics y del complemento de Gradle de Crashlytics.
Si te faltan
BuildIds de Android 11 y algunos errores ANR de Android 12, es probable que estés usando un SDK o un complemento de Gradle obsoletos, o ambos. Para recoger correctamente losBuildIds de estos errores ANR, debes usar las siguientes versiones:- Crashlytics SDK para Android v18.3.5 o versiones posteriores (Firebase BoM v31.2.2 o versiones posteriores)
- Plugin de Gradle Crashlytics v2.9.4 o versiones posteriores
Comprueba si estás usando una ubicación no estándar para tus bibliotecas compartidas.
Si solo faltan
BuildIds en las bibliotecas compartidas de tu aplicación, es probable que no estés usando la ubicación predeterminada estándar para las bibliotecas compartidas. Si es así, puede que Crashlytics no pueda localizar losBuildIds asociados. Te recomendamos que uses la ubicación estándar para las bibliotecas compartidas.Asegúrate de no eliminar
BuildIds durante el proceso de compilación.Ten en cuenta que los siguientes consejos para solucionar problemas se aplican tanto a los errores ANR como a los fallos nativos.
Comprueba si existen los
BuildIdejecutandoreadelf -nen tus binarios. Si no aparecen losBuildIds, añade-Wl,--build-ida las marcas de tu sistema de compilación.Comprueba que no estés eliminando los
BuildIds sin querer para reducir el tamaño de tu APK.Si conservas versiones con y sin símbolos de una biblioteca, asegúrate de que el código apunte a la versión correcta.
Diferencias entre los informes de errores ANR del panel de control de Crashlytics y Google Play Console
Puede haber una discrepancia entre el recuento de errores ANR de Google Play y el de Crashlytics. Esto es normal, ya que los mecanismos de recogida y de generación de informes de datos de errores ANR son diferentes. Crashlytics informa de los errores ANR la próxima vez que se inicia la aplicación, mientras que Android vitals envía los datos de los errores ANR después de que se produzcan.
Además, Crashlytics solo muestra los errores ANR que se producen en dispositivos con Android 11 o versiones posteriores, mientras que Google Play muestra los errores ANR de dispositivos con Servicios de Google Play y con el consentimiento de recogida de datos aceptado.
¿Por qué veo fallos de archivos de .kt etiquetados como problemas de .java?
Cuando una aplicación usa un ofuscador que no muestra la extensión de archivo, Crashlytics genera cada problema con una extensión de archivo .java de forma predeterminada.
Para que Crashlytics pueda generar problemas con la extensión de archivo correcta, asegúrate de que tu aplicación use la siguiente configuración:
- Usa Android Gradle 4.2.0 o una versión posterior
- Usa R8 con la ofuscación activada. Para actualizar tu aplicación a R8, sigue esta documentación.
Ten en cuenta que, después de actualizar a la configuración descrita anteriormente, puede que empieces a ver nuevos problemas de .kt que son duplicados de problemas de .java que ya existen. Consulta las preguntas frecuentes para obtener más información sobre esa circunstancia.
¿Por qué veo problemas de .kt que son duplicados de problemas de .java?
A partir de mediados de diciembre del 2021, Crashlytics mejoró la compatibilidad con las aplicaciones que usan Kotlin.
Hasta hace poco, los ofuscadores disponibles no mostraban la extensión de archivo, por lo que Crashlytics generaba cada número con una extensión de archivo .java de forma predeterminada.
Sin embargo, a partir de Android Gradle 4.2.0, R8 admite extensiones de archivo.
Con esta actualización, Crashlytics ahora puede determinar si cada clase usada en la aplicación está escrita en Kotlin e incluir el nombre de archivo correcto en la firma del problema. Ahora, los fallos se atribuyen correctamente a los archivos .kt (según corresponda) si tu aplicación tiene la siguiente configuración:
- Tu aplicación usa Android Gradle 4.2.0 o una versión posterior.
- Tu aplicación usa R8 con la ofuscación activada.
Como los nuevos fallos ahora incluyen la extensión de archivo correcta en sus firmas de problemas, es posible que veas nuevos problemas de .kt que en realidad son duplicados de problemas etiquetados como .java. En la consola de Firebase, intentamos identificar y comunicarte si un nuevo problema de .kt puede ser un duplicado de un problema etiquetado como .java.
No se producen fallos con Dexguard
Si ves la siguiente excepción, es probable que estés usando una versión de DexGuard que no sea compatible con el SDK de Firebase Crashlytics:
java.lang.IllegalArgumentException: Transport backend 'cct' is not registered
Esta excepción no provoca que tu aplicación falle, pero impide que envíe informes sobre fallos. Para corregir este problema, haz lo siguiente:
Asegúrate de que estás usando la última versión de DexGuard 8.x. La última versión contiene reglas que requiere el SDK de Firebase Crashlytics.
Si no quieres cambiar la versión de DexGuard, prueba a añadir la siguiente línea a tus reglas de ofuscación (en el archivo de configuración de DexGuard):
-keepresourcexmlelements manifest/application/service/meta-data@value=cct
¿Cómo se actualiza a la versión 3 del complemento de Gradle de Crashlytics?
La última versión del complemento de Gradle de Crashlytics es una versión principal (v3.0.0) y moderniza el SDK, ya que deja de admitir versiones anteriores de Gradle y del complemento de Android para Gradle. Además, los cambios de esta versión resuelven problemas con AGP v8.1+ y mejoran la compatibilidad con aplicaciones nativas y compilaciones personalizadas.
Requisitos mínimos
La versión 3 del complemento de Gradle de Crashlytics tiene los siguientes requisitos mínimos:
Complemento de Android para Gradle 8.1 o una versión posterior
Actualiza este complemento con el asistente de actualización del complemento de Android para Gradle de la versión más reciente de Android Studio.Complemento de Gradle
google-servicesde Firebase 4.4.1 o una versión posterior
Actualiza este complemento especificando la versión más reciente en el archivo de compilación de Gradle de tu proyecto, de la siguiente manera:
Kotlin
plugins { id("com.android.application") version "8.1.4" apply false id("com.google.gms.google-services") version "4.6.0" apply false ... }
Groovy
plugins { id 'com.android.application' version '8.1.4' apply false id 'com.google.gms.google-services' version '4.6.0' apply false ... }
Cambios en la extensión Crashlytics
En la versión 3 del complemento de Gradle de Crashlytics, la extensión de Crashlytics tiene los siguientes puntos de ruptura:
Se ha quitado la extensión del bloque de Android
defaultConfig. En su lugar, debes configurar cada variante.Se ha eliminado el campo obsoleto
mappingFile. Ahora, el archivo de mapeado combinado se proporciona automáticamente.Se ha eliminado el campo obsoleto
strippedNativeLibsDir. En su lugar, debes usarunstrippedNativeLibsDirpara todas las bibliotecas nativas.Se ha cambiado el campo
unstrippedNativeLibsDirpara que sea acumulativo.Ver un ejemplo con varios directorios
buildTypes { release { configure<CrashlyticsExtension> { nativeSymbolUploadEnabled = true unstrippedNativeLibsDir = file("MY/NATIVE/LIBS") } } productFlavors { flavorDimensions += "feature" create("basic") { dimension = "feature" // ... } create("featureX") { dimension = "feature" configure<CrashlyticsExtension> { unstrippedNativeLibsDir = file("MY/FEATURE_X/LIBS") } } } }
La tarea
solo subirá los símbolos deuploadCrashlyticsSymbolFilesBasicReleaseMY/NATIVE/LIBS, pero subirá los símbolos deuploadCrashlyticsSymbolFilesFeatureXReleaseMY/NATIVE/LIBSyMY/FEATURE_X/LIBS.Se ha sustituido el campo de cierre
symbolGeneratorpor dos nuevos campos de nivel superior:symbolGeneratorType, una cadena de"breakpad"(predeterminada) o"csym".breakpadBinary, un archivo de una anulación binaria local dedump_syms.
Ejemplo de cómo actualizar la extensión
Kotlin
| Antes |
buildTypes { release { configure<CrashlyticsExtension> { // ... symbolGenerator( closureOf<SymbolGenerator> { symbolGeneratorType = "breakpad" breakpadBinary = file("/PATH/TO/BREAKPAD/DUMP_SYMS") } ) } } } |
| Ahora en la versión 3 |
buildTypes { release { configure<CrashlyticsExtension> { // ... symbolGeneratorType = "breakpad" breakpadBinary = file("/PATH/TO/BREAKPAD/DUMP_SYMS") } } } |
Groovy
| Antes |
buildTypes { release { firebaseCrashlytics { // ... symbolGenerator { breakpad { binary file("/PATH/TO/BREAKPAD/DUMP_SYMS") } } } } } |
| Ahora en la versión 3 |
buildTypes { release { firebaseCrashlytics { // ... symbolGeneratorType "breakpad" breakpadBinary file("/PATH/TO/BREAKPAD/DUMP_SYMS") } } } |
Asistencia específica para Android NDK
Diferencias entre los rastreos de la pila de NDK en el panel de control de Crashlytics y en Logcat
Las cadenas de herramientas LLVM y GNU tienen valores predeterminados y tratamientos distintos para el segmento de solo lectura de los binarios de tu aplicación, lo que puede generar rastreos de la pila incoherentes en la consola de Firebase. Para mitigar este problema, añade las siguientes marcas de vinculación al proceso de compilación:
Si usas el enlazador
lldde la cadena de herramientas de LLVM, añade lo siguiente:-Wl,--no-rosegmentSi usas el enlazador
ld.goldde la cadena de herramientas de GNU, añade:-Wl,--rosegment
Si sigues viendo incoherencias en el rastreo de la pila (o si ninguna de las marcas es pertinente para tu cadena de herramientas), prueba a añadir lo siguiente al proceso de compilación:
-fno-omit-frame-pointer¿Cómo puedo usar mi propio binario generador de archivos de símbolos de Breakpad para NDK?
El complemento Crashlytics incluye un generador de archivos de símbolos de Breakpad personalizado.
Si prefieres usar tu propio binario para generar archivos de símbolos de Breakpad (por ejemplo, si prefieres crear todos los ejecutables nativos de tu cadena de compilación a partir de la fuente), usa la propiedad de extensión opcional symbolGeneratorBinary para especificar la ruta al ejecutable.
Puedes especificar la ruta al binario del generador de archivos de símbolos de Breakpad de dos formas:
Opción 1: Especifica la ruta mediante la extensión
firebaseCrashlyticsen tu archivobuild.gradle.Añade lo siguiente a tu archivo
build.gradle.kts, a nivel de la aplicación:Complemento de Gradle v3.0.0 o versiones posteriores
android { buildTypes { release { configure<CrashlyticsExtension> { nativeSymbolUploadEnabled = true // Add these optional fields to specify the path to the executable symbolGeneratorType = "breakpad" breakpadBinary = file("/PATH/TO/BREAKPAD/DUMP_SYMS") } } } }
versiones anteriores del complemento
android { // ... buildTypes { // ... release { // ... firebaseCrashlytics { // existing; required for either symbol file generator nativeSymbolUploadEnabled true // Add this optional new block to specify the path to the executable symbolGenerator { breakpad { binary file("/PATH/TO/BREAKPAD/DUMP_SYMS") } } } } }
Opción 2: Especificar la ruta mediante una línea de propiedad en el archivo de propiedades de Gradle
Puedes usar la propiedad
com.google.firebase.crashlytics.breakpadBinarypara especificar la ruta al ejecutable.Puedes actualizar manualmente el archivo de propiedades de Gradle o hacerlo mediante la línea de comandos. Por ejemplo, para especificar la ruta mediante la línea de comandos, usa un comando como el siguiente:
./gradlew -Pcom.google.firebase.crashlytics.symbolGenerator=breakpad \ -Pcom.google.firebase.crashlytics.breakpadBinary=/PATH/TO/BREAKPAD/DUMP_SYMS \ app:assembleRelease app:uploadCrashlyticsSymbolFileRelease
¿Crashlytics admite armeabi?
El NDK de Firebase Crashlytics no es compatible con ARMv5 (armeabi). La compatibilidad con esta ABI se eliminó en la versión r17 del NDK.
Asistencia web
Aparece el error Component crashlytics has not been registered yet
Cuando uses el paquete @firebase/crashlytics, no mezcles espacios de nombres modulares en tus importaciones. Importar initializeApp de firebase/app mientras se importa getCrashlytics de @firebase/crashlytics hace que los empaquetadores carguen dos registros internos independientes, lo que provoca errores como Component crashlytics has not been registered yet.
A continuación, te indicamos cómo evitar conflictos de registro de paquetes duales:
Estandariza todas las importaciones de Firebase de tu proyecto para usar el espacio de nombres
@firebase/(por ejemplo,@firebase/appy@firebase/crashlytics).Si tu aplicación usa Vite, anula explícitamente los duplicados de
@firebase/appen tu archivovite.config.ts:// vite.config.ts import { defineConfig } from 'vite'; export default defineConfig({ resolve: { dedupe: ['@firebase/app'] } });
Error de compilación de TypeScript con verbatimModuleSyntax habilitado
Las configuraciones modernas de TypeScript (como las plantillas de Vite y Angular) suelen habilitar "verbatimModuleSyntax": true en tsconfig.json. Cuando se habilita esta marca, al importar una interfaz de TypeScript mediante una importación de valor estándar, se produce un error de compilación.
Usa importaciones type explícitas al importar interfaces de TypeScript como FirebaseApp o Crashlytics:
import { initializeApp, type FirebaseApp } from '@firebase/app';
import { getCrashlytics, type Crashlytics } from '@firebase/crashlytics';
Compatibilidad con Unity
Ver rastreos de la pila sin simbolizar de aplicaciones Android en el panel de control de Crashlytics
Si usas IL2CPP de Unity y ves rastreos de la pila sin símbolos, prueba lo siguiente:
Asegúrate de que usas la versión 8.6.1 o una posterior del SDK de Unity de Crashlytics.
Asegúrate de que has configurado y ejecutado el comando de la CLI de Firebase
crashlytics:symbols:uploadpara generar y subir tu archivo de símbolos.Debes ejecutar este comando de la CLI cada vez que crees una compilación de lanzamiento o cualquier compilación de la que quieras ver rastreos de la pila con símbolos en la consola de Firebase. Consulta más información en el artículo Obtener informes de fallos legibles.
¿Se puede usar Crashlytics con aplicaciones que utilizan IL2CPP?
Sí, Crashlytics puede mostrar rastreos de la pila simbolizados de tus aplicaciones que usen IL2CPP. Esta función está disponible para aplicaciones publicadas en plataformas Android o Apple. Esto es lo que debes hacer:
Asegúrate de que estás usando la versión 8.6.0 o una posterior del SDK de Unity de Crashlytics.
Completa las tareas necesarias para tu plataforma:
En el caso de las aplicaciones de la plataforma de Apple: no es necesario realizar ninguna acción especial. En el caso de las aplicaciones para plataformas de Apple, el complemento del editor de Unity de Firebase configura automáticamente tu proyecto de Xcode para subir símbolos.
En aplicaciones Android: asegúrate de que has configurado y ejecutado el comando de la CLI Firebase
crashlytics:symbols:uploadpara generar y subir tu archivo de símbolos.Debes ejecutar este comando de la CLI cada vez que crees una compilación de lanzamiento o cualquier compilación de la que quieras ver rastreos de la pila con símbolos en la consola de Firebase. Consulta más información en el artículo Obtener informes de fallos legibles.
Informar de excepciones no detectadas como errores graves
Crashlytics puede registrar excepciones no detectadas como errores graves (a partir de la versión 10.4.0 del SDK de Unity). En las siguientes preguntas frecuentes se explica el motivo por el que se usa esta función y las prácticas recomendadas para hacerlo.
¿Por qué una aplicación debería informar de las excepciones no detectadas como errores críticos?
Si registras las excepciones no detectadas como errores graves, obtendrás una indicación más realista de qué excepciones pueden provocar que no se pueda jugar, aunque la aplicación siga ejecutándose.
Ten en cuenta que, si empiezas a registrar errores graves, es probable que el porcentaje de usuarios sin fallos disminuya, pero la métrica de usuarios sin fallos será más representativa de las experiencias de los usuarios finales con tu aplicación.
¿Qué excepciones se registrarán como errores graves?
Para que Crashlytics registre una excepción no detectada como grave, deben cumplirse las dos condiciones siguientes:
Durante la inicialización en tu aplicación, la propiedad
ReportUncaughtExceptionsAsFataldebe tener el valortrue.Tu aplicación (o una biblioteca incluida) genera una excepción que no se detecta. Las excepciones que se crean, pero no se lanzan, no se consideran no detectadas.
Después de habilitar los informes de excepciones no detectadas como errores graves, ahora tengo muchos errores graves nuevos. ¿Cómo puedo gestionar estas excepciones correctamente?
Cuando empieces a recibir informes de excepciones no detectadas como errores graves, puedes gestionarlas de varias formas:
- Piensa en cómo puedes empezar a detectar y gestionar estas excepciones no detectadas.
- Considera diferentes opciones para registrar excepciones en la consola de depuración de Unity y en Crashlytics.
Detectar y gestionar excepciones lanzadas
Las excepciones se crean y se lanzan para reflejar estados inesperados o excepcionales. Para resolver los problemas que se reflejan en una excepción, se debe devolver el programa a un estado conocido (un proceso que se conoce como gestión de excepciones).
Se recomienda detectar y gestionar todas las excepciones previstas, a menos que el programa no se pueda devolver a un estado conocido.
Para controlar qué tipos de excepciones se detectan y se gestionan con qué código, incluye el código que puede generar una excepción en un bloque try-catch.
Asegúrate de que las condiciones de las instrucciones catch sean lo más específicas posible para gestionar las excepciones concretas de forma adecuada.
Registrar excepciones en Unity o Crashlytics
Hay varias formas de registrar excepciones en Unity o Crashlytics para ayudarte a depurar el problema.
Cuando uses Crashlytics, estas son las dos opciones más habituales y recomendadas:
Opción 1: Imprimir en la consola de Unity, pero no enviar informes a Crashlytics durante el desarrollo o la resolución de problemas
- Imprime en la consola de Unity con
Debug.Log(exception),Debug.LogWarning(exception)yDebug.LogError(exception), que imprimen el contenido de la excepción en la consola de Unity y no vuelven a lanzar la excepción.
- Imprime en la consola de Unity con
Opción 2: Subir a Crashlytics para generar informes consolidados en el panel de control de Crashlytics en las siguientes situaciones:
- Si merece la pena registrar una excepción para depurar un posible evento Crashlytics posterior, usa
Crashlytics.Log(exception.ToString()). - Si una excepción debe notificarse a Crashlytics a pesar de que se haya detectado y gestionado, usa
Crashlytics.LogException(exception)para registrarla como un evento no crítico.
- Si merece la pena registrar una excepción para depurar un posible evento Crashlytics posterior, usa
Sin embargo, si quieres informar manualmente de un evento grave a Unity Cloud Diagnostics, puedes usar Debug.LogException. Esta opción imprime la excepción en la consola de Unity, como la opción 1, pero también genera la excepción (independientemente de si se ha generado o detectado ya). Genera el error de forma no local. Esto significa que, aunque se incluya un bloque Debug.LogException(exception) con bloques try-catch, se producirá una excepción no detectada.
Por lo tanto, llama a Debug.LogException solo si quieres hacer todas estas acciones:
- Para imprimir la excepción en la consola de Unity.
- Para subir la excepción a Crashlytics como un evento grave.
- Para lanzar la excepción, haz que se trate como una excepción no detectada y que se registre en Unity Cloud Diagnostics.
Ten en cuenta que, si quieres imprimir una excepción detectada en la consola de Unity y subirla a Crashlytics como un evento no crítico, debes hacer lo siguiente:
try
{
methodThatThrowsMyCustomExceptionType();
}
catch(MyCustomExceptionType exception)
{
// Print the exception to the Unity console at the error level.
Debug.LogError(exception);
// Upload the exception to Crashlytics as a non-fatal event.
Crashlytics.LogException(exception); // not Debug.LogException
//
// Code that handles the exception
//
}
Asistencia para integraciones
La aplicación también usa el SDK de Google Mobile Ads, pero no se producen fallos
Si tu proyecto usa Crashlytics junto con el SDK de Google Mobile Ads, es probable que los notificadores de fallos interfieran al registrar los controladores de excepciones. Para solucionar el problema, desactiva los informes sobre fallos en el SDK de Mobile Ads llamando a disableSDKCrashReporting.
¿Dónde se encuentra mi conjunto de datos de BigQuery?
Firebase exporta los datos a la ubicación del conjunto de datos que hayas seleccionado al configurar la exportación de datos a BigQuery.
Esta ubicación se aplica tanto al conjunto de datos de Crashlytics como al conjunto de datos de sesiones de Firebase (si se ha habilitado la exportación de datos de sesiones).
Esta ubicación solo se aplica a los datos exportados a BigQuery y no afecta a la ubicación de los datos almacenados para usarlos en el panel de control de Crashlytics de la consola de Firebase o en Android Studio.
No puedes cambiar la ubicación del conjunto de datos después de crearlo, pero puedes copiarlo en otra ubicación o moverlo (volver a crearlo) manualmente a una ubicación diferente. Para obtener más información, consulta el artículo Cambiar la ubicación de las exportaciones actuales.
¿Tienes problemas después de actualizar a la nueva infraestructura de exportación de BigQuery?
A mediados de octubre del 2024, Crashlytics lanzó una nueva infraestructura para la exportación por lotes de datos de Crashlytics a BigQuery.
Todos los proyectos de Firebase se han actualizado automáticamente a la nueva infraestructura de exportación por lotes el 2 de marzo del 2026.
Diferencias importantes entre la infraestructura de exportación antigua y la nueva
La nueva infraestructura admite Crashlytics ubicaciones de conjuntos de datos fuera de Estados Unidos.
Exportación habilitada antes de mediados de octubre del 2024 y actualizada a la nueva infraestructura de exportación: ahora puedes cambiar la ubicación de la exportación de datos.
Exportación habilitada a mediados de octubre del 2024 o más adelante: durante la configuración, se te ha pedido que selecciones una ubicación para la herramienta de exportación de datos.
La nueva infraestructura no admite reposiciones de datos anteriores a la habilitación de la exportación.
La infraestructura antigua permitía reponer datos de hasta 30 días antes de la fecha en que se habilitaba la exportación.
La nueva infraestructura admite rellenos de hasta los últimos 30 días o de la fecha más reciente en la que hayas habilitado la exportación a BigQuery (lo que sea más reciente).
La nueva infraestructura asigna nombres a las tablas por lotes de BigQuery usando los identificadores definidos para tus aplicaciones de Firebase en tu proyecto de Firebase.
La infraestructura antigua escribía datos en tablas por lotes con nombres basados en los IDs de bundle o los nombres de paquete del binario de tu aplicación.
La nueva infraestructura escribe datos en tablas por lotes con nombres basados en los IDs de bundle o los nombres de paquete definidos para tus aplicaciones de Firebase registradas en tu proyecto de Firebase.
Si el nombre de tu tabla de lotes antigua no coincide con el identificador de tu aplicación de Firebase
Si el nombre de tu tabla de lotes antigua no coincidía con el ID de bundle o el nombre de paquete definidos para tu aplicación de Firebase registrada, implementa una de estas opciones para evitar más interrupciones en los datos de lotes exportados.
Cómo usa la infraestructura de exportación los identificadores para escribir datos en las tablas de BigQuery
A continuación, se explica cómo escriben los datos de Crashlytics las dos infraestructuras de exportación en las tablas de lotes de BigQuery:
Infraestructura de exportación antigua: escribía datos en una tabla con un nombre basado en el ID de bundle o en el nombre de paquete del binario de tu aplicación.
Nueva infraestructura de exportación: escribe datos en una tabla con un nombre basado en el ID de bundle o en el nombre del paquete definido para tu aplicación de Firebase registrada en tu proyecto de Firebase.
Lamentablemente, a veces el ID de bundle o el nombre de paquete del binario de tu aplicación no coinciden con el ID de bundle o el nombre de paquete definidos para tu aplicación de Firebase registrada en tu proyecto de Firebase. Esto suele ocurrir si alguien no ha introducido el identificador real durante el registro de la aplicación.
¿Qué ocurre si no se ha solucionado antes de la actualización?
Si los identificadores de estas dos ubicaciones no coinciden, significa que ha ocurrido lo siguiente:
Los datos de Crashlytics ahora se escriben en una nueva tabla de lotes de BigQuery, es decir, una nueva tabla con un nombre basado en el ID de bundle o el nombre de paquete definidos para tu aplicación de Firebase registrada en tu proyecto de Firebase.
Ya no se escriben datos en ninguna tabla antigua que tenga un nombre basado en el identificador del binario de tu aplicación.
Ejemplos de situaciones con identificadores que no coinciden
Ten en cuenta que los nombres de las tablas de lotes de BigQuery se añaden automáticamente con _IOS o _ANDROID para indicar la plataforma de la aplicación.
| Identificadores en el binario de tu aplicación | Identificadores definidos para tus aplicaciones de Firebase | Comportamiento antiguo | Comportamiento después de actualizar a la nueva infraestructura de exportación |
Solución |
|---|---|---|---|---|
foo |
bar |
Escribe en una única tabla que lleva el nombre del identificador del binario de la aplicación (foo)
|
Crea y escribe en una única tabla con el nombre del identificador definido para la aplicación de Firebase (bar)
|
Implementa la opción 1 o la 2, que se describen más abajo. |
foo |
bar, qux, etc. |
Escribe en una única tabla que lleva el nombre del identificador del binario de la aplicación (foo)
|
Crea* y, a continuación, escribe en varias tablas con el nombre de los identificadores definidos para las aplicaciones de Firebase (bar, qux, etc.).
|
Implementa la opción 2 que se describe más abajo. |
foo, baz, etc. |
bar |
Escribe en varias tablas con el nombre de los distintos identificadores del binario de la aplicación (foo, baz, etc.)
|
Crea** y, a continuación, escribe los datos de cada aplicación en una única tabla con el nombre del identificador definido para la aplicación de Firebase (bar)
|
No se puede implementar ninguna de las opciones.
Puedes seguir diferenciando los datos de cada aplicación en la tabla usando el |
* Si el identificador del binario de tu aplicación coincidía con uno de los identificadores definidos para una aplicación de Firebase, la nueva infraestructura de exportación no ha creado una tabla para ese identificador. En su lugar, seguirá escribiendo datos de esa aplicación específica en él. Todas las demás aplicaciones se escribirán en tablas nuevas.
** Si uno de los identificadores del binario de tu aplicación coincidía con el identificador definido para la aplicación de Firebase, la nueva infraestructura de exportación no ha creado una tabla. En su lugar, mantendrá esa tabla y empezará a escribir datos de todas las aplicaciones en ella.
Opciones para mitigar las interrupciones
OPCIÓN 1:
Usa la tabla que cree la nueva infraestructura de exportación. Copiarás los datos de la tabla antigua en la nueva.En la consola de Google Cloud, copia todos los datos de la tabla antigua en la nueva tabla que se ha creado durante la actualización de la infraestructura.
Si tienes dependencias downstream que dependen de tu tabla de lotes, cámbialas para que usen la nueva tabla.
OPCIÓN 2:
Vuelve a configurar la tabla antigua para escribir en ella. Para ello, tendrás que anular algunos valores predeterminados en una configuración de BigQuery.En la consola de Firebase, busca y anota el ID de aplicación de Firebase (por ejemplo,
1:1234567890:ios:321abc456def7890) de la aplicación cuyo nombre de tabla de lote no coincida con el identificador:
Ve a settings Configuración del proyecto y, después, a la tarjeta Tus aplicaciones para ver todas tus aplicaciones de Firebase y su información.En la consola de Google Cloud, cambia la nueva configuración de transferencia de datos que se ha creado con la actualización de la infraestructura para que los datos se escriban en tu tabla antigua:
Ve a BigQuery > Transferencias de datos para ver tu configuración de transferencia de datos.
Selecciona la configuración que tenga la fuente
Firebase Crashlytics with Multi-Region Support.En la esquina superior derecha, haz clic en Editar.
En la sección Detalles de la fuente de datos, busca una lista de gmp_app_id y otra de client_namespace.
En BigQuery, el ID de aplicación de Firebase se denomina
gmp_app_id. De forma predeterminada, el valor declient_namespaceen BigQuery es el ID de bundle o el nombre de paquete único de la aplicación, pero vas a anular esta configuración predeterminada.BigQuery usa el valor
client_namespacepara el nombre de la tabla de lotes en la que escribe cada aplicación de Firebase vinculada.Busca el gmp_app_id de la aplicación de Firebase cuya configuración predeterminada quieras anular. Cambia el valor de client_namespace por el nombre de la tabla en la que quieres que escriba la aplicación de Firebase (normalmente, es el nombre de la tabla antigua en la que escribía la aplicación con la infraestructura de exportación antigua).
Guarda el cambio de configuración.
Programa un backfill para los días en los que falten datos en la tabla antigua.
Una vez que se haya completado el proceso de backfill, elimina la tabla que se haya creado automáticamente con la nueva infraestructura de exportación.