Tutorial de UIAutomatorViewer: Inspector de Android Pruebas

Por: Tomas Hamilton Tomas Hamilton
Hours Actualizado

⚡ Resumen inteligente

UIAutomatorViewer es un inspector gráfico incluido con el Android SDK que captura una captura de pantalla del dispositivo, renderiza la jerarquía de vistas y expone los atributos. Appium Necesita localizar botones, campos y etiquetas de forma fiable.

  • 🔘 Qué hace: Escanea una vida Android La pantalla muestra la jerarquía de nodos junto a una hoja de propiedades del elemento seleccionado.
  • ☑️ Donde vive: El lanzador se encuentra en el Android Carpeta de herramientas SDK como uiautomatorviewer.bat y se inicia un Java ventana de escritorio.
  • ✅ Flujo de captura: Active las opciones de desarrollador, conecte el dispositivo mediante USB y, a continuación, pulse Captura de pantalla del dispositivo para cargar la pantalla actual.
  • 🧪 Mapa de atributosping: El texto se convierte en nombre, resource-id se convierte en id, class se convierte en className y content-desc se convierte en el id de accesibilidad.
  • 🛠️ Solución de Problemas: El mensaje “No Android El mensaje "Los dispositivos fueron detectados por adb" casi siempre apunta a un cable, un controlador o una configuración de depuración.
  • 📊 Opción moderna: Appium El inspector cubre Android y iOS, y sigue estando disponible después de que se retirara el paquete de herramientas SDK anterior.
Descubre más

Inspector UIAutomatorViewer para Android prueba de aplicaciones

¿Qué es UIAutomatorViewer?

UIAutomatorViewer es una herramienta GUI para escanear y analizar los componentes de la interfaz de usuario de un Android aplicación. Para automatizar cualquier Android aplicación usando Appium, un usuario necesita identificar los objetos en la AUT (Aplicación bajo prueba). Con UIAutomatorViewer puede inspeccionar la interfaz de usuario de una Android Aplicación para averiguar la jerarquía y ver diferentes propiedades (id, texto…) del elemento.

Mientras ejecuta scripts de automatización, Appium Utiliza UIAutomatorViewer para identificar las distintas propiedades del objeto y, a partir de ellas, identificar el objeto deseado. Esta idea —leer el atributo en el inspector y reutilizarlo como localizador en el script— es la que se explica en detalle en el resto de esta página.

La captura de pantalla que aparece a continuación muestra la herramienta en su estado de funcionamiento normal: la pantalla del dispositivo capturada a la izquierda, el árbol de nodos en la parte superior derecha y la hoja de propiedades del nodo seleccionado debajo.

Ventana de UIAutomatorViewer que muestra la pantalla del dispositivo capturada, el árbol de jerarquía de nodos y el panel de detalles del nodo.

Requisitos previos para usar UIAutomatorViewer

El inspector lee la pantalla en tiempo real de un teléfono real o un emulador, por lo que es necesario realizar una pequeña configuración antes de que la ventana muestre algo.

  • A Java Kit de desarrollo: uiautomatorviewer es un Java La aplicación de escritorio se inicia mediante un script por lotes, por lo que es necesario tener instalado un JDK y que este sea accesible en la ruta del sistema.
  • El Android SDK: El visor se incluye dentro del SDK. carpeta, por lo que el SDK debe instalarse antes de que el lanzador exista en el disco.
  • Herramientas de plataforma y adb: El espectador habla con el dispositivo a través del Android Debug Bridge, así que adb Debe estar instalado y poder ver el teléfono.
  • Opciones para desarrolladores y depuración USB: Ambas opciones deben estar activadas en la configuración del dispositivo; de lo contrario, adb nunca mostrará el dispositivo en la lista.
  • Un cable USB con capacidad de transferencia de datos y un controlador: un cable solo de carga o un controlador del fabricante faltante en Windows, produce una lista de dispositivos vacía.
  • La aplicación bajo prueba: La aplicación debe estar instalada y abierta en el dispositivo, ya que el inspector captura todo lo que se muestra en la pantalla.

Una vez configurados esos seis elementos, el paso de descarga es breve.

Cómo descargar e instalar UIAutomatorViewer

