Test d'accessibilité Android dans Android Studio
Axe DevTools Mobile Analyzer permet de tester l'accessibilité sur toute application Android développée avec n'importe quelle technologie.
Nécessite :
- Android Studio
- Application à tester exécutant l'API 26 ou supérieure
- Application à tester installée sur un appareil physique ou un émulateur
- Clé API Axe DevTools Mobile
- ID de Projet du Hub Développeur Axe
Les instructions ci-dessous supposent que votre environnement Android Studio est déjà configuré. Si vous êtes nouveau sur Android Studio, consultez ce guide d'introduction pour vous préparer au développement d'applications.
Commencer
Passons en revue la configuration initiale pour tester l'accessibilité avec le projet Axe DevTools Mobile Analyzer dans Android Studio.
1. Créer un projet sur le Hub Développeur Axe pour vos résultats
-
Visitez le Hub Développeur Axe
-
Cliquez sur le bouton + Ajouter un nouveau projet pour créer un nouveau projet sur le Hub Développeur Axe.
-
Après avoir ajouté un nouveau projet, vous choisirez une méthode d'intégration pour recueillir des données d'accessibilité. Sélectionnez l'intégration Mobile Analyzer Axe DevTools.
-
L'étape suivante consiste à nommer votre projet. Nous vous recommandons d'inclure le nom de votre dépôt ou de votre suite de tests pour une référence facile. Après avoir entré un nom de projet, sélectionnez Suivant.
-
Une fois votre projet créé avec succès, vous verrez les instructions d'installation. Copiez l'ID de Projet pour l'installation. L'ID de Projet sera également disponible sur la page principale des projets dans le Hub Développeur Axe, si vous avez besoin d'y accéder plus tard.
2. Téléchargez le projet Mobile Analyzer Axe DevTools depuis l'Artifactory de Deque
-
Connectez-vous à l'Artifactory de Deque : agora.dequecloud.com
Remarque : Lorsque la page se charge, ne cherchez pas de paquet. Revenez à cette page et passez à l'étape suivante. -
Cliquez sur ce lien pour télécharger le projet Axe DevTools Mobile Analyzer : axe-devtools-android-uiautomator-v0.9.0.zip
Si le fichier ne commence pas à se télécharger automatiquement, cliquez sur le bouton de téléchargement à côté de « URL vers le fichier » depuis le site Agora.
-
Une fois que le fichier zip est téléchargé, extrayez les fichiers à l'emplacement souhaité sur votre ordinateur.
-
Ouvrez le dossier racine dans Android Studio en sélectionnant
File→Openet en sélectionnant le dossier du projet.
3. Configurez le projet
-
Depuis Android Studio, dans le volet du navigateur de projets, développez
app/src/androidTest/java/com/deque/mobile/axedevtoolsandroiduiautomator. -
Double-cliquez sur le fichier
RunScanpour l'ouvrir. -
Remplacez le texte "YOUR_API_KEY_HERE" par votre clé API Axe DevTools Mobile.
-
Remplacez le texte "YOUR_PROJECT_ID_HERE" par votre ID de Projet du Hub Développeur Axe
4. Préparez votre appareil / émulateur
- Pour effectuer une analyse, votre appareil ou émulateur doit être connecté à Android Studio. Si vous utilisez un appareil, vous devrez activer les paramètres du développeur.
- Ensuite, l'application que vous souhaitez tester doit être installée sur l'émulateur/appareil et en cours d'exécution au moment de l'analyse. Si vous avez accès au code source, vous pouvez exécuter l'application sur un émulateur Android, ou directement sur un appareil physique.
5. Effectuez une analyse d'accessibilité
-
Avec l'application en cours d'exécution, sélectionnez l'icône à double flèche verte à côté de
RunScan. Cela lancera le scan d'accessibilité sur l'application en cours d'exécution. -
Vous pouvez trouver votre analyse dans le Hub Développeur Axe.
Répétez ceci pour chaque écran que vous souhaitez tester.
Nous faisons la transition vers le Hub Développeur Axe comme lieu central pour visualiser et gérer les problèmes d'accessibilité. À partir de la version 0.6.0 du projet Analyzer, les résultats sont uniquement envoyés au Hub Développeur Axe. Les résultats anciens peuvent être publiés à la fois sur le tableau de bord mobile et sur le Hub Développeur Axe.
C'est terminé !
Félicitations, vous avez configuré avec succès le Mobile Analyzer Axe DevTools. Visitez le Hub Développeur Axe pour voir vos analyses.
Des questions ? Visitez questions fréquemment posées
