Tests Appium sur Perfecto

Deque s'est associé à Perfecto pour intégrer les tests d'accessibilité à vos flux de travail de tests automatisés existants. Ajoutez des analyses d'accessibilité à vos tests Appium avec axe DevTools Mobile, exécutez vos tests sur des appareils Perfecto, puis consultez les résultats dans axe Developer Hub.

Conditions préalables :

• Accès à l'automatisation des tests Perfecto
• Clé API Deque
• Vos tests s'exécutent avec Appium version 2.11.3 ou supérieure.
• Vos tests utilisant les pilotes Appium AxeUIAutomator ou AxeXCUITest

Comment réaliser des scans d'accessibilité

Perfecto a préinstallé les drivers axe Appium sur ses serveurs Appium. Ces pilotes vous permettent d'exécuter des analyses d'accessibilité à partir de vos tests Appium. Les pilotes AxeUiAutomator2 et AxeXCUITest de Deque sont forkés à partir des pilotes UiAutomator2 et XCUITest. Nous faisons un fork mais ne modifions pas la fonctionnalité principale de ces pilotes. Vos tests s'exécuteront comme prévu, et vous bénéficierez d'une capacité supplémentaire : effectuer des analyses d'accessibilité !

Voici les étapes clés pour configurer vos tests Appium en vue de tests d’accessibilité :

1. Définissez le nom de l'automatisation sur AxeUiAutomator2 pour Android ou AxeXCUITest pour iOS. Veuillez noter le préfixe Axe.
2. Veuillez fournir votre clé API Deque pour l'authentification.
3. Exécutez le script mobile: axeScan à chaque endroit de vos tests où vous souhaitez effectuer une analyse d'accessibilité.
4. Après avoir exécuté vos tests sur les appareils Perfecto, consultez vos résultats dans le axe Developer Hub.

Consultez notre guide de configuration pour Appium pour apprendre à personnaliser votre configuration et à tirer parti des résultats des analyses d'accessibilité afin de mieux servir votre équipe, et voir une liste complète des tests d'exemple Appium. Le guide d'installation et les exemples sont généraux et ne contiennent pas tout ce dont vous avez besoin pour l'intégration à Perfecto.

Exemples

Reportez-vous au code ci-dessous pour configurer vos tests Appium en vue de l'accessibilité avec la plateforme Perfecto et lancer des analyses d'accessibilité.

Activez les pilotes, en configurant la capacité automationName en fonction de la plateforme :

Configuration d’Android

Le automationName doit être défini sur AxeUiAutomator2. La valeur appPackage est le nom du package de l'application Android testée.

{ 
  "automationName": "AxeUiAutomator2", // Note the 'Axe' prefix.
  "appPackage": "<your-app-package>" 
}

Configuration d’iOS

La automationName doit être définie sur AxeXCUITest. La valeur bundleId est l’identifiant du bundle de l’application iOS en cours de test.

{ 
  "automationName": "AxeXCUITest",  // Note the 'Axe' prefix.
  "bundleId": "<your-app-bundle-id>" 
}

Balayage d'accessibilité

Appium prend en charge plusieurs langages de programmation. L'extrait de code JavaScript ci-dessous présente les capacités requises pour intégrer axe DevTools Mobile dans les scripts de test, notamment votre clé API axe DevTools Mobile. Vous pouvez créer un nom personnalisé pour vos analyses pour une meilleure traçabilité. Déclenchez une analyse d'accessibilité à l'aide de la commande mobile: axeScan.

const axeSettings = { 
  apiKey: '<deque-api-key>', // axe DevTools Mobile API key
  projectId: '<devhub-project-id>', // Recommended: Use the Project ID you created in Developer Hub to upload results
  scanName: '<your-scan-name-here>', // Optional: Customize the scan name
  tags: ['tag-one', 'tag-two'] // Optional: Add tags, to more easily find and group scans
}; 

const result = await driver.execute('mobile: axeScan', axeSettings);