Notas de la Versión de Axe DevTools Mobile, 19 de diciembre de 2025

Al ejecutar verificaciones de accesibilidad en pantallas más pequeñas o con tamaños de fuente más pequeños, la regla de Contraste de Color puede reportar falsos positivos para fondos degradados. En tales casos, puede no ser capaz de determinar el color de primer plano y, en su lugar, comparar los colores de fondo entre sí, resultando en un fallo.

Para solucionar este problema, intente ejecutar verificaciones de accesibilidad en dispositivos más grandes. Alternativamente, puede optar por ignorar la regla en sus pruebas y verificar manualmente el Contraste de Color para estas vistas.

Las API de accesibilidad de Apple pueden informar incorrectamente el contenido web dentro de WKWebView como "isVisible", incluso cuando la vista web está cubierta por superposiciones nativas (como vistas modales, alertas u otros elementos de UI nativos). Esto ocurre porque el sistema de accesibilidad verifica si el contenedor de WKWebView mismo es visible, en lugar de si su contenido web está realmente desobstruido y es perceptible para el usuario.

iOS 26 contiene un error de accesibilidad donde los botones de los steppers predeterminados no anuncian "atenúa" por parte de 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 registrado un informe de error con Apple, pero hasta que esto se solucione, las siguientes reglas pueden reportar resultados en los botones de steppers deshabilitados: AssociatedText, InaccessibleAction, y ColorContrast.

Hasta que Apple solucione este error, la resolución será [ignorar las reglas](ios-ignore-rule). Los botones de steppers predeterminados tienen los identificadores "Decrementar" e "Incrementar", y se pueden ignorar por identificador si es necesario.

Our Color Contrast rule depends on Machine Learning to detect text, which ensures that the text being scanned is visible to users of your application. In cases where the text contained in a view is the same color as the background, our Machine Learning algorithm is unable to detect if any text is present, so the Color Contrast rule does not run on this view.

Algunas pantallas pueden reportar falsos positivos con LabelInName y LabelAtFront debido a una propiedad associatedText incorrecta encontrada (#1622)

Hay un problema que afecta al simulador de iPhone 15 Pro que impide que la regla Supports Dynamic Type se ejecute. Si está inscrito en la regla Supports Dynamic Type, no podrá probarla usando un simulador iPhone 15 Pro. Se ha registrado un informe de error con Apple.

Al buscar una mejora para nuestras reglas, encontramos que en XCTest, los controles anidados no se devuelven en el árbol de accesibilidad. Se ha registrado un informe de error con Apple. (#1110)

En aplicaciones UIKit, una imagen sin un accessibilityLabel no es focalizable con tecnología de asistencia por defecto.
Las propiedades que utilizamos para verificar la focalización de Apple pueden ser inexactas cuando un accessibilityIdentifier está configurado en la imagen. Debido a este comportamiento inesperado, los resultados de los problemas de Nombre de ImageView en aplicaciones UIKit se informarán como Necesita Revisión. Se ha registrado un informe de error con Apple. (#1633)

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

In Scroll View
Puede reportar problemas para texto dentro de elementos que se comportan como banners. Para hacer 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 accesible por VoiceOver, y tiene controles accesibles anidados dentro de él, ActiveControlName puede reportar un falso positivo en el UIImageView. Eliminar el accessibilityIdentifier resuelve el problema. Se ha registrado un error con Apple. (#1633)

Label In Name and Label At Front
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 vista, podría detectarse texto incorrecto cercano causando 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 analizado 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 en 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). Usar este elemento en su aplicación XML 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 accesible esta experiencia.

Para superar este problema, nuestra primera recomendación es ejecutar sus pruebas en versiones más recientes de Android. Sin embargo, si es importante que la aplicación sea accesible en versiones anteriores de Android, podría considerar evitar el uso de la hintText función, ya que no está oficialmente soportada.

Puede ver resultados para 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 reporta como problemas.

Estamos trabajando en una solución para este problema complejo. Mientras tanto, si TalkBack no puede acceder a estas vistas, puede ignorar los problemas correspondientes. No requieren una solució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 debería importarse automáticamente al referenciar Axe DevTools Mobile en sus pruebas automatizadas de Espresso o UIAutomator. Sin embargo, en algunos casos la importación automática no ocurre y verá el siguiente error en el logcat:

Para resolver este problema, debe importar manualmente la biblioteca ML Kit en su proyecto. En el build.gradle archivo de su aplicación, agregue lo siguiente bajo dependencias:

La regla de Espaciado del Objetivo Táctil no se está ejecutando actualmente en ningún componente deslizante que haya sido escrito en Jetpack Compose. No se puede tomar ninguna acción en este momento. ¡Sin embargo, una solución viene pronto!

En Android API 30, una de las ubicaciones en las que intentamos guardar resultados localmente tiene un error de permisos. El resultado aún se guardará como un archivo JSON a pesar de que se muestre este error. El error se puede suprimir 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 guardar localmente para otros niveles de API.

En algunas aplicaciones híbridas y multiplataforma, podríamos devolver resultados inesperados cuando los elementos en una vista de desplazamiento están parcialmente fuera de pantalla. Para probar un elemento en busca de accesibilidad, asegúrese de que esté completamente en pantalla antes de realizar la prueba.

Con la API 31 (Android 12) se introdujo la capacidad de ocultar superposiciones no del sistema. Para utilizar la aplicación Analizador de Axe, 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 internas de prueba 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 Analizador de Accesibilidad de Axe, actualice cualquier llamada al método setHideOverlayWindows(true) a setHideOverlayWindows(false) en las ventanas de actividad afectadas.

Para desbloquear la funcionalidad completa de Axe DevTools para Móvil, 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 preocupaciones de seguridad. Consulte nuestra guía para habilitar capturas de pantalla en aplicaciones Android.

Si minifica su compilación, verá un error con un registro de errores que informa que no se pudo encontrar un adaptador al intentar iniciar sesión en la biblioteca Axe DevTools. Deshabilite minify para sus compilaciones de depuración con Axe DevTools implementado. (#729)

Una compilación con r8 habilitado puede intentar minificar 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)
Para resolver este error, agregue la siguiente línea a su archivo ProGuard para mantener las clases de axeDevTools:
keep class com.deque.** { *; }

Las APIs de Compose están obsoletas, por favor use las APIs agnósticas de diseño para continuar recibiendo actualizaciones. Si continúa utilizando las APIs de Compose y encuentra un error del tipo `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)` o `No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?`, por favor refiérase a API setTestTag de Compose.

Si encuentra este mensaje, es posible que algunos resultados de reglas no regresen como se espera cuando esa regla está utilizando inteligencia artificial. Las reglas afectadas incluyen Contraste de Color, Texto Enfocable y Nombre del Elemento Anidado. (#841)

Debido a las limitaciones de la arquitectura de aplicaciones MAUI en el ecosistema de Android, la regla Nombre de Texto de Edición aparecerá como Requiere Revisión en el tablero cuando se sospeche un error para la versión SDK 5.5.0 en adelante. Por favor confirme el comportamiento correcto manualmente en este caso.

Cuando implementas diálogos o modales personalizados que no extienden los controles nativos, puedes obtener resultados para las vistas detrás del modal. En este caso, recomendamos no ejecutar nuestra herramienta contra estos modales o diálogos personalizados y, en cambio, verificarlos manualmente para asegurar que funcionan con tecnología asistiva como se desea.

Si la captura de pantalla falta en la página de detalles del escaneo, tu aplicación puede estar impidiendo que se tomen capturas. Generalmente, esto es por razones de seguridad en tu aplicación de producción. Considera eliminar este requisito para tu versión de prueba para permitir la funcionalidad completa en el Panel de Control de Axe DevTools Mobile.

• Android - FLAG_SECURE

Algunos nombres de escaneo de Android que tienen por defecto el título de la pantalla aparecerán como el nombre completo de la clase, incluyendo el identificador del paquete. En una futura versión, esto se resolverá para que el título de la pantalla se formatee en un nombre más legible. Como solución temporal, puedes establecer el nombre del escaneo desde el panel de control o los marcos. (#1643)