Appium-Tests auf Perfecto

Deque ist eine Partnerschaft mit Perfecto eingegangen, um Barrierefreiheitstests in Ihre bestehenden Automatisierungs-Workflows zu integrieren. Fügen Sie Barrierefreiheitsscans zu Ihren Appium-Tests mit axe DevTools Mobile hinzu, führen Sie Ihre Tests auf Perfecto-Geräten aus und überprüfen Sie anschließend die Ergebnisse im axe Developer Hub.

Voraussetzungen:

• Zugriff auf Perfecto-Testautomatisierung
• Deque API-Schlüssel
• Ihre Tests, die mit Appium Version 2.11.3 oder höher ausgeführt werden
• Ihre Tests, die die Appium-Treiber AxeUIAutomator oder AxeXCUITest verwenden

Barrierefreiheitsprüfungen durchführen

Perfecto hat die Axe Appium-Treiber auf den Appium-Servern von Perfecto vorinstalliert. Diese Treiber ermöglichen es Ihnen, Barrierefreiheitsprüfungen aus Ihren Appium-Tests durchzuführen. Deque's AxeUiAutomator2- und AxeXCUITest-Treiber wurden von den UiAutomator2- und XCUITest-Treibern abgezweigt. Wir forken diese Treiber, ändern aber nicht deren Kernfunktionalität. Ihre Tests funktionieren wie gewohnt, und Sie haben zusätzlich die Möglichkeit, Accessibility-Scans durchzuführen!

Die wichtigsten Schritte zur Konfiguration Ihrer Appium-Tests für die Barrierefreiheitsprüfung sind:

1. Legen Sie den Automatisierungsnamen auf AxeUiAutomator2 für Android oder AxeXCUITest für iOS fest. (Beachten Sie das Axe-Präfix.)
2. Geben Sie Ihren Deque API-Schlüssel zur Authentifizierung an.
3. Führen Sie das Skript mobile: axeScan an jeder Stelle Ihrer Tests aus, an der Sie einen Barrierefreiheitsscan durchführen möchten.
4. Nachdem Sie Ihre Tests auf Perfecto-Geräten durchgeführt haben, überprüfen Sie Ihre Ergebnisse im axe Developer Hub.

Lesen Sie unsere Einrichtungsanleitung für Appium, um zu erfahren, wie Sie Ihre Konfiguration anpassen und die Ergebnisse von Barrierefreiheitsscans optimal für Ihr Team nutzen können, und sehen Sie sich eine vollständige Liste von Appium-Beispieltests an. Die Anleitung zur Einrichtung und die Beispiele sind allgemein gehalten und enthalten nicht alles, was Sie für die Perfecto-Integration benötigen.

Beispiele

Siehe den folgenden Code, um Ihre Appium-Tests für Barrierefreiheitstests mit der Perfecto-Plattform zu konfigurieren und Barrierefreiheitsscans durchzuführen.

Aktivieren Sie unsere Treiber und konfigurieren Sie die Capability automationName basierend auf der Plattform:

Android-Konfiguration

automationName sollte auf AxeUiAutomator2 gesetzt werden. Der appPackage Wert ist der Paketname der zu testenden Android-App.

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

iOS-Konfiguration

automationName sollte auf AxeXCUITest gesetzt werden. Der bundleId-Wert ist der Bundle-Identifier der iOS-App, die getestet wird.

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

Barrierefreiheit prüfen

Appium unterstützt mehrere Programmiersprachen. Der unten stehende JavaScript-Codeausschnitt zeigt die erforderlichen Fähigkeiten für die Integration von axe DevTools Mobile in Testskripte – nämlich Ihren axe DevTools Mobile API-Schlüssel. Sie können Ihren Scans einen benutzerdefinierten Namen zuweisen, um die Nachverfolgbarkeit zu verbessern. Führen Sie einen Barrierefreiheitsscan mit dem mobile: axeScan-Befehl aus.

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);