Notas de la versión de axe DevTools Mobile del 24 de septiembre de 2025

iOS 26 contiene un error de accesibilidad por el cual los botones de stepper predeterminados no anuncian "atenuado" mediante la Tecnología de Asistencia para indicar que no están habilitados. Como resultado, las reglas de iOS también ven estos botones como habilitados, incluso si no lo están. Se ha presentado un informe de error a Apple, pero hasta que esto se resuelva, las siguientes reglas pueden mostrar resultados en botones paso a paso deshabilitados: AssociatedText, InaccessibleAction y ColorContrast.

Hasta que Apple corrija este error, la solución será ignorar las reglas(ios-ignore-rule). Los botones paso a paso predeterminados tienen los identificadores "Decrement" e "Increment", y pueden ignorarse por identificador si es necesario.

Nuestra regla de Contraste de color depende del aprendizaje automático para detectar texto, lo que garantiza que el texto escaneado sea visible para los usuarios de su aplicación. En los casos en que el texto contenido en una vista es del mismo color que el fondo, nuestro algoritmo de aprendizaje automático no puede detectar si hay texto presente, por lo que la regla de Contraste de color no se ejecuta en esta vista.

Una configuración en el Analizador de iOS 1.4.7 impide que se ejecuten escaneos y devuelve el mensaje "Prueba fallida". Para ejecutar escaneos en un dispositivo físico, actualice al último proyecto del Analizador de iOS.

La funcionalidad de probar aplicaciones mediante ID de paquete se rompió en la versión 2.8.1, lo que resultó en un error titulado "No target application path specified via test configuration: ...". Actualice a 2.8.2 o la última versión para resolver el error. Actualización a la última versión del proyecto iOS Analyzer.

Al escanear algunas aplicaciones con esta versión del analizador y del SDK, se producía un error "Could not Serialize AxeResult". Actualice a la última versión para resolver el error. Actualice al último proyecto del Analizador de iOS.Actualice al último SDK de iOS.