UIAutomatorViewer forma parte de Android Administrador de SDK y estará accesible una vez que instale el administrador de SDK. Descargue e instale el Android SDK de el oficial Android Studio Página de descarga.

Una vez que la Android El SDK está instalado, navegue por esta ruta:

c:\users\<username>\AppData\Local\Android\sdk\tools

Observará un archivo por lotes con este nombre:

uiautomatorviewer.bat

Double Haz clic en él para abrir la interfaz gráfica de usuario de UIAutomatorViewer. La lista de carpetas se ve como la que aparece a continuación, con el archivo por lotes junto a las demás herramientas del SDK.

Android carpeta de herramientas SDK en Windows Explorador que contiene el lanzador por lotes uiautomatorviewer

⚠️ Nota de versión: AndroidLa propia documentación heredada de UI Automator todavía describe el lanzamiento de la herramienta desde /herramientas/pero el obsoleto independiente Android Herramientas SDK El paquete ya no se ofrece a través del SDK Manager en la versión actual. Android Studio versiones. Las instalaciones antiguas y los archivos SDK más antiguos todavía contienen el lanzador; en una instalación nueva, el archivo generalmente no está presente, y Appium Inspector es la alternativa práctica. Los pasos originales descritos anteriormente se mantienen porque siguen siendo válidos para cualquier máquina que aún conserve la carpeta de herramientas.

Cómo usar UIAutomatorViewer para encontrar objetos en tu aplicación

La secuencia de captura es siempre la misma: prepare el dispositivo, coloque la pantalla que le interesa frente a la cámara y, a continuación, tome la fotografía.

  1. Activar opciones de desarrollador en tu dispositivo. Leer AndroidGuía para configurar las opciones de desarrollador en el dispositivo para ver cómo habilitar las opciones de desarrollador en Android dispositivos.
  2. Conecte su Android conectar el dispositivo al PC mediante un cable USB.
  3. Seleccione la opción "GuruAplicación "99" de la lista de aplicaciones, como se muestra a continuación.

Guru99 solicitudes seleccionadas de entre las Android lista de aplicaciones del dispositivo

  1. Haga clic en el botón Captura de pantalla del dispositivo botón para actualizar UIAutomatorViewer y cargar el Guru99 aplicaciones GUI en la herramienta. El botón se encuentra en la barra de herramientas resaltada a continuación.

Botón de la barra de herramientas de captura de pantalla del dispositivo utilizado para actualizar la captura de UIAutomatorViewer

  1. Una vez completada la actualización, se mostrará una captura de pantalla de la GuruLa aplicación 99 se abre en el panel izquierdo.

capturado GuruSe cargó la pantalla de la aplicación 99 en el panel izquierdo de UIAutomatorViewer.

  1. Como ve en la imagen de arriba, en el lado derecho de la ventana hay 2 paneles.

El panel superior muestra la jerarquía de nodos: la forma en que se organizan y contienen los componentes de la interfaz de usuario. Al hacer clic en cada nodo, se muestran las propiedades de ese elemento de la interfaz de usuario en el panel inferior.

  1. Seleccione el botón "Cuestionario" en la imagen superior para ver sus diferentes propiedades (texto, ID de recurso...).

Botón de cuestionario seleccionado en el árbol de nodos con sus propiedades listadas en el panel de detalles inferior.

ARTÍCULOS RELACIONADOS

Cómo utilizar estas propiedades para identificar elementos para la automatización

Bueno, no puedes usar las propiedades directamente; cada propiedad tiene otro nombre en la API de automatización. Veamos cómo hacer funcionar esos valores de propiedad. Los siguientes atributos se pueden usar para identificar el botón 'Cuestionario' en el Guru99 aplicaciones.

Atributo en UIAutomatorViewer Nombre del localizador en el script Uso típico
envíenos mensaje de texto nombre Etiqueta visible en un botón o un campo estático.
ID de recurso id La opción más estable cuando el desarrollador establece una
clase nombre de la clase Seleccionar un grupo de widgets del mismo tipo.
contenido-desc ID de accesibilidad Localizador multiplataforma que también ayuda a los lectores de pantalla.

Cada mapaping es visible directamente en el panel de detalles del nodo. envíenos mensaje de texto El atributo se puede usar como "nombre", como muestra la fila de propiedades a continuación.

Fila de detalles del nodo que muestra el valor del atributo de texto utilizado como localizador de nombre.

El ID de recurso El atributo se puede utilizar como “id”.

Fila de detalles del nodo que muestra el valor del atributo resource-id utilizado como localizador de ID.

El clase El atributo se puede utilizar como “className”.

Fila de detalles del nodo que muestra el valor del atributo de clase utilizado como localizador className.

El contenido-desc El atributo se puede utilizar como “AccessibilityId”.

Fila de detalles del nodo que muestra el valor del atributo content-desc utilizado como localizador del ID de accesibilidad.

Junto con los atributos anteriores, podemos escribir XPaths para la identificación de objetos. Esos nombres de atributos también son los que se pasan. capacidades deseadas y estrategias de localización una vez que el script esté en ejecución.

Cómo crear localizadores XPath a partir de atributos de UIAutomatorViewer

XPath es la alternativa cuando ningún atributo es único por sí solo. El panel de detalles del nodo proporciona todos los valores que necesita la expresión, por lo que XPath es simplemente el atributo que ya se ha leído, escrito en forma de predicado.

Siga los pasos del panel en este orden:

  1. Seleccione el nodo en el panel superior y lea su clase, envíenos mensaje de texto, ID de recurso y contenido-desc valores en el panel inferior.
  2. Prefiera un único atributo estable. Si resource-id está completo, úselo y listo; no se necesita XPath.
  3. Si ninguno es único, combine dos atributos en un solo predicado.
  4. Si la etiqueta cambia en tiempo de ejecución, cambie la prueba de igualdad para una coincidencia parcial.

Los patrones que se muestran a continuación utilizan los nombres de los atributos exactamente como los informa UIAutomatorViewer.

<!-- match on the visible label -->
//*[@text='Quiz']

<!-- match on the resource-id reported by the viewer -->
//*[@resource-id='com.example.app:id/quiz_button']

<!-- match on the widget class -->
//android.widget.Button[@text='Quiz']

<!-- partial match when the label is dynamic -->
//*[contains(@text,'Qui')]

<!-- two attributes combined for a unique match -->
//*[@class='android.widget.Button' and @content-desc='Quiz']

Unas pocas reglas evitan que estas expresiones se vuelvan frágiles. Las rutas absolutas que recorren todo el árbol se rompen en el momento en que un desarrollador envuelve un diseño en un contenedor más, así que comience cada expresión con la doble barra y haga coincidir con un atributo en su lugar. Los predicados basados ​​en índices se comportan de la misma manera: sobreviven hasta que la pantalla gana una fila. Y una expresión que es única en la pantalla de un teléfono puede coincidir con varios nodos en el diseño de una tableta, así que vuelva a inspeccionar la misma pantalla en ambos factores de forma antes de promover el localizador a un conjunto. La misma disciplina se aplica a XPath en Seleniumdonde el árbol es un DOM en lugar de una jerarquía de vistas.

Errores que se pueden encontrar al usar UIAutomatorViewer

La mayoría de los fallos se producen antes de que se dibuje un solo nodo, y casi todos tienen que ver con la conexión entre la estación de trabajo y el teléfono móvil.

  • Veo el error: “No Android Los dispositivos fueron detectados por adb, como se muestra en la captura de pantalla a continuación. ¿Cómo puedo solucionar esto?

El cuadro de diálogo UIAutomatorViewer informa que no Android Los dispositivos fueron detectados por adb

La Solución: Asegúrese de que su dispositivo esté conectado al PC.

La tabla que aparece a continuación amplía esa respuesta a los demás mensajes con los que los evaluadores interactúan con mayor frecuencia.

Síntoma Causa probable Solución
No Android Los dispositivos fueron detectados por adb Dispositivo no conectado, depuración USB desactivada o cable solo de carga. Vuelva a conectar con un cable de datos, habilite la depuración USB y, a continuación, confirme que el dispositivo aparece en la lista de dispositivos adb.
Dispositivo catalogado como no autorizado La solicitud de huella dactilar RSA nunca fue aceptada en el teléfono. Desbloquea la pantalla, vuelve a conectar y pulsa Permitir depuración USB.
Falta el archivo uiautomatorviewer.bat El paquete de herramientas SDK obsoleto no está instalado. Utilice una instalación de SDK existente que aún lo contenga, o cambie a Appium Inspector
La jerarquía está vacía o la captura falla. La pantalla cambió durante el volcado de memoria o la aplicación bloquea la captura de pantalla. Mantén la pantalla quieta y vuelve a tomar la captura de pantalla; las pantallas seguras no se pueden capturar.
El contenido de WebView se muestra como un único nodo. El visor solo lee vistas nativas Inspeccione el contenido web con las herramientas para desarrolladores del navegador o con un inspector que admita el contexto web.

UIAutomatorViewer vs Appium Inspector vs. Inspector de maquetación

Se suelen utilizar tres inspectores contra Android pantallas, y resuelven problemas ligeramente diferentes.

Criterio UIAutomatorViewer Appium Inspector Android Studio Inspector de diseño
Se envía con El legado Android paquete de herramientas SDK Una aplicación de escritorio independiente Android Studio
Plataformas inspeccionadas Android único Android y iOS Android único
Necesita un servidor en funcionamiento. No, se comunica directamente con adb. Sí, se conecta a un Appium sesión del servidor No, se adjunta a un proceso depurable.
Genera código de localización No, los valores se copian manualmente. Sí, sugiere localizadores y puede registrar acciones. No, es una vista de depuración.
Mejores adecuados para Una búsqueda rápida de atributos en una configuración anterior. Creación y validación de localizadores para una suite Diagnóstico de problemas de diseño y renderizado

Para una suite que ya se ejecuta a través de AppiumEl Inspector es el sucesor natural: lee los mismos atributos, ejecuta el mismo controlador UiAutomator2 en segundo plano y también funciona con iOS. Appium Proyecto Inspector Se lanza activamente, por lo que es la opción más segura para trabajos nuevos, mientras que Layout Inspector sigue siendo útil cuando la pregunta es por qué una vista se muestra de forma extraña en lugar de cómo abordarlo. Si aún está eligiendo una pila, la comparación más amplia en nuestra guía para herramientas de prueba de aplicaciones móviles es un buen siguiente paso, y Ejemplos de casos de prueba para dispositivos móviles mostrar a qué se destinan finalmente estos localizadores.

Preguntas Frecuentes

Solo parcialmente. El visor lee la jerarquía de vistas nativa, por lo que un WebView suele aparecer como un nodo opaco. Inspeccione el HTML que contiene con las herramientas para desarrolladores del navegador o utilice un inspector que permita cambiar al contexto web.

No. La herramienta está vinculada a la Android Debug Bridge y el Android jerarquía de vistas. Para pantallas de iOS utilice Appium Inspector or XcodeEl inspector de accesibilidad de XCUITest, que en su lugar leía el árbol de elementos.

El comando escribe la misma jerarquía en un archivo XML en el dispositivo, sin gráficos. Es útil en scripts y en máquinas sin interfaz gráfica, pero se pierde la superposición de capturas de pantalla que facilita la búsqueda del nodo correcto.

Los motores de localización basados ​​en aprendizaje automático evalúan varios atributos en conjunto (texto, clase, posición y nodos vecinos) y vuelven a identificar el elemento cuando alguno de ellos cambia. Este comportamiento de autorreparación reduce los fallos causados ​​por un ID renombrado.

Sí. Pega los valores de los atributos en un comentario y Copilot normalmente generará el campo del objeto de página y el método de clic correspondientes. Siempre verifica el localizador generado comparándolo con la pantalla en vivo, ya que la sugerencia es una suposición, no una búsqueda.

No. El visor funciona con la versión instalada en el dispositivo, por lo que se puede inspeccionar un APK que no hayas compilado. Solo se mostrarán los atributos que el desarrollador haya configurado, como resource-id y content-desc.

Sí. Un emulador se comporta como un teléfono físico en adb, por lo que el botón de captura de pantalla del dispositivo lo captura de la misma manera. Los emuladores son útiles para la programación inicial, aunque las pruebas finales deben realizarse en hardware real.

Asigna a cada control un identificador estable e independiente del idioma que funciona como identificador de accesibilidad en un script y como la etiqueta que anuncia un lector de pantalla. La fiabilidad de las pruebas y la accesibilidad mejoran con un solo cambio de una línea.

Resumir este post con: