Herramienta Mobile Troubleshooting
La herramienta Mobile Troubleshooting es una funcionalidad de seguimiento de errores utilizada en los binarios generados por Veritran, disponible para aplicaciones móviles iOS y Android. Se conecta con la integración de Firebase Crashlytics para registrar información sobre problemas fatales y no fatales (NFI) que podrían afectar la experiencia del usuario con la app.
La solución de problemas establece migas de pan predeterminadas, o logs, que te permiten rastrear la ruta de los usuarios en una app antes de que se bloquee o muestre un error. También captura IDs de sesión con información sobre el usuario y su dispositivo, lo que es útil para analizar y reproducir el problema. La información recopilada se muestra en Crashlytics.
Nota
Firebase Crashlytics puede no estar implementado en tu entorno o habilitado para todos sus clientes. Comunícate con tu administrador para obtener ayuda.
Requisitos previos
Para utilizar la herramienta Mobile Troubleshooting en tu app, necesitas tener Crashlytics integrado con un proyecto en ejecución. Consulta la documentación de Crashlytics y comunícate con su administrador si necesitas ayuda con este paso.
Habilitar la herramienta Mobile Troubleshooting en una app
Para habilitar la herramienta Mobile Troubleshooting, primero debes agregar el SDK de Firebase en Mobile Builder y, a continuación, agregar el Troubleshooting JSON como parámetro global en Studio. Para hacerlo, sigue estos pasos:
Accede a Mobile Builder y dirígete a la sección Applications.
Busca la app en la lista. Puedes usar los filtros que se encuentran arriba de la lista de las apps para acotar tus opciones por cliente y entorno. Haz clic en Actions (ícono de tres puntos verticales a la derecha) > Edit para abrir la página Edit application.
Busca la sección de SDK en la parte inferior de la página Edit application y haz clic en + ADD SDK.
En el panel que se abre, complete la información requerida como se explica en la tabla a continuación.
SDK
Haz clic en la flecha hacia abajo para abrir la lista SDK y selecciona Firebase.
Features
Haz clic en la flecha hacia abajo para abrir las funcionalidades y selecciona Crashlytics.
Google service info plist
Descarga el archivo .plist generado en Firebase para la versión de iOS de tu app y pega su contenido en este campo.
Google services json
Descarga el archivo .json generado en Firebase para la versión de Android de tu app y pega su contenido en este campo.
Haz clic en Add para terminar con el proceso y cierra el panel Add SDK.
En la página Edit application, haz clic en Save para aplicar los cambios que realizaste en tu app.
Nota
Algunos entornos pueden tener este SDK habilitado de forma predeterminada. Si tienes dudas, comunícate con tu administrador.
Una vez que hayas agregado el SDK, puedes generar la compilación de tu app. Consulta Mobile Builder si necesitas más información sobre este último paso.
Accede a Studio, navega hasta tu rama y dirígete a General > Parameters
Haz clic en + New Parameter.
Completa la información requerida como se explica en la tabla a continuación:
Id
Introduce TROUBLESHOOTING_CONFIGURATION.
Description
Introduce una descripción del nuevo parámetro global.
Type
Haz clic en la flecha hacia abajo y selecciona String.
Value
Añade la configuración JSON. Lee Configuración JSON para aprender a personalizarlo según tus necesidades.
{"default":{"allowNFI":["CRITICAL","WARNING","INFO","MISSING_RESOURCES","CUSTOM"],"allowBreadcrumbs":["LAUNCH","CONFIGURATION","VIEW","PROCESS","CALL_API","INFO","EXCEPTION","CUSTOM"],"toolsDefault":["FIREBASE_CRASHLYTICS"]},"overrideImplementation":[{"tool":"FIREBASE_CRASHLYTICS","allowNFI":["CRITICAL","WARNING","CUSTOM"],"allowBreadcrumbs":["LAUNCH","PROCESS","CALL_API","CUSTOM"]}]}{"default":{"allowNFI":["CRITICAL","WARNING","INFO","MISSING_RESOURCES","CUSTOM"],"allowBreadcrumbs":["LAUNCH","CONFIGURATION","VIEW","PROCESS","CALL_API","INFO","EXCEPTION","CUSTOM"],"toolsDefault":["FIREBASE_CRASHLYTICS"]},"overrideImplementation":[{"tool":"FIREBASE_CRASHLYTICS","allowNFI":["CRITICAL","WARNING","CUSTOM"],"allowBreadcrumbs":["LAUNCH","PROCESS","CALL_API","CUSTOM"]}]}Scope
Selecciona Global.
Haz clic en Save para finalizar.
Nota
Algunos entornos pueden incluir este parámetro global por defecto. Si tienes dudas, comunícate con tu administrador.
Una vez que hayas completado estos pasos, puedes comenzar a rastrear las migas de pan, los problemas no fatales y las propiedades de sesión con Crashlytics.