Tests Appium sur Perfecto

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

Prérequis :

• Accès à tests d'automatisation Perfecto
• Clé API Deque
• Vos tests exécutés avec Appium version 2.11.3 ou ultérieure
• Vos tests utilisant les pilotes Appium AxeUIAutomator ou AxeXCUITest

Comment effectuer des analyses d'accessibilité

Perfecto a préinstallé les pilotes Axe Appium sur leurs serveurs Appium. Ces pilotes vous permettent d'effectuer des analyses d'accessibilité depuis vos tests Appium. Les pilotes AxeUiAutomator2 et AxeXCUITest de Deque sont dérivés des pilotes UiAutomator2 et XCUITest. Nous dérivons mais ne modifions pas la fonctionnalité de base de ces pilotes. Vos tests s'exécuteront comme prévu, et vous aurez la capacité supplémentaire d'effectuer des analyses d'accessibilité !

Les étapes clés pour configurer vos tests Appium pour les tests d'accessibilité sont :

1. Définissez le nom de l'automatisation sur AxeUiAutomator2 pour Android ou AxeXCUITest pour iOS. (Notez le préfixe Axe.)
2. Fournissez 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, examinez vos résultats dans le Axe Developer Hub.

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

Exemples

Référez-vous au code ci-dessous pour configurer vos tests Appium pour les tests d'accessibilité avec la plateforme Perfecto et exécuter des analyses d'accessibilité.

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

Configuration Android

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

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

Configuration iOS

Le automationName doit être défini sur AxeXCUITest. La valeur bundleId est l'identifiant de bundle de l'application iOS sous test.

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

Analyser pour l'accessibilité

Appium prend en charge plusieurs langages de programmation. Le fragment de code JavaScript ci-dessous montre les capacités requises pour Axe DevTools Mobile ajoutées aux 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é en utilisant 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);