Notas de lanzamiento de Axe DevTools Mobile del 18 de mayo de 2026

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

Para resolver este problema, intente ejecutar las 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 APIs de accesibilidad de Apple pueden reportar incorrectamente contenido web dentro de WKWebView como "isVisible", incluso cuando la vista web está cubierta por superposiciones nativas (como vistas modales, alertas, u otros elementos UI nativos). Esto ocurre porque el sistema de accesibilidad verifica si el contenedor de WKWebView en sí mismo es visible, en lugar de si su contenido web está realmente desbloqueado y percibible para el usuario.

iOS 26 contiene un error de accesibilidad donde los botones de incrementadores predeterminados no anuncian "atenuado" por Tecnología Asistencial 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 reportar resultados en botones de incrementadores deshabilitados: AssociatedText, InaccessibleAction, y ColorContrast.

Hasta que Apple solucione este error, la resolución será [ignorar las reglas](ios-ignore-rule). Los botones de incrementadores predeterminados tienen los identificadores "Decrementar" e "Incrementar", y pueden ser ignorados 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 iPhone 15 Pro que impide que la regla Supports Dynamic Type se ejecute. Si está optado en la regla Supports Dynamic Type, no podrá probarla usando un simulador iPhone 15 Pro. Se ha presentado un informe de error a Apple.

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

En aplicaciones UIKit, una imagen sin un `accessibilityLabel` no es enfocada por tecnología asistencial por defecto.
Las propiedades que usamos para verificar la posibilidad de enfoque desde 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)

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

In Scroll View
El texto dentro de elementos que se comportan como banners puede ser señalado con un mensaje de "Necesita Revisión". Para hacer estos elementos 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 establecido un `accessibilityIdentifier` 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 informe de error a Apple. (#1633)

Label In Name and Label At Front
Estas dos reglas buscan el label visible de un control entre 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)

En algunos casos, la tecnología asistencial depende de AccessibilityEvent descripciones del sistema Android para anunciar información al usuario cuando no hay otro anuncio disponible. Dado que AccessibilityEvents are triggered by user actions, we are unable to access the correct description if this information is not provided.

Para evitar este problema, asegúrese de que todas las vistas relevantes estén marcadas como importantes para la accesibilidad. Esto permitirá que Talkback acceda a la información de la vista, la cual nuestra herramienta podrá detectar.

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 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 sugerido pueden ver falsos positivos con la EditTextName regla. El texto sugerido no se introdujo hasta Android 8 (SDK 26). Usar este elemento en su aplicación XML asignará el texto sugerido 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 superar este problema, nuestra primera recomendación es realizar sus pruebas en versiones más recientes de Android. Si es importante que la aplicación sea accesible en versiones anteriores de Android, sin embargo, podría considerar evitar el uso de la hintText función, ya que no es compatible oficialmente.

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 informa 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 garantizar 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 de ML Kit debería 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 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 manualmente la biblioteca de ML Kit a su proyecto. En el build.gradle archivo de su aplicación, agregue lo siguiente bajo dependencias:

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

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

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

En algunas aplicaciones híbridas y multiplataforma, podemos devolver resultados inesperados cuando los elementos en una vista de desplazamiento están parcialmente fuera de la pantalla. Para probar un elemento para accesibilidad, 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 no del sistema. Para utilizar la aplicación Análisis 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, le recomendamos dejarla desactivada para las compilaciones de prueba internas en las que puede 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 Análisis de Accesibilidad 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ó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 utilice datos simulados para evitar problemas de seguridad. Consúlte nuestro guía para habilitar capturas de pantalla en aplicaciones Android.

Si minimiza su compilación, verá un bloqueo con un registro de error que informa que no se pudo encontrar un adaptador al intentar iniciar sesión en la biblioteca de 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 utilice las APIs agnósticas al diseño para seguir recibiendo actualizaciones. Si continúa utilizando las APIs de Compose y encuentra un error del tipo `Se esperaba exactamente '1' nodo pero se encontraron '2' nodos que cumplen: (esRaíz)` o `No se inicializó ninguna Vista, ¿llamó a AxeDevToolsCompose.setComposeTestRule()?`, por favor consulte la API setTestTag de Compose.

Debido a limitaciones de la arquitectura de la aplicación MAUI al renderizarse 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 SDK 5.5.0 y superiores. Por favor, confirme el comportamiento correcto manualmente para este caso.

Cuando esté implementando diálogos o modales personalizados que no extiendan los controles nativos, puede 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 su lugar revisarlos manualmente para asegurarse de que funcionen con la tecnología de asistencia como se desea.

Si falta la captura de pantalla en la página de detalles del escaneo, su aplicación puede estar evitando 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 son predeterminados al 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 de escaneo desde el panel de control o los frameworks. (#1643)