Gezieltes Testen mit Espresso/UIAutomator

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Initialisieren und Konfigurieren der AxeDevTools-Bibliothek innerhalb Ihrer UI-Tests

Not for use with personal data

Wenn Sie die vollständige Kontrolle darüber haben möchten, wann und wo Barrierefreiheitsscans in Ihren Tests durchgeführt werden, sollten Sie zielgerichtetes Testen implementieren. Befolgen Sie die folgenden Schritte zur Einrichtung der AxeDevTools-Bibliothek in Ihren UI-Tests, um auf Barrierefreiheitsprobleme zu prüfen. Sie werden die axe.scan()-Methode an bestimmten Stellen in Ihrem Code explizit aufrufen.

Hinweis: Dies setzt voraus, dass Sie die Bibliothek bereits zu Ihrem Projekt hinzugefügt haben. Für Schritte zur Installation des Gradle-Plugins sehen Sie bitte Erste Schritte.

Automatisierte Tests

Die Bibliothek initialisieren

In der Testklasse init, verbinden Sie sich mit der Bibliothek mithilfe einer der folgenden Methoden:

Eine Testsitzung starten

Generieren Sie einen API-Schlüssel auf axe.deque.com. Um Ergebnisse an den Axe Developer Hub zu senden, verwenden Sie startScanSession mit dem API-Schlüssel und der Projekt-ID vom Developer Hub.

private val axe = AxeDevTools()

init {
  ...
  axe.startScanSession(apiKey = "<DEQUE_APIKEY>",
            projectId = "<DEVHUB_PROJECT_ID>")
  ...
}

Wenn Sie Ergebnisse nur lokal speichern möchten, müssen Sie die Projekt-ID nicht angeben.

private val axe = AxeDevTools()

init {
  ...
  axe.startScanSession(apiKey = "<DEQUE_APIKEY>")
  ...
}

Verbindung mit Offline-Lizenzschlüssel

Offline-Automatisierung ist für das Android SDK verfügbar, erfordert jedoch einen Offline-Lizenzschlüssel zur Authentifizierung. Bitte kontaktieren Sie Ihren Deque-Ansprechpartner oder kontaktieren Sie den Support, um die Bereitstellung Ihres Lizenzschlüssels zu koordinieren. Verwenden Sie dann das unten stehende Snippet zur Verbindung mit der axeDevTools-Bibliothek. Weitere Informationen zur Nutzung der Offline-SDKs für optimierte Performance ohne Netzwerk-Anfragen finden Sie unter die FAQ.

val axe = AxeDevTools()

init {
    axe.setOfflineLicenseKey("OFFLINE_LICENSE_KEY")
}

Das Instrumentierungs-Register setzen

Dies ist das Element, das es Axe DevTools für Android ermöglicht, eine Verbindung zur Ansichtshierarchie herzustellen. Dies kann im @Before fun setup()-Block eingestellt werden, bevor Ihre Tests ausgeführt werden.

private val axe = AxeDevTools()

@Before
fun setup()  {
  axe.setInstrumentation(InstrumentationRegistry.getInstrumentation())
}

Wie geht es weiter?

Jetzt, da Sie ein Projekt erstellt und die AxeDevTools-Bibliothek importiert haben, sind Sie bereit, mobile App zu scannen. Optional können Sie anpassen, bevor Sie scannen, indem Sie unsere APIs verwenden, um Ihre Scans zu benennen, bestimmte Ergebnisse zu ignorieren, benutzerdefinierte Regeln zu erstellen, Scans zu taggen und mehr.