Algunas pantallas pueden informar falsos positivos con LabelInName y LabelAtFront debido a que se encontró una propiedad associatedText incorrecta (#1622)

Hay un problema que afecta al simulador de iPhone 15 Pro que impide que se ejecute la regla Supports Dynamic Type. Si ha optado por la regla Supports Dynamic Type, no podrá probarla usando un simulador de iPhone 15 Pro. Se ha informado de un error a Apple.

Mientras buscábamos una mejora para nuestras reglas, descubrimos que en XCTest, los controles anidados no se devuelven en el árbol de accesibilidad. Se ha informado de un error a Apple. (#1110)

En las aplicaciones UIKit, una imagen sin accessibilityLabel no se puede enfocar con tecnología de asistencia de forma predeterminada.
Las propiedades que usamos para verificar la enfocabilidad de Apple pueden ser inexactas cuando se configura un accessibilityIdentifier en la imagen. Debido a este comportamiento inesperado, los resultados de los problemas de ImageView Name en las aplicaciones UIKit se informarán como Necesita revisión. Se ha enviado un informe de error a Apple. (#1633)

Estamos trabajando activamente para corregir los siguientes falsos positivos y actualizaremos esta lista a medida que se publiquen las correcciones.

En Scroll View
Puede informar problemas de texto dentro de elementos que funcionan como banners. Para que estos elementos estén disponibles para aquellos que requieren un texto más grande, utilice UILargeContentViewer. (#622)

v2.11.0 Image View y nombre del control activo
Si UIImageView tiene un accessibilityIdentifier establecido pero VoiceOver no puede enfocarlo y tiene controles enfocables anidados dentro de él, ActiveControlName puede informar un falso positivo en UIImageView. Quitar el accessibilityIdentifier resuelve el problema. Se ha informado de un error a Apple. (#1633)

Etiqueta en el nombre y etiqueta al principio
Estas dos reglas buscan la etiqueta visible de un control entre los elementos cercanos para ayudar a determinar el estado de la regla. En algunas jerarquías de visualización, se puede detectar texto cercano incorrecto, lo que provoca que estas reglas fallen. (#1622)

Nuestra regla de Contraste de color depende del aprendizaje automático para detectar texto, lo que garantiza que el texto escaneado sea visible para los usuarios de su aplicación. En los casos en que el texto contenido en una vista es del mismo color que el fondo, nuestro algoritmo de aprendizaje automático no puede detectar si hay texto presente, por lo que la regla de Contraste de color no se ejecuta en esta vista.

Las aplicaciones escritas con XML que utilizan la función de texto de sugerencia pueden ver falsos positivos con la EditTextName regla. El texto de sugerencia no se introdujo hasta Android 8 (SDK 26). Al usar este elemento en su aplicación XML, se asignará el texto de sugerencia al valor del campo de entrada de texto. Las versiones más recientes de Android están mejor equipadas para hacer que esta experiencia sea accesible.

Para solucionar este problema, nuestra primera recomendación es ejecutar las pruebas en versiones más nuevas de Android. Sin embargo, si es importante que la aplicación sea accesible en versiones anteriores de Android, podrías considerar evitar el uso de la hintText función, ya que no es compatible oficialmente.

Es posible que vea resultados de vistas que están ocultas detrás de otras vistas en la pantalla. Estas vistas ocultas no están disponibles para la tecnología de asistencia, pero axe DevTools Mobile aún las informa como problemas.

Estamos trabajando para solucionar este complejo problema. Mientras tanto, si TalkBack no puede alcanzar estas vistas, puedes ignorar los problemas correspondientes. No requieren ninguna reparación para garantizar la accesibilidad.

La detección de texto de ML Kit es necesaria en muchas de las reglas de axe DevTools Mobile para garantizar la precisión de los resultados. La biblioteca ML Kit debe importarse automáticamente al hacer referencia a axe DevTools Mobile en sus pruebas automatizadas de Espresso o UIAutomator. Sin embargo, en algunos casos, la importación automática no se realiza y verá el siguiente error en el logcat:

Para solucionar este problema, debes importar la biblioteca ML Kit a tu proyecto manualmente. En el archivo de tu aplicación, agregue lo siguiente en dependencias: build.gradle

La regla de espaciado de área táctil no se ejecuta actualmente en ningún componente de control deslizante escrito en Jetpack Compose. No se puede realizar ninguna acción en este momento. ¡Sin embargo, pronto habrá una solución!

En la API 30 de Android, una de las ubicaciones donde intentamos guardar los resultados localmente tiene un error de permisos. El resultado se guardará como un archivo JSON a pesar de que se muestre este error. El error se puede eliminar comentando el código en el siguiente bloque:
def clearDirectoryTask = task('clearDirectoryTask', type: Exec, group: 'reporting') {
executable "${android.getAdbExecutable().toString()}"
args 'shell', 'rm', '-r', '/storage/emulated/0/Documents/AxeTestCases'
// finalizedBy {
// fetchAndroidFolderAxeReportsTask
// }
}

Tenga en cuenta que este código solo debe comentarse para API 30, ya que causará problemas al guardarlo localmente para otros niveles de API.

En algunas aplicaciones híbridas y multiplataforma, es posible que devolvamos resultados inesperados cuando los elementos en una vista de desplazamiento estén parcialmente fuera de la pantalla. Para probar la accesibilidad de un elemento, asegúrese de que esté completamente en pantalla antes de realizar el escaneo.

Con la API 31 (Android 12) se introdujo la capacidad de ocultar superposiciones que no son del sistema. Para 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 mantenerla desactivada para compilaciones de pruebas internas, donde puede utilizar datos de prueba de forma segura y eliminar problemas de seguridad de esa manera. Nota: esta configuración no afecta a la aplicación de escáner de accesibilidad de Google, ya que se considera una superposición del sistema.

Para utilizar la aplicación Axe Accessibility Analyzer, actualice todas las llamadas al método setHideOverlayWindows(true) a setHideOverlayWindows(false) en las ventanas de actividad afectadas.

Para desbloquear la funcionalidad completa de axe DevTools para dispositivos móviles, asegúrese de que las capturas de pantalla estén habilitadas. Recomendamos habilitar capturas de pantalla en una versión de depuración o prueba de su aplicación que use datos simulados para evitar problemas de seguridad. Consulta nuestra guía para habilitar capturas de pantalla en aplicaciones de Android.

Si minimiza su construcción, verá un cierre inesperado con un registro de error que informa que no se pudo encontrar un adaptador al intentar iniciar sesión en la biblioteca DevTools de axe. Deshabilite la minimización para sus construcciones de depuración con axe DevTools implementado. (#729)

Una construcción con r8 habilitado puede intentar minimizar la biblioteca axeDevTools, lo que genera un error similar al siguiente:
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)
Para resolver este error, agregue la siguiente línea a su archivo ProGuard para mantener las clases axeDevTools:
keep class com.deque.** { *; }

Las API de Compose están obsoletas; utilice las API independientes del diseño para seguir recibiendo actualizaciones. Si continúa usando las API de Compose y encuentra un error similar a `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)` o `No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?`, consulte la API setTestTag de Compose.

Si aparece este mensaje, es posible que algunos resultados de las reglas no aparezcan como se esperaba cuando esa regla utiliza inteligencia artificial. Las reglas afectadas incluyen Contraste de color, Texto con foco y Nombre de elemento anidado. (#841)

Debido a las limitaciones del renderizado de la arquitectura de la aplicación MAUI en el ecosistema Android, la regla Editar nombre de texto se mostrará como Necesita revisión en el panel cuando se sospeche de una falla en la versión 5.5.0 y posteriores del SDK. Confirme manualmente el comportamiento correcto para este caso.

Al implementar cuadros de diálogo o ventanas modales personalizadas que no amplían los controles nativos, puede que obtenga resultados de las vistas que se encuentran detrás de la ventana modal. En este caso, recomendamos no ejecutar nuestra herramienta en estas ventanas modales o cuadros de diálogo personalizados y, en su lugar, verificarlos manualmente para garantizar que se comporten con la tecnología de asistencia como se desea.

Si la captura de pantalla falta en la página de detalles del escaneo, es posible que tu aplicación esté impidiendo que se tomen capturas de pantalla. A menudo, esto se debe a razones de seguridad en tu aplicación de producción. Considere eliminar este requisito para su compilación de prueba para permitir la funcionalidad completa en el Dashboard de axe DevTools Mobile.

• Android - FLAG_SECURE

Algunos nombres de escaneo de Android que están predeterminados en el título de la pantalla aparecerán como el nombre de clase completo, incluido el identificador del paquete. En una versión futura, se resolverá este problema para que el título de la pantalla tenga un formato más legible. Como solución alternativa, puede configurar el nombre del análisis desde el panel de control o los frameworks. (#1643)