Notas de la versión de Axe DevTools Mobile del 16 de julio de 2025

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.

Una configuración en el Analizador iOS 1.4.7 impide que se ejecuten escaneos, devolviendo el mensaje "Prueba Fallida". Para ejecutar escaneos en un dispositivo físico, actualiza al último proyecto del Analizador iOS.

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 de destino a través de la configuración de prueba: ...". Actualiza a 2.8.2 o a la última versión para resolver el error. Actualiza al último dentro del proyecto del Analizador iOS.

Escanear algunas aplicaciones con esta versión del analizador y SDK resultaría en un error "No se pudo serializar AxeResult". Actualiza a la última versión para resolver el error. Actualiza al último proyecto del Analizador iOS.Actualiza al último SDK de iOS.

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 del iPhone 15 Pro que impide que la regla Soporte para Tipo Dinámico se ejecute. Si estás inscrito en la regla Soporte para Tipo Dinámico, no podrás probarla usando un simulador del iPhone 15 Pro. Se ha presentado un error a Apple.

Al observar 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)

En aplicaciones UIKit, una imagen sin un `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 de los problemas de Nombre de ImageView en aplicaciones UIKit se reportarán como Requiere Revisión. Se ha presentado un informe de error a Apple. (#1633)

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

In Scroll View
Puede reportar problemas para texto dentro de elementos que se comportan como banner. Para que estos elementos estén disponibles para aquellos que requieren texto más grande, usa 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 de él, 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 los elementos cercanos para ayudar a determinar el estado de la regla. En algunas jerarquías de vista, el texto cercano incorrecto puede ser detectado causando que estas reglas fallen. (#1622)

Nuestra regla de Contraste de Color depende del aprendizaje automático para detectar texto, lo que asegura que el texto escaneado sea visible para los usuarios de su aplicación. En los casos en que el texto contenido en una vista sea 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). 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 esta experiencia accesible.

Para superar este problema, nuestra primera recomendación es ejecutar sus 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ía considerar evitar el uso de la hintText función, ya que no está oficialmente respaldada.

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 asistiva, pero Axe DevTools Mobile aún las reporta como problemas.

Estamos trabajando en una solución para este complejo problema. Mientras tanto, si TalkBack no puede alcanzar estas vistas, puede ignorar los problemas correspondientes. No requieren una solución para asegurar la accesibilidad.

La detección de texto de ML Kit es necesaria en muchas de las reglas de Axe DevTools Mobile para asegurar la precisión de los resultados. La biblioteca ML Kit debería importarse automáticamente cuando se referencia 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:

Axe DevTools Android: Error while running mlKit Text Detection: MlKitContext has not been initialized.

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

implementation 'com.google.mlkit:text-recognition:16.0.1'

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

En Android API 30, uno de los lugares donde intentamos guardar los 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
//    }
}

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

La capacidad de ocultar superposiciones no del sistema se introdujo con API 31 (Android 12). 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 dejarla desactivada para las versiones de prueba internas donde puede utilizar datos de prueba de manera segura y eliminar las 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 llamado al método setHideOverlayWindows(true) a setHideOverlayWindows(false) en las ventanas de actividad afectadas.

Para desbloquear toda la funcionalidad de Axe DevTools para Móviles, asegúrese de que las capturas de pantalla estén habilitadas. Recomendamos habilitar 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.

Si minimiza su compilación, verá un fallo 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)

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)
    

Las APIs de Compose están en desuso, 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: (esRaíz)` o `No se inicializó Vista, ¿llamó a AxeDevToolsCompose.setComposeTestRule()?`, por favor refiérase a Compose setTestTag API.

Si encuentra este mensaje, es posible que algunos resultados de reglas no regresen como se esperaba cuando esa regla utiliza inteligencia artificial. Entre las reglas afectadas se incluyen Contraste de Color, Texto Enfocable y Nombre de Elemento Anidado. (#841)

Debido a las limitaciones de la arquitectura de aplicaciones MAUI que se muestra en el ecosistema de Android, la regla de Nombre de Texto Editable aparecerá como Necesita Revisión en el panel de control cuando se sospeche un fallo para la versión de SDK 5.5.0 en adelante. Por favor confirme manualmente el comportamiento correcto para este caso.

Cuando implemente diálogos o modales personalizados que no extiendan 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 verificarlos manualmente para asegurar que se comporten como se desea con la tecnología asistiva.

Si la captura de pantalla falta en la página de detalles de escaneo, su aplicación puede estar impidiendo que se tomen capturas de pantalla. A menudo, esto es por razones de seguridad en su aplicación de producción. Considere eliminar este requisito para su compilación de pruebas para permitir la funcionalidad completa en el Panel de Control de Axe DevTools Mobile.

• Android - FLAG_SECURE

Algunos nombres de escaneo de Android que se establecen por defecto como 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 temporal, puedes establecer el nombre de escaneo desde el panel de control o los marcos. (#1643)