Setup für automatisierte Tests

Auf dieser Seite werden die Schritte zum Einrichten der AxeDevTools-Bibliothek in Ihren UI-Tests erläutert, um nach Barrierefreiheitsproblemen zu suchen. Dies setzt voraus, dass Sie die Bibliothek bereits zu Ihrem Projekt hinzugefügt haben. Die Schritte zum Einbinden der Bibliothek finden Sie unter Erste Schritte.

Automatisiertes Testen

Initialisieren der Bibliothek

Stellen Sie in der Testklasse init mit einer der folgenden Methoden eine Verbindung zur Bibliothek her:

Starten Sie die Testsitzung

Generieren Sie einen API-Schlüssel unter axe.deque.com. Um Ergebnisse im axe Developer Hub zu veröffentlichen, verwenden Sie startSession mit dem API-Schlüssel und der Projekt-ID aus dem Developer Hub.

private val axe = AxeDevTools()

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

Wenn Sie die Ergebnisse nur lokal speichern möchten, brauchen Sie die Projekt-ID nicht anzugeben.

private val axe = AxeDevTools()

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

Mit Offline-Lizenzschlüssel verbinden

Die Offline-Automatisierung ist für das Android SDK verfügbar, benötigt jedoch einen Offline-Lizenzschlüssel für die Authentifizierung. 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 untenstehenden Codeausschnitt, um eine Verbindung zur axeDevTools-Bibliothek herzustellen. Siehe FAQ für weitere Informationen zur Verwendung der Offline-SDKs für optimierte Leistung ohne Netzwerkanfragen.

val axe = AxeDevTools()

init {
    axe.setOfflineLicenseKey("OFFLINE_LICENSE_KEY")
}

Setzen Sie das Instrumentation Registry

Dies ist das Teil, das es axe DevTools für Android ermöglicht, eine Verbindung mit der Ansichtshierarchie herzustellen. Dies kann vor der Ausführung Ihrer Tests im Block @Before fun setup() festgelegt werden.

private val axe = AxeDevTools()

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

Wie geht es weiter?

Sobald Sie ein Projekt erstellt und die AxeDevTools-Bibliothek importiert haben, können Sie jetzt Ihre mobile App (android-scan). Optionalerweise können Sie vor dem Scannen Ihre Konfiguration anpassen , indem Sie unsere APIs verwenden, um Ihre Scans zu benennen, bestimmte Ergebnisse zu ignorieren, benutzerdefinierte Regeln zu erstellen, Scans zu markieren und weiteres.