Notes de mise à jour d'Axe DevTools Mobile du 6 novembre 2025

Les API d'accessibilité d'Apple peuvent signaler de manière incorrecte le contenu web à l'intérieur de WKWebView comme "isVisible", même lorsque la vue web est couverte par des superpositions natives (comme des vues modales, des alertes ou d'autres éléments de l'interface utilisateur native). Cela se produit parce que le système d'accessibilité vérifie si le conteneur WKWebView lui-même est visible, plutôt que si son contenu web est réellement dégagé et perceptible pour l'utilisateur.

iOS 26 contient un bug d'accessibilité où les boutons de stepper par défaut ne signalent pas "atténué" par la technologie d'assistance pour indiquer qu'ils ne sont pas activés. En conséquence, les règles iOS considèrent également ces boutons comme activés même s'ils ne le sont pas. Un rapport de bug a été soumis à Apple, mais jusqu'à ce que ce problème soit résolu, les règles suivantes peuvent signaler des résultats sur des boutons d'incrément désactivés : AssociatedText, InaccessibleAction, et ColorContrast.

Jusqu'à ce qu'Apple corrige ce bug, la solution sera d'[ignorer les règles](ios-ignore-rule). Les boutons de stepper par défaut portent les identifiants "Decrement" et "Increment", et peuvent être ignorés par identifiant si nécessaire.

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.

Un paramètre de configuration dans iOS Analyzer 1.4.7 empêche les analyses de s'exécuter, retournant le message "Échec du test". Pour lancer des analyses sur un appareil physique, mettez à jour vers le dernier projet iOS Analyzer.

La fonctionnalité de test d'une application par identifiant de bundle a été rompue dans la version 2.8.1, ce qui a entraîné une erreur intitulée "No target application path specified via test configuration: ...". Mettez à jour vers la version 2.8.2 ou la dernière version pour résoudre l'erreur. Mettez à jour vers la dernière version dans le projet iOS Analyzer.

Analyser certaines applications avec cette version de l'analyseur et du SDK entraînerait une "Could not Serialize AxeResult" erreur. Mettez à jour vers la dernière version pour corriger l'erreur. Mettez à jour vers le dernier projet iOS Analyzer.Mettez à jour vers le dernier SDK iOS.

Certaines écrans peuvent signaler des faux positifs avec LabelInName et LabelAtFront en raison d'une propriété associatedText incorrecte trouvée (#1622)

Un problème affecte le simulateur iPhone 15 Pro, ce qui empêche la règle de prise en charge du type dynamique de s'exécuter. Si vous êtes inscrit à la règle de prise en charge du type dynamique, vous ne pourrez pas la tester en utilisant un simulateur iPhone 15 Pro. Un bug a été signalé à Apple.

En examinant une amélioration pour nos règles, nous avons constaté que dans XCTest, les contrôles imbriqués ne sont pas renvoyés dans l'arborescence d'accessibilité. Un bug a été signalé à Apple. (#1110)

Dans les applications UIKit, une image sans un accessibilityLabel n'est pas focalisable avec les technologies d'assistance par défaut.
Les propriétés que nous utilisons pour vérifier la focalisabilité provenant d'Apple peuvent être inexactes lorsque accessibilityIdentifier est défini sur l'image. En raison de ce comportement inattendu, les résultats pour les problèmes de nommage ImageView dans les applications UIKit seront signalés comme nécessitant un examen. Un rapport de bug a été soumis à Apple. (#1633)

Nous travaillons activement sur des correctifs pour les faux positifs suivants et mettrons à jour cette liste au fur et à mesure des corrections.

In Scroll View
Peut signaler des problèmes pour le texte à l'intérieur des éléments se comportant comme des bannières. Pour rendre ces éléments accessibles à ceux qui nécessitent un texte plus grand, utilisez UILargeContentViewer. (#622)

v2.11.0 Image View Name & Active Control Name
Si un UIImageView possède un accessibilityIdentifier défini mais n'est pas focalisable par VoiceOver, et a des contrôles focalisables imbriqués, ActiveControlName peut signaler un faux positif sur le UIImageView. Supprimer le accessibilityIdentifier résout le problème. Un bug a été signalé à Apple. (#1633)

Label In Name and Label At Front
Ces deux règles recherchent l'étiquette visible d'un contrôle parmi les éléments environnants pour aider à déterminer le statut de la règle. Dans certaines hiérarchies de vue, le texte environnant incorrect peut être détecté, causant l'échec de ces règles. (#1622)

Notre règle de Contraste des couleurs repose sur l'apprentissage automatique pour détecter le texte, ce qui garantit que le texte analysé soit visible pour les utilisateurs de votre application. Dans les cas où le texte contenu dans une vue a la même couleur que l'arrière-plan, notre algorithme d'apprentissage automatique ne peut pas détecter la présence de texte, donc la règle de Contraste des couleurs ne s'exécute pas sur cette vue.

Les applications écrites en XML qui utilisent la fonctionnalité de texte d'indice peuvent constater des faux positifs avec la EditTextName règle. Le texte d'indice n'a été introduit qu'à partir d'Android 8 (SDK 26). Utiliser cet élément dans votre application XML assigne le texte d'indice à la valeur du champ de saisie de texte. Les versions plus récentes d'Android sont mieux équipées pour rendre cette expérience accessible.

Pour surmonter ce problème, notre première recommandation est d'exécuter vos tests sur des versions plus récentes d'Android. Si il est important que l'application soit accessible sur des versions antérieures d'Android, vous pourriez envisager d'éviter l'utilisation de la hintText fonctionnalité, car elle n'est pas officiellement supportée.

Vous pouvez voir des résultats pour des vues qui sont cachées derrière d'autres vues à l'écran. Ces vues cachées ne sont pas disponibles pour les technologies d'assistance, mais Axe DevTools Mobile les rapporte tout de même comme problèmes.

Nous travaillons sur une solution pour ce problème complexe. En attendant, si TalkBack ne peut pas accéder à ces vues, vous pouvez ignorer les problèmes correspondants. Ils ne nécessitent pas de correctif pour garantir l'accessibilité.

La détection de texte de ML Kit est requise dans de nombreuses règles d'Axe DevTools Mobile pour garantir la précision des résultats. La bibliothèque ML Kit devrait être importée automatiquement lors de la référence à Axe DevTools Mobile dans vos tests automatisés Espresso ou UIAutomator. Dans certains cas, cependant, l'importation automatique ne se produit pas et vous verrez l'erreur suivante dans le logcat:

Pour surmonter ce problème, vous devez importer manuellement la bibliothèque ML Kit dans votre projet. Dans le fichier build.gradle de votre application, ajoutez ce qui suit sous les dépendances:

La règle d'Espacement des cibles tactiles ne s'exécute actuellement sur aucun composant de glissière écrit en Jetpack Compose. Aucune action ne peut être entreprise pour le moment. Cependant, une correction est bientôt disponible !

Sur Android API 30, un des emplacements où nous tentons de sauvegarder les résultats localement présente une erreur de permissions. Le résultat sera néanmoins enregistré en tant que fichier JSON malgré l'affichage de cette erreur. L'erreur peut être supprimée en commentant le code dans le bloc suivant:
def clearDirectoryTask = task('clearDirectoryTask', type: Exec, group: 'reporting') {
executable "${android.getAdbExecutable().toString()}"
args 'shell', 'rm', '-r', '/storage/emulated/0/Documents/AxeTestCases'
// finalizedBy {
// fetchAndroidFolderAxeReportsTask
// }
}

Veuillez noter que ce code ne doit être commenté que pour l'API 30 car il causera des problèmes lors de l'enregistrement local pour d'autres niveaux d'API.

Dans certaines applications hybrides et multiplateformes, nous pouvons renvoyer des résultats inattendus lorsque des éléments dans une vue de défilement sont partiellement hors écran. Pour tester un élément pour l'accessibilité, assurez-vous qu'il soit entièrement à l'écran avant de lancer le scan.

Introduite avec l'API 31 (Android 12) est la capacité de masquer les superpositions non-système. Afin d'utiliser l'application Axe Analyzer, veuillez vous assurer que ce paramètre n'est pas activé. Si vous avez choisi d'utiliser cette fonctionnalité pour ses améliorations de sécurité, nous vous recommandons de la laisser désactivée pour les versions de test internes où vous pouvez utiliser des données de test en toute sécurité et éliminer ainsi les préoccupations de sécurité. Note: this setting does not affect Google's accessibility scanner app as it's considered a system overlay.

Pour utiliser l'application Axe Accessibility Analyzer, mettez à jour tous les appels à la méthode setHideOverlayWindows(true) en setHideOverlayWindows(false) sur les fenêtres d'activités affectées.

Pour débloquer toutes les fonctionnalités de Axe DevTools pour Mobile, assurez-vous que les captures d'écran sont activées. Nous recommandons d'activer les captures d'écran sur une version de débogage ou de test de votre application qui utilise des données fictives pour éviter les préoccupations de sécurité. Consultez notre guide pour activer les captures d'écran dans les applications Android.

Si vous réduisez la taille de votre build, vous verrez un crash avec un journal d'erreurs signalant qu'un adaptateur n'a pas pu être trouvé lors de la tentative de connexion à la bibliothèque Axe DevTools. Désactivez la minification pour vos builds de débogage avec Axe DevTools implémenté. (#729)

Une build avec r8 activé peut tenter de réduire la taille de la bibliothèque axeDevTools, ce qui entraîne une erreur similaire à:
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)
Pour résoudre cette erreur, ajoutez la ligne suivante à votre fichier ProGuard pour conserver les classes axeDevTools :
keep class com.deque.** { *; }

Les API Compose sont obsolètes, veuillez utiliser les APIs agnostiques en termes de mise en page pour continuer à recevoir des mises à jour. Si vous continuez à utiliser les API Compose et que vous rencontrez une erreur du type "Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)" ou "No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?", veuillez vous référer à l'API Compose setTestTag.

Si vous rencontrez ce message, certains résultats de règles peuvent ne pas être renvoyés comme prévu lorsque cette règle utilise l'intelligence artificielle. Les règles affectées incluent Contraste des couleurs, Texte focalisable et Nom de l'élément imbriqué. (#841)

En raison des limitations de l'architecture de l'application MAUI dans l'écosystème Android, la règle de Nom d'édition de texte apparaîtra comme À revoir dans le tableau de bord lorsqu'une défaillance est suspectée pour la version SDK 5.5.0 et plus. Veuillez confirmer manuellement le comportement correct pour ce cas.

Lorsque vous implémentez des boîtes de dialogue ou modaux personnalisés qui n'étendent pas les contrôles natifs, vous pouvez obtenir des résultats pour des vues derrière le modal. Dans ce cas, nous recommandons de ne pas utiliser notre outil contre ces modaux ou boîtes de dialogue personnalisés et de les vérifier manuellement pour vous assurer qu'ils fonctionnent comme souhaité avec les technologies d'assistance.

Si la capture d'écran est absente de la page de détails du scan, il est possible que votre application empêche la prise de captures d'écran. Cela est souvent dû à des raisons de sécurité dans votre application de production. Envisagez de supprimer cette exigence pour votre version de test afin de permettre la pleine fonctionnalité dans le Tableau de Bord de Axe DevTools Mobile.

• Android - FLAG_SECURE

Certains noms de scan Android qui sont par défaut le titre de l'écran apparaîtront comme le nom de la classe complète, y compris l'identifiant du bundle. Dans une future version, cela sera résolu afin que le titre de l'écran soit formaté en un nom plus lisible. Comme solution provisoire, vous pouvez définir le nom du scan depuis le tableau de bord ou les frameworks. (#1643)