Notas de la versión de Axe DevTools Mobile del 8 de octubre de 2024
8 de octubre de 2024
Versiones de componentes
- SDK de Android (axe-devtools-android v5.6.0)
- Analizador de Android (Axe Accessibility Analyzer v1.9.0)
- Driver de Appium para Android (axe-appium-uiautomator2-driver v1.1.0)
Cómo actualizar: SDK de Android, Analizador de Android Driver de Appium para Android
¿Qué hay de nuevo?
Regla de Acción Inaccesible
Hemos renombrado Vista Accesible Inactiva a Acción Inaccesible para coincidir con el nombre de la regla en iOS. También hemos decidido marcar esta regla como experimental, para poder mejorar la precisión de los resultados en ambas plataformas.
Correcciones
- Actualizaciones para mejorar el rendimiento y la precisión de las siguientes reglas: Contraste de Color, Tamaño del Objetivo Táctil, Etiqueta en el Nombre, Etiqueta al Frente, Nombre de Texto Editable y Control Activo Anidado
- Se añadió el nombre de clase de la vista superpuesta a los valores analizados para la regla de Espaciado del Objetivo Táctil para ayudar con la depuración
- Se revisaron las descripciones de los resultados para que fueran más descriptivas y brindaran una mejor guía sobre cómo solucionar problemas para las reglas de Acción Inaccesible y Etiqueta al Frente
- Se mejoró la estabilidad y la fiabilidad del servicio de accesibilidad. La aplicación ya no volverá a pedir permisos cada vez que se use
- Se optimizaron las solicitudes de red para la carga de resultados al tablero
- Se mejoró el manejo de errores de autenticación en el Driver de Appium
Desaprobaciones
Después de una gran consideración, estamos avanzando hacia una implementación simplificada de Axe DevTools para Android que resultará en la desaprobación de las APIs XML y Compose en una fecha futura. Aunque esta transición no ocurrirá de la noche a la mañana, estamos alentando a los clientes a cambiar gradualmente a las APIs independientes del diseño para continuar recibiendo soporte y tener acceso a las últimas actualizaciones.
Problemas conocidos
Si está experimentando alguno de los siguientes problemas, contáctenos en helpdesk@deque.com o support.deque.com. Podremos notificarlo una vez que se haya resuelto o de una solución alternativa identificada si no hay ninguna listada.
- Las pruebas automatizadas de Axe DevTools Mobile se ejecutan en aplicaciones nativas de iOS, Android nativo y React Native. Por favor, contacte a su representante de Deque para obtener soluciones de pruebas de accesibilidad en su pila tecnológica.
- Aunque puede obtener algunos resultados de vistas web o PDFs renderizados, recomendamos encarecidamente realizar pruebas usando Axe DevTools para Web o Axe Monitor para lograr la prueba de accesibilidad más completa para la web.
iOS
Error en el proyecto de Analyzer y la prueba por ID de paquete en 2.8.1
La funcionalidad para probar una aplicación por identificador de paquete se rompió en la versión 2.8.1, lo que resultó en un error titulado «No se especificó la ruta de la aplicación objetivo a través de la configuración de la prueba: ...». Actualice a la versión 2.8.2 o la más reciente para resolver el error. Actualícese a la última dentro del proyecto de iOS Analyzer.
Falso positivo: LabelInName y LabelAtFront en aplicaciones de SwiftUI y multiplataforma
Algunas pantallas pueden reportar falsos positivos con LabelInName y LabelAtFront debido a que se encuentra una propiedad de texto asociado incorrecta (#1622)
La regla de Soporte para Tipo Dinámico no funciona con el simulador de iOS 15 Pro
Hay un problema que afecta al simulador de iPhone 15 Pro que impide que la regla de Soporte para Tipo Dinámico se ejecute. Si está inscrito en la regla de Soporte para Tipo Dinámico, no podrá probarla usando un simulador de iPhone 15 Pro. Se ha presentado un error a Apple.
Reglas contra controles anidados
Al buscar una mejora para nuestras reglas, encontramos que en XCTest, los controles anidados no se devuelven en el árbol de accesibilidad. Se ha presentado un error a Apple. (#1110)
La regla de Nombre de ImageView necesita que los resultados de revisión sean aplicados a aplicaciones UIKit
En aplicaciones UIKit, una imagen sin una `accessibilityLabel` no es enfocada con tecnología asistiva por defecto.
Las propiedades que usamos para verificar la capacidad de enfoque de Apple pueden ser inexactas cuando se establece un `accessibilityIdentifier` en la imagen. Debido a este comportamiento inesperado, los resultados para problemas de Nombre de ImageView en aplicaciones UIKit se reportarán como Necesita Revisión. Se ha presentado un informe de error a Apple. (#1633)
Falso positivo: En Scroll View, Label In Name, Label al Frente, y v2.11.0 Nombre de ImageView y ActiveControlName
Estamos trabajando activamente en correcciones para los siguientes falsos positivos y actualizaremos esta lista a medida que se lancen las correcciones.
In Scroll View
Pueden reportarse problemas para texto dentro de elementos que actúan como banners. Para que estos elementos estén disponibles para aquellos que requieren texto más grande, use UILargeContentViewer. (#622)
v2.11.0 Image View Name & Active Control Name
Si un UIImageView tiene un `accessibilityIdentifier` establecido pero no es enfocable por VoiceOver, y tiene controles enfocables anidados dentro, ActiveControlName puede reportar un falso positivo en el UIImageView. Eliminar el `accessibilityIdentifier` resuelve el problema. Se ha presentado un error a Apple. (#1633)
Label In Name and Label At Front
Estas dos reglas buscan la etiqueta visible de un control entre elementos cercanos para ayudar a determinar el estado de la regla. En algunas jerarquías de vista, se puede detectar un texto cercano incorrecto causando que estas reglas fallen. (#1622)
Android
Aplicación del Analizador: el botón de acción flotante desaparece
Introducido con API 31 (Android 12) está la capacidad de ocultar superposiciones no relacionadas con el sistema. Para poder utilizar la aplicación Axe Analyzer, asegúrese de que esta configuración no esté activada. Si ha optado por utilizar esta función por sus mejoras de seguridad, recomendamos dejarla desactivada para las versiones de prueba interna donde pueda utilizar datos de prueba de manera segura y eliminar preocupaciones de seguridad de esa manera. Note: this setting does not affect Google's accessibility scanner app as it's considered a system overlay.
Para utilizar la aplicación Axe Accessibility Analyzer, actualice cualquier llamada al método setHideOverlayWindows(true) a setHideOverlayWindows(false) en las ventanas de actividad afectadas.
Captura de pantalla faltante (Caja negra) en el Panel
Para desbloquear toda la funcionalidad de Axe DevTools para Móviles, asegúrese de que las capturas de pantalla estén habilitadas. Recomendamos habilitar las capturas de pantalla en una versión de prueba o depuración de su aplicación que use datos simulados para evitar preocupaciones de seguridad. Consulte nuestra guía para habilitar capturas de pantalla en aplicaciones Android.
Error cuando `minifiedEnabled` está establecido en true
Si minimiza su compilación, verá un error con un registro de error que informa que no se pudo encontrar un adaptador al intentar iniciar sesión en la biblioteca Axe DevTools. Desactive la minimización para sus compilaciones de depuración con Axe DevTools implementado. (#729)
Compilaciones con r8 habilitado arrojan un error
Una compilación con r8 habilitado puede intentar minimizar la biblioteca axeDevTools resultando en un error similar a:
Caused by: java.lang.NullPointerException: throw with null exception
at g.b.b.a$a.a(Unknown Source:1)
at g.b.b.a$a.a(Unknown Source:0)
at g.b.b.a.a(AccessToken.java:190)
To resolve this error add the following line to your ProGuard file to keep axeDevTools classes:keep class com.deque.** { *; }
Mensaje de error similar a:
Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)
o: No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?
Las APIs de Compose están obsoletas, por favor use las APIs agnósticas de diseño para seguir recibiendo actualizaciones. Si continúa utilizando las APIs de Compose y encuentra un error como `Se esperaba exactamente '1' nodo pero se encontraron '2' nodos que satisfacen: (esRoot)` o `No se inicializó la Vista, ¿llamó a AxeDevToolsCompose.setComposeTestRule()?`, por favor consulte el API Compose setTestTag.
Mensaje de registro:MlKitContext has not been initialized
Si encuentra este mensaje, es posible que algunos resultados de reglas no se devuelvan como se esperaba cuando esa regla esté utilizando inteligencia artificial. Las reglas afectadas incluyen Contraste de Color, Texto Enfocable y Nombre de Elemento Anidado. (#841)
MAUI: Regla de Nombre de Texto Editable
Debido a las limitaciones de la arquitectura de la aplicación MAUI al renderizar en el ecosistema de Android, la regla de Nombre de Texto Editable se mostrará como Necesita Revisión en el panel cuando se sospeche de un fallo para la versión SDK 5.5.0 en adelante. Por favor confirme manualmente el comportamiento correcto para este caso.
Android Nativo: Diálogos / Modales Personalizados
Al implementar diálogos o modales personalizados que no extienden los controles nativos, puede obtener resultados para vistas detrás del modal. En este caso, recomendamos no ejecutar nuestra herramienta contra estos modales o diálogos personalizados, y en su lugar revisar manualmente para asegurar que se comportan con la tecnología asistida según lo deseado.
Panel Web
Captura de pantalla faltante
Si la captura de pantalla falta en la página de detalles del análisis, su aplicación puede estar impidiendo que se tomen capturas de pantalla. A menudo esto se debe a razones de seguridad en su aplicación de producción. Considere eliminar este requisito para su compilación de prueba para permitir la funcionalidad completa en el Panel Móvil de Axe DevTools.
Algunos nombres de análisis de Android no están formateados
Algunos nombres de análisis de Android que se predeterminan al título de la pantalla aparecerán como el nombre completo de la clase, incluido el identificador del paquete. En una versión futura, esto se resolverá para que el título de la pantalla se formatee en un nombre más legible. Como solución, puede establecer el nombre del análisis desde el panel o los marcos. (#1643)