Problemas Conocidos

La regla de Contraste de Color utiliza el marco de Vision de Apple (Reconocimiento Óptico de Caracteres, u OCR) para leer texto dentro de los límites de un elemento. El OCR puede identificar erróneamente pequeños glifos tipo ícono - como chevrones de flecha hacia atrás (<), viñetas, símbolos decorativos - como texto. Cuando eso sucede, la regla de Contraste de Color se ejecuta en un elemento que no contiene texto legible, lo que puede producir un resultado para un botón solo de ícono. Dado que la salida de OCR no es determinista entre exploraciones, el mismo elemento puede aparecer en los resultados de Contraste de Color en una exploración y ser reportado como „NO APLICABLE“ en la siguiente. Esta es una característica conocida del OCR, no un error en la regla.

Para mitigar este problema, puede usar las ignore APIs para suprimir resultados de Contraste de Color para los elementos afectados.

// Ignore Color Contrast for a specific element by accessibility identifier
axeDevTools?.configuration.ignore(rulesFor: [
    "backButton": [AxeRuleId.ColorContrast.toString()]
])

Flutter no asigna AppBar.title a la propiedad nativa del título de pantalla - UIViewController.title, lo que provoca que la regla del Título de Pantalla falle en todas las pantallas de Flutter independientemente de si hay presente un título descriptivo.

Esta es una limitación conocida de la plataforma Flutter registrada en flutter/flutter#185894.

Al realizar 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 informar falsos positivos para los fondos degradados. En tales casos, puede ser incapaz de determinar el color de primer plano y en su lugar comparar los colores de fondo entre sí, lo que resulta en un fallo.

Para mitigar este problema, intente realizar 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 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 sucede porque el sistema de accesibilidad verifica si el contenedor WKWebView en sí es visible, en lugar de si su contenido web está realmente desobstruido y perceptible para el usuario.

iOS 26 contiene un error de accesibilidad donde los botones de stepper predeterminados no anuncian „oscurecido“ mediante 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 errores a Apple, pero hasta que esto se resuelva, las siguientes reglas pueden informar resultados en botones de stepper deshabilitados: AssociatedText, InaccessibleAction, y ColorContrast.

Hasta que Apple solucione este error, la resolución será [ignorar las reglas](ios-ignore-rule). Los botones de stepper 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 informar 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 de Supports Dynamic Type se ejecute. Si está suscrito a la regla de Supports Dynamic Type, no podrá probarlo usando un simulador de iPhone 15 Pro. Se ha presentado un informe de errores a Apple.

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

En aplicaciones UIKit, una imagen sin un `accessibilityLabel` no es enfocada por tecnología asistida por defecto.
Las propiedades que usamos para verificar la focalización de Apple pueden ser inexactas cuando un `accessibilityIdentifier` está establecido en la imagen. Debido a este comportamiento inesperado, los resultados de problemas de Nombre de ImageView en aplicaciones UIKit se reportarán como Necesita Revisión. Se ha presentado un informe de errores 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 que estos elementos sean accesibles para aquellos que necesitan 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 en é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 elementos cercanos para ayudar a determinar el estado de la regla. En algunas jerarquías de vistas, puede detectarse texto incorrecto cercano, provocando que estas reglas fallen. (#1622)

La regla de Etiquetar al Frente verifica que la etiqueta visible de un elemento aparezca al inicio de su texto anunciado. Un fallo de la regla puede ocurrir cuando el texto visible de un elemento interactivo contiene una abreviatura (por ejemplo, "GB", "km") o un identificador oscurecido / truncado, y el anuncio de accesibilidad consiste en las palabras representadas (por ejemplo, "gigabytes", "kilómetros"), aunque este es el patrón recomendado para hacer que el contenido abreviado o truncado sea amigable para lectores de pantalla.

Si la primera parte de la etiqueta visible de un elemento interactivo coincide con el inicio del anuncio del lector de pantalla y solo la parte abreviada / oscurecida difiere, el resultado marcado puede ser ignorado con seguridad. Verifique con un lector de pantalla que el anuncio completo se lea como se pretende.

Al usar texto decorativo en vistas como "Íconos de contacto", es posible introducir un problema de accesibilidad. Si usa una vista de texto para mostrar letras en lugar de generar imágenes con las letras deseadas como vectores, y luego declara que esa vista de texto no es importante para la accesibilidad, no podremos determinar de manera confiable si ha introducido una violación de accesibilidad.

Si edita texto enfocable para ignorar dos o menos caracteres, puede inadvertidamente ignorar muchos botones de una sola palabra en varios idiomas (por ejemplo, "OK", "No", "Sí"). Para evitar estos problemas, debe tomar las letras deseadas de la palabra que desea representar en el ícono y generar las letras como parte de la imagen en lugar de como vistas de texto separadas. `FocusableText` entonces no se ejecutará en esas vistas.

Flutter no asigna AppBar.title a la propiedad nativa del título de pantalla - Activity.setTitle, lo que provoca que la regla del Título de Pantalla falle en todas las pantallas de Flutter independientemente de si hay presente un título descriptivo.

Esta es una limitación conocida de la plataforma Flutter registrada en flutter/flutter#185894.

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 AccessibilityEventse desencadenan por acciones del usuario, no podemos acceder a la descripción correcta si esta información no se proporciona.

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, que nuestra herramienta podrá detectar.

Nuestra regla de Contraste de Color depende del Aprendizaje Automático para detectar texto, lo cual garantiza que el texto escaneado sea visible para los usuarios de su aplicación. En casos donde 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 esa vista.

Las aplicaciones escritas con XML que utilizan la función de texto de ayuda pueden ver falsos positivos con la EditTextName regla. El texto de ayuda no se introdujo hasta Android 8 (SDK 26). Usar este elemento en su aplicación XML asignará el texto de ayuda 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 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, puede considerar evitar el uso de la hintText función, ya que no está oficialmente soportada.

Es posible que vea 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 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 asegurar la precisión de los resultados. La biblioteca ML Kit se debe importar 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:

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

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

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

Actualmente, la regla de Espaciado de Objetivos Táctiles no se ejecuta en componentes deslizantes que fueron escritos en Jetpack Compose. No se puede tomar ninguna acción en este momento. ¡Sin embargo, una solución está en camino!

En Android API 30, uno de los lugares donde 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 puede ser suprimido comentando el siguiente bloque de código:

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 elementos en una vista de desplazamiento están parcialmente fuera de la pantalla. Para probar un elemento por accesibilidad, asegúrese de que esté completamente en pantalla antes de realizar el análisis.

Introducida con API 31 (Android 12) está la capacidad de ocultar superposiciones no 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 dejarla desactivada para las versiones de prueba internas donde puede utilizar datos de prueba de forma 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.

Para desbloquear toda la funcionalidad de Axe DevTools para Mobile, asegúrese de que las capturas de pantalla estén habilitadas. Recomendamos habilitar las capturas de pantalla en una versión de prueba o debug 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 construcció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 Axe DevTools. Desactive la minimización para sus compilaciones debug con Axe DevTools implementado. (#729)

Una compilación con r8 habilitado puede intentar minimizar la biblioteca axeDevTools, lo que resulta 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 obsoletas, por favor usa las APIs agnósticas al diseño para seguir recibiendo actualizaciones. Si continúas usando las APIs de Compose y encuentras un error del tipo `Se esperaba exactamente '1' nodo pero se encontraron '2' nodos que satisfacen: (isRoot)` o `No se ha inicializado la vista, ¿llamaste a AxeDevToolsCompose.setComposeTestRule()?`, por favor consulta la API Compose setTestTag.

Debido a las limitaciones de la arquitectura de aplicaciones MAUI en el ecosistema Android, la regla de Nombre de Texto Editado aparecerá como Necesita Revisión en el panel cuando se sospeche una falla para la versión del SDK 5.5.0 y posteriores. Por favor confirma el comportamiento correcto manualmente en este caso.

Cuando implementes diálogos o modales personalizados que no extienden los controles nativos, puede que obtengas resultados de vistas detrás del modal. En este caso, recomendamos no ejecutar nuestra herramienta contra estos modales o diálogos personalizados y en su lugar verificar manualmente que funcionen con la tecnología asistiva como se desea.

Si falta la captura de pantalla en la página de detalles del escaneo, es posible que su aplicación esté impidiendo que se realicen 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 versió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 se predeterminan al título de la pantalla aparecerán como el nombre completo de la clase, incluido el identificador del paquete. En una próxima 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 configurar el nombre del escaneo desde el panel o los frameworks. (#1643)