Référence API
Informations sur les classes et fonctions publiques de la bibliothèque.
Lorsque vous configurez des tests automatisés, vous définissez le registre d'instrumentation, permettant à axe DevTools pour Android de se connecter aux informations sur les nœuds d'accessibilité. Référez-vous aux classes et fonctions publiques de la bibliothèque ci-dessous lors de la construction de vos tests.
Initialisation d'AxeDevTools
Utilisez les API suivantes lors de l'initialisation de la bibliothèque AxeDevTools.
startScanSession(params)
Authentifie une clé API et initialise une session de test. L'identifiant du projet est requis pour publier les résultats sur Axe Developer Hub.
Requis param:
| Nom | Type | Description |
|---|---|---|
| apiKey | String |
Clé API Deque |
Optionnel param:
| Nom | Type | Description |
|---|---|---|
| projectId | String |
ID de projet Axe Developer Hub |
| axeAccountUrl | String |
Définit l'URL du serveur à laquelle se connecter |
startSession(params)
Génère un jeton d'authentification et initialise une session de test. Incluez l'ID du projet pour publier les résultats sur Axe Developer Hub. Cette API sera obsolète en 2026. Utilisez startScanSession à la place.
Requis param:
| Nom | Type | Description |
|---|---|---|
| apiKey | String |
Clé API Deque |
Optionnel param:
| Nom | Type | Description |
|---|---|---|
| projectId | String |
ID de projet Axe Developer Hub |
| serverUrl | String |
Définit l'URL du serveur à laquelle se connecter |
loginWithUsername(params)
Génère un jeton d'authentification pour se connecter au tableau de bord. Cette API sera obsolète en 2026. Utilisez startScanSession à la place.
Requis params:
| Nom | Type | Description |
|---|---|---|
| nom d'utilisateur | String |
nom d'utilisateur Deque |
| mot de passe | String |
mot de passe Deque |
Optionnel param:
| Nom | Type | Description |
|---|---|---|
| serverConfig | String |
Définit l'URL du serveur à connecter |
loginWithApiKey(param)
Génère un jeton d'authentification pour se connecter au tableau de bord. Cette API sera supprimée en 2026. Utilisez startScanSession à la place.
Requis param:
| Nom | Type | Description |
|---|---|---|
| apiKey | String |
clé API Deque |
Optionnel param:
| Nom | Type | Description |
|---|---|---|
| serverUrl | String |
Définit l'URL du serveur à connecter |
setInstrumentation(param)
Permet à la bibliothèque d'obtenir la hiérarchie de vue de l'application testée.
Requis param:
| Nom | Type | Description |
|---|---|---|
| instrumentation | android.app.Instrumentation |
Objet du registre d'instrumentation fournissant le contexte de l'application et l'instrumentation. |
isUserAuthenticated()
Renvoie un booléen pour indiquer si l'utilisateur est authentifié et prêt à envoyer des analyses.
Renvoie :
| Type | Description |
|---|---|
| Booléen | Indique si un utilisateur est authentifié pour Axe DevTools Mobile |
disconnect()
Efface la session réseau actuelle d'Axe DevTools pour permettre une nouvelle connexion.
Scan
Une fois que vous avez importé et initialisé la AxeDevTools bibliothèque, vous êtes prêt à analyser.
scan()
Analyse les informations collectées par l'objet du registre d'instrumentation passé setInstrumentation(param) pour détecter des problèmes et retourne un ScanResultHandler.
Retours :
| Nom | Type | Description |
|---|---|---|
| ScanResultHandler | Nullable | ScanResultHandler fournit un moyen d'obtenir des informations plus détaillées sur le résultat ou de mettre à jour le scan en fournissant un nom ou des balises |
getResult(param)
Demande le résultat d'un scan en faisant correspondre la clé de résultat fournie.
Requis param:
| Nom | Type | Description |
|---|---|---|
| axeDevToolsResultKey | AxeDevToolsResultKey |
L'identifiant du résultat que vous souhaitez obtenir |
Retours :
| Type | Description |
|---|---|
| AxeDevToolsResult | Nullable AxeDevToolsResult fournit un accès aux détails du résultat |
Gérer les résultats
Utilisez ces API avec l' ScanResultHandler objet retourné d'un scan.
uploadToDashboard()
Téléchargez le résultat du scan d'accessibilité. Retours :
| Type | Description |
|---|---|
| AxeDevToolsResult | Nullable AxeDevToolsResult fournit un accès aux détails du résultat |
saveResultToLocalStorage(param)
Enregistrez le résultat du scan d'accessibilité dans un fichier local sur votre appareil de test.
Requis param:
| Nom | Type | Description |
|---|---|---|
| prefixFilename | String |
Début du nom de fichier pour enregistrer le résultat. |
getSerializedResult()
Accédez au résultat de votre scan pour l'utiliser dans le test.
Personnaliser votre configuration
Nommez et étiquetez vos scans, choisissez d'ignorer certaines règles ou créez vos propres règles personnalisées.
setScanName(param)
Définissez un nom pour le scan avant de le télécharger.
Requis param:
| Nom | Type | Description |
|---|---|---|
| nom | String |
Nom pour le scan |
addCustomRule(param)
Ajoute une règle pour l’exécuter contre votre application lors des scans.
Requis param:
| Nom | Type | Description |
|---|---|---|
| customRule | Class<AxeDevToolsRule> |
Règle à ajouter |
ignoreRules(param)
Ignore complètement les règles pour qu'elles ne soient pas exécutées contre n'importe quelle vue.
Requis param:
| Nom | Type | Description |
|---|---|---|
| rulesToIgnore | List<String> |
Liste des règles à ignorer |
ignoreByViewIdResourceName(params)
Paramètres requis :
| Nom | Type | Description |
|---|---|---|
| viewIdResourceName | String |
Nom de l'ID de ressource pour la vue |
| ruleList | List<String> |
Liste des règles à ignorer |
ignoreExperimental()
Se désinscrit des règles expérimentales. Les résultats pour la ou les règles expérimentales auront le statut de AxeStatus.IGNORED.
resetIgnoredRules()
Efface la liste des règles ignorées définie par les APIs de règles ignorées. Utile pour changer la configuration des règles entre les tests automatisés.
tagScanAs(param)
Tague un scan avant de le télécharger.
Requis param:
| Nom | Type | Description |
|---|---|---|
| tags | Set<String> |
Liste des tags à ajouter au scan. |
tearDown()
Réinitialise les tags et efface l'état du test précédent.
deleteResult(param)
Supprimer le résultat d'un scan, correspondant à la clé de résultat fournie. (Tableau de bord mobile uniquement)
Obligatoire param:
| Nom | Type | Description |
|---|---|---|
| axeDevToolsResultKey | AxeDevToolsResultKey |
L'identifiant du résultat que vous souhaitez accéder. |