Notas de la versión de Axe DevTools Mobile 11 de noviembre de 2026

Versiones de los componentes

iOS

• iOS SDK (axeDevToolsXCUI v5.0.0)

Cómo actualizar: iOS SDK, Aplicación de escritorio iOS Analyzer

Android

• Android SDK (axe-devtools-android v10.0.0)
• Plugin de Gradle de Android (axe-devtools-android-plugin v2.0.0)
• Analyzer de Android (Axe Accessibility Analyzer v4.2.0)

Cómo actualizar: Plugin de Gradle de Android, Analyzer de Android

¿Qué hay de nuevo?

SDK

A medida que se acerca el retiro del Panel de Control Móvil, la configuración global de reglas ahora se establece en Axe Account. Aquí, los administradores configuran ajustes para determinar qué reglas se ejecutarán en las pruebas automatizadas y también pueden otorgar permisos para que los usuarios anulen configuraciones globales e ignoren reglas individuales en sus pruebas. Cuando no se permiten anulaciones, la llamada de ignorar no hace nada y el SDK registra el motivo. Tenga en cuenta que si no se pueden leer los ajustes de la organización, las exploraciones seguirán ejecutándose. Todas las reglas se ejecutan y se permiten las ignorancias a nivel de código. Solo una organización que desactiva explícitamente las anulaciones las bloquea.

iOS

• Encuentre un enlace a sus resultados después de la carga. Después de que una exploración se carga, el registro imprime View your results in Axe Developer Hub: <link>. Las exploraciones dirigidas enlazan a la página del proyecto y Auto Scan enlaza a su sesión.
• Las reglas ahora se ignoran en AxeDevTools mismo, por ejemplo axe.ignoreRules(.colorContrast, .screenTitle), o por elemento con ignoreRules(onElementWithId:) / ignoreRules(onElementOfClass:). Una regla mal escrita ahora hace que falle la compilación en lugar de ejecutarse silenciosamente. (Cambio importante — ver más abajo.)

Android

• Encuentre un enlace a sus resultados después de la carga. Después de que una exploración se carga, el registro imprime un enlace al Axe Developer Hub. Las exploraciones dirigidas enlazan a la página del proyecto y AutoScan enlaza a su sesión.
• Ahora se ignoran reglas con el enum AxeRuleName, por ejemplo axeDevTools.ignoreRules(AxeRuleName.COLOR_CONTRAST, AxeRuleName.SCREEN_TITLE). Para omitir reglas en un elemento, use ignoreRulesOnElementWithId("resource_id", AxeRuleName.TOUCH_TARGET_SIZE). Un nombre de regla mal escrito ahora hace que falle la compilación en lugar de ser ignorado en silencio. (Cambio importante, ver más abajo.)
• Establezca los ignoradores de reglas una vez por sesión al realizar pruebas dirigidas. Pase ignoreRules y ignoreRulesOnElementIds a la función mobile: axeStartSession; estos se aplican a cada exploración dirigida hasta que la sesión termine. (Nota: Auto Scan no permite ignorar reglas individuales; sigue solo las configuraciones de reglas de la organización.)

Correcciones

iOS

• Mejoras en la precisión de las siguientes reglas: Etiqueta en Nombre, Etiqueta al Frente, Tamaño del Objetivo Táctil, Espaciado del Objetivo Táctil
• Las exploraciones ya no fallan cuando el ejecutor de pruebas se construye con Xcode 16.2 u otras versiones anteriores a 16.4
• Registros de prueba más silenciosos: el SDK ya no imprime en el registro de prueba cada vez que envía análisis

Android

• Precisión mejorada de la regla Etiqueta en Nombre
• Mejora del rendimiento para Auto Scan: el ejecutor de pruebas ahora espera hasta 10 segundos por una conexión de red antes de iniciar sesión
• Mejora del rendimiento del botón de exploración flotante del Axe Accessibility Analyzer al usar TalkBack: ahora puede alcanzarlo deslizando, y mantiene el enfoque después de una exploración o al abrir un menú (El cambio de enfoque requiere la versión 16.2 o posterior de TalkBack)

Actualizaciones

Android

• El SDK, el Analyzer y los objetivos de muestra ahora se compilan contra Android SDK 37 (compileSdk / targetSdk 37). El minSdk se mantiene en 26. Su aplicación no necesita ningún cambio.
• Las pruebas Java ahora pueden llamar a AxeAutoScan.skipScan(...) directamente, sin .Companion
• resetIgnoredRules() ya no está en desuso y puede seguir utilizándolo

Degradaciones y Eliminaciones

iOS

• La regla de Acción Inaccesible ha sido eliminada. Las exploraciones nunca la ejecutan y AxeRuleId.InaccessibleAction ya no compila. Elimine cualquier referencia a esta regla de su código de prueba. Cualquier código que haya agregado para deshabilitar o ignorar la regla puede ser eliminado.
• Las APIs experimentales de reglas han sido eliminadas. La clave experimental también ha desaparecido del JSON exportado.
• La clave optInToSupportsDynamicType ha sido eliminada. Si aún tiene esto en su código, elimine la línea que lo establece.
• Las siguientes APIs del panel de control móvil han sido eliminadas. Estas fueron marcadas como obsoletas en una versión anterior. El camino hacia el Axe Developer Hub es el único que queda:
  • getResult, tagResult, deleteResult, updateScanName, AxeDevToolsResultKey, AxeResult.tags — eliminados, sin reemplazo.
  • login(withAPIKey:toServer:) y startSession(apiKey:url:projectId:) — use startScanSession(...) o authenticate(...) en su lugar.
  • postResult(_:withTags:withScanName:) — use postResult(_:withScanName:), que ahora no devuelve nada.
  • axeServiceUrl / axeServerUrl (para Auto Scan) — use axeAccountUrl.
  • AxeStatus.IGNORED - eliminado. Las reglas ignoradas ya no producen resultados en absoluto, por lo que "status":"IGNORED" nunca aparece en el JSON exportado.

Android

• Las reglas experimentales han sido eliminadas:
  • NestedElementName y NestedActiveControl ya no existen.
  • ignoreExperimental() y la bandera experimental en AxeRule han desaparecido.
• AxeRuleViewHierarchy fue marcado como obsoleto en marzo de 2025 y ahora ha sido eliminado. Las reglas personalizadas deben extender AxeRule y sobreescribir isApplicable / runRule usando AxeView.
• Las APIs del panel de control móvil han sido eliminadas. Axe Developer Hub es ahora el único camino de carga:
  • loginWithApiKey(...) y startSession(apiKey, projectId, serverUrl) — use startScanSession(apiKey, projectId, axeAccountUrl).
  • tagScanAs, getResult, deleteResult, AxeDevToolsResultKey, TagsSet — eliminados, sin reemplazo.
• ScanResultHandler.uploadToDashboard(uploadOnly) — use uploadToDashboard() sin argumentos. Nota: Esto envía resultados a Axe Developer Hub.
• Plugin de Gradle axeServerUrl — use axeAccountUrl.
• AxeStatus.IGNORED - eliminado. Las reglas ignoradas ya no producen ningún resultado, así que "status":"IGNORED" nunca aparece en el JSON exportado.

Cambios importantes

iOS

• La versión mínima de iOS requerida ahora es 17. Los objetivos de prueba de la interfaz de usuario que aún apuntan a iOS 16 deben elevar su objetivo de implementación. Ejecutar en dispositivos iOS 16 ya no es compatible.
• La ignorancia de reglas se ha trasladado de axe.configuration, y axe.configuration ha sido eliminado. Las llamadas antiguas fallan al compilar con un mensaje que nombra la nueva llamada:
  • axe.configuration.ignore(rules:) - utilice axe.ignoreRules(...)
  • axe.configuration.ignore(rulesFor:) - use axe.ignoreRules(onElementWithId:_:) o ignoreRules(onElementOfClass:_:)
  • axe.configuration.customRules.insert(rule) - utilice axe.addCustomRule(rule)
  • Ignorar reglas personalizadas y reactivar reglas ya no es compatible
• Los valores de AxeRuleId ahora son lowerCamelCase (por ejemplo, .ColorContrast se convierte en .colorContrast). El código Swift que use la ortografía antigua ya no compila. Objective-C, JSON exportado, Axe Developer Hub y configuraciones de Appium ignoreRules permanecen sin cambios.
• Las URL de cuenta de http:// son rechazadas al iniciar sesión con una clave API. Los clientes internos cuya URL de cuenta comienza con http:// deben cambiar a https://.
• Las API eliminadas listadas bajo Degradaciones y Eliminaciones fallan al compilar.

Android

• Las APIs para ignorar reglas han cambiado. Las llamadas antiguas ya no compilan:
  • ignoreRules(listOf("ColorContrast")) - utilice ignoreRules(AxeRuleName.COLOR_CONTRAST)
  • ignoreByViewIdResourceName(id, listOf(...)) - utilice ignoreRulesOnElementWithId(id, AxeRuleName.X, ...)
  • ignoreExperimental() - elimine la llamada.
• TouchSizeWcag es ahora TouchTargetSize, lo que coincide con iOS y Axe Developer Hub. Actualice cualquier código, filtro o panel que busque el nombre antiguo.
• Las reglas personalizadas que extienden AxeRuleViewHierarchy, o que pasan la bandera experimental a AxeRule, ya no compilan.
• Plugin de Gradle: Las compilaciones que todavía establecen axeServerUrl en el bloque axeDevTools { } deben cambiar a axeAccountUrl.
• Las API eliminadas listadas bajo Degradaciones y Eliminaciones fallan al compilar.

Problemas conocidos

Nuevos problemas

Si experimenta alguno de los siguientes problemas, por favor contáctenos en helpdesk@deque.com o support.deque.com. Luego podremos notificarle una vez que esté resuelto o de una solución alternativa identificada si no se encuentra ninguna listada.

iOS

Falsos positivos para las reglas de Soporte de Tipo Dinámico y Texto Recortado

Las reglas de Soporte de Tipo Dinámico y Texto Recortado (iOS 17 y posterior) utilizan resultados del auditoría de accesibilidad de Apple. Esa auditoría ocasionalmente señala texto que escala correctamente o es completamente visible, y estas reglas informan lo que devuelve Apple. La mayoría de fallas de estas reglas son problemas reales, por lo que no recomendamos descartarlas como un grupo. Este problema ha sido reportado a Apple, y estamos trabajando para reducir estos falsos positivos.

Para confirmar una falla, active Tamaños de Accesibilidad Mayores en Settings > Accessibility > Display & Text Size > Larger Text. Revise cada tamaño de texto, desde el predeterminado hasta el más grande, y compruebe que el texto señalado escale y permanezca completamente visible. El texto puede verse bien en el tamaño más grande pero fallar en un tamaño intermedio.

Si la falla es un falso positivo, ignore la regla en ese elemento por su identificador de accesibilidad. No recomendamos ignorar la regla para todo el escaneo o por nombre de clase, ya que esto también puede ocultar fallas reales.

Android

Falsos positivos al escanear mapas

Actualmente no es posible determinar con precisión si un elemento en la pantalla está contenido dentro de un mapa, por lo tanto, nuestras reglas podrían escanear inadvertidamente pines de mapa y dar resultados de falsos positivos. Este es un problema con la forma en que el sistema Android informa sobre los mapas al Servicio de Accesibilidad.

Utilice nuestra API de reglas de ignorar para eximir su mapa o pines de mapa de ser escaneados usando sus identificadores.

Aprende más sobre ignorar reglas.

Las aplicaciones construidas con Unity no pueden ser escaneadas

Axe DevTools Mobile no puede escanear el contenido en pantalla de aplicaciones construidas con el motor de juegos Unity. Esto afecta los escaneos automatizados con la biblioteca de Android así como los escaneos desde la aplicación Accessibility Analyzer. Los resultados solo muestran verificaciones a nivel de pantalla - para reglas como Orientación de Pantalla y Título de Pantalla - y nada para los botones, textos o interruptores de la aplicación.

No hay solución alternativa en este momento.

Problemas resueltos

iOS

Eliminado: falso positivo desactualizado de Nombre de Vista de Imagen y Nombre de Control Activo

Hemos eliminado una entrada desactualizada sobre falsos positivos de Nombre de Control Activo en un UIImageView que tiene un accessibilityIdentifier. Este problema solo afectó la versión v2.11.0 y se solucionó en el lanzamiento de junio de 2024. Nombre de Control Activo ya no se ejecuta en estas imágenes en las aplicaciones de UIKit. Nombre de Vista de Imagen los reporta como Necesitan Revisión en su lugar (ver Resultados de la Revisión de las Normas de Nombres de ImageView para Aplicaciones UIKit).