Appium-Tests auf Perfecto

Deque hat sich mit Perfecto zusammengeschlossen, um Barrierefreiheitstests in Ihre bestehenden Automatisierungstest-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 die Ergebnisse im Axe Developer Hub.

Voraussetzungen:

• Zugang zu Perfecto-Automatisierungstests
• Deque-API-Schlüssel
• Ihre Tests, die gegen Appium Version 2.11.3 oder höher laufen
• Ihre Tests, die die AxeUIAutomator- oder AxeXCUITest-Appium-Treiber verwenden

So machen Sie Barrierefreiheitsscans

Perfecto hat die Axe-Appium-Treiber auf ihren Appium-Servern vorinstalliert. Diese Treiber ermöglichen es Ihnen, Barrierefreiheitsscans aus Ihren Appium-Tests auszuführen. Die AxeUiAutomator2 und AxeXCUITest Treiber von Deque sind von den UiAutomator2 und XCUITest Treibern abgeleitet. Wir passen die Kernfunktionalität dieser Treiber nicht an. Ihre Tests laufen wie erwartet und Sie haben die zusätzliche Möglichkeit, Barrierefreiheitsscans durchzuführen!

Die wichtigen Schritte, um Ihre Appium-Tests für Barrierefreiheitstests zu konfigurieren, sind:

1. Setzen Sie den Automatisierungsnamen auf AxeUiAutomator2 für Android oder AxeXCUITest für iOS. (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 in Ihren Tests aus, an der Sie einen Barrierefreiheitsscan durchführen möchten.
4. Überprüfen Sie nach der Ausführung Ihrer Tests auf Perfecto-Geräten Ihre Ergebnisse im Axe Developer Hub.

Verweisen Sie auf 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 eine vollständige Liste der Appium-Beispieltests. Die Einrichtungsanleitung und Beispiele sind allgemein gehalten und enthalten nicht alles, was Sie für die Perfecto-Integration benötigen.

Beispiele

Verweisen Sie auf den untenstehenden Code, um Ihre Appium-Tests für Barrierefreiheitstests mit der Perfecto-Plattform zu konfigurieren und Barrierefreiheitsscans durchzuführen.

Aktivieren Sie unsere Treiber, indem Sie die automationName Fähigkeit basierend auf der Plattform konfigurieren:

Android-Konfiguration

Der 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

Der automationName sollte auf AxeXCUITest gesetzt werden. Der bundleId-Wert ist der Bundle-Identifier der zu testenden iOS-App.

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

Barrierefreiheit scannen

Appium unterstützt mehrere Programmiersprachen. Der untenstehende JavaScript-Ausschnitt zeigt Konfigurationen, die für Axe DevTools Mobile zu den Testskripten hinzugefügt werden müssen - nämlich Ihren Axe DevTools Mobile API-Schlüssel. Sie können einen benutzerdefinierten Namen für Ihre Scans erstellen, um die Nachverfolgbarkeit zu verbessern. Lösen 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);