„Setup für automatisiertes Testen“
„Richten Sie sich mit axe DevTools Mobile in Appium für Zugänglichkeitstests in iOS und Android ein.“
Nachdem Sie die axe DevTools Mobile Appium-Treiber installiert haben, können Sie Ihre Tests so konfigurieren, dass sie auf Barrierefreiheitsprobleme prüfen.
Automatisiertes Testen
Starten Sie den Appium-Server wie gewohnt:
appiumKonfigurieren Sie Ihre Tests
Fügen Sie aus Ihren Appium-Automatisierungsskripten die für axe DevTools Mobile erforderlichen Fähigkeiten für die zu testende Plattform hinzu:
Erforderliche Android-Fähigkeit:
| Name | Art | Beschreibung |
|---|---|---|
| automationName | String |
Stellen Sie es auf „AxeUiAutomator2“ ein, um den Treiber mit eingebettetem Axe DevTools Mobile zum Ausführen von Zugänglichkeitsscans zu verwenden. |
| appPackage | String |
Das Anwendungspaket der getesteten App. Beachten Sie, dass appPackage Teil des UiAutomator2-Treibers ist. Möglicherweise haben Sie es bereits eingestellt. |
Erforderliche iOS-Fähigkeit:
| Name | Art | Beschreibung |
|---|---|---|
| automationName | String |
Stellen Sie es auf „AxeXCUITest“ ein, um den Treiber mit eingebettetem axe DevTools Mobile zum Ausführen von Zugänglichkeitsscans zu verwenden. |
| Bündel-ID | String |
Die Bundle-ID der getesteten App. Beachten Sie, dass bundleId Teil des XCUITest-Treibers ist. Möglicherweise haben Sie es bereits eingestellt. |
Initialisieren der Bibliothek
Stellen Sie in der Testklasse initialization eine Verbindung zum Treiber mit einer der folgenden Methoden her:
Starten Sie eine Testsitzung mit einem Deque API-Schlüssel
Generieren Sie einen Axe DevTools Mobile API-Schlüssel unter axe.deque.com. Um Ergebnisse im Axe Developer Hub zu veröffentlichen, benötigen Sie außerdem eine Projekt-ID. Rufen Sie die Execute Script API auf und übergeben Sie axeStartSession zusammen mit dem API-Schlüssel und der Projekt-ID, um die Testsitzung zu starten.
beforeAll(async () => {
...
const axeAuthSettings = {
apiKey: "<DEQUE_APIKEY>",
projectId: "<DEQUE_PROJECT_ID>"
};
await driver.execute('mobile: axeStartSession', axeAuthSettings);
...
})Wenn Sie die Ergebnisse nur lokal speichern möchten, brauchen Sie die Projekt-ID nicht anzugeben.
beforeAll(async () => {
...
await driver.execute('mobile: axeStartSession', { apiKey: "<DEQUE_APIKEY>" });
...
})Starten Sie eine Testsitzung mit Offline-Lizenzschlüssel
Für die Appium-Treiber ist eine Offline-Automatisierung verfügbar, allerdings wird hierfür ein Offline-Lizenzschlüssel zur Authentifizierung benötigt. Bitte wenden Sie sich an Ihren Deque-Vertreter oder kontaktieren Sie den Support, um die Zustellung Ihres Lizenzschlüssels zu koordinieren. Verwenden Sie anschließend den unten stehenden Codeausschnitt, um eine Verbindung zum Appium-Treiber herzustellen. Weitere Informationen zur Verwendung unserer Offline-Appium-Treiber für Barrierefreiheitsprüfungen ohne Netzwerkabfragen finden Sie in den Häufig gestellten Fragen.
beforeAll(async () => {
...
await driver.execute('mobile: axeStartSession', { licenseKey: "<DEQUE_OFFLINE_LICENSE_KEY>" });
...
}Wie geht es weiter?
Nachdem Sie Ihre Appium-Tests eingerichtet haben, können Sie Ihre mobile App scannen. Optional können Sie vor dem Scannen Ihre Konfiguration anpassen , indem Sie mithilfe unserer APIs Ihre Scans benennen, bestimmte Ergebnisse ignorieren, Scans markieren und mehr.
