Devtools
Devtools es una herramienta de depuración y análisis en tiempo de ejecución que le permite inspeccionar una aplicación construida con Studio en cualquier dispositivo, y ver sus registros y arrays en tiempo real. Esta herramienta acelera el proceso de detección de problemas de lógica en la construcción y las instancias de control de calidad después de publicar una aplicación.
Devtools se sincroniza con una app ya instalada en tu dispositivo y te permite realizar varias acciones, como:
visualizar la configuración de una app;
ver los registros y arrays en diferentes contextos;
modificar los valores de los registros y arrays para testearlos en tu configuración;
añadir registros y arrays nuevos;
crear capturas de contexto para un momento específico dentro de tu app;
exportar y grabar contextos; y
ejecutar comandos en una consola para implementarlos en tiempo real.
Nota
Devtools admite binarios generados desde ramas 7.6.0 o superiores para móviles, tanto para aplicaciones Android como iOS.
Prerrequisitos
Para ejecutar y probar una app en Devtools, debes cumplir con los siguientes prerrequisitos:
Debes generar los builds de tu app en Mobile Builder con Devtools habilitado. Cuando creas una app. debes añadir el SDK de Devtools e ingresar el API token que brinda el equipo de Support.
Debes descargar la configuración de tu app e instalarla en tu dispositivo.
Importante
Devtools no está disponible en ambientes de producción.
Antes de inspeccionar una app con el navegador Google Chrome, es posible que debas cambiar algunas configuraciones de seguridad para evitar recibir un error de intercambio de recursos de origen cruzado (CORS). Lea Arregla errores de CORS en Chrome a continuación para aprender cómo hacerlo.
Para habilitar Devtools en archivos binarios generados en Mobile Builder, sigue estos pasos:
Crea o edita una app en tu ambiente de Mobile Builder.
En la sección SDKs, haz clic en Add. En el modal que se abre, selecciona Devtools.
Luego de seleccionar una o más plataformas para el SDK (iOS, Android y Harmony), debes ingresar el API token que brinda el equipo de Support en la sección Global del modal.
Finalmente, en Select isQAEnvironment, selecciona False, y añade el SDK a la app.
Nota
Si estás editando una app existente, y el SDK fue previamente configurado, el chip de Devtools aparece en rojo, y debes eliminarlo de la sección SDKs para guardar los cambios en tu app.
Si generas el archivo binario desde la aplicación, copia la propiedad vtua.ini.debug.interfaces=Y y pégala en el archivo de configuración de su binario.
Cuando intentas abrir Devtools en Google Chrome por primera vez, puede que encuentres un error de CORS. Para solucionar este problema, siga estos pasos:
Haz clic en el icono de advertencia Not secure que se encuentra a la izquierda de la URL de DevTools y luego haz click en Site Settings.
En la página Security and Privacy, busca el campo Insecure Content en la sección Permissions y elige Allow.
Accede a la URL detallada en la página principal de Devtools: chrome://flags/#block-insecure-private-network-requests. Busca la sección Block insecure private network requests y selecciona Disabled en el menú desplegable. Reinicia Chrome para aplicar cambios.
Nota
Estas configuraciones se guardan en tu navegador; por eso, solo tienes que seguir estos pasos la primera vez que accedes a Devtools.
Para aprender a navegar por Devtools e inspeccionar aplicaciones, dirígete a Inspeccionar aplicaciones con Devtools.
Acceder y Navegar Devtools
Para acceder a Devtools, inicia sesión en Workspace con tus credenciales, y luego busca el acceso directo a Devtools en lista de componentes a la izquierda de la pantalla. También puedes acceder a Devtools utilizando la URL de tu ambiente e iniciando sesión con tus credenciales.
Cuando inicias sesión, solo se mostrarán los dispositivos que correspondan a tu cliente y que estén disponibles para inspeccionar. Los dispositivos se detectan solo cuando la app está ejecutándose. Si necesitas reducir la lista dispositivos en la sección Devices, utiliza los filtros detallados a continuación.
Search by device name | Introduce una palabra clave para filtrar dispositivos por nombre. |
Platform | Haz clic en el icono desplegable para filtrar dispositivos por plataforma. Las opciones son: Web, Android y iOS. |
Filters | Haz clic para mostrar filtros adicionales que puedes aplicar en tu búsqueda. Las opciones son: client, environment, product code y configuration type. |
Clear all | Haz clic para eliminar todos los filtros aplicados. |
Para conectarse a un dispositivo, abre la aplicación que quieres inspeccionar en el dispositivo y selecciona su tarjeta en la página de inicio de Devtools. Para aprender a inspeccionar, depurar y analizar una aplicación, lee Inspecciona una aplicación con Devtools.