Android-Barrierefreiheitstests in Android Studio

Erforderlich:

• Android Studio
• App zum Testen, die auf API 26 oder höher läuft
• App zum Testen, die auf einem physischen Gerät oder Emulator installiert ist
• Axe DevTools Mobile API-Schlüssel
• Axe Developer Hub Projekt-ID

Erste Schritte

Gehen wir die Ersteinrichtung für Barrierefreiheitstests mit dem Axe DevTools Mobile Analyzer-Projekt in Android Studio durch.

1. Erstellen Sie ein Axe Developer Hub Projekt für Ihre Ergebnisse

1. Besuchen Sie Axe Developer Hub

2. Klicken Sie auf die Schaltfläche + Neues Projekt hinzufügen, um ein neues Axe Developer Hub Projekt zu erstellen.

3. Nachdem Sie ein neues Projekt hinzugefügt haben, wählen Sie eine Integrationsmethode zur Erfassung von Barrierefreiheitsdaten. Wählen Sie die Integration des Axe DevTools Mobile Analyzer.

4. Der nächste Schritt besteht darin, Ihrem Projekt einen Namen zu geben. Wir empfehlen, Ihren Repository- oder Test-Suite-Namen für eine einfache Referenzaufnahme einzubeziehen. Geben Sie einen Projektnamen ein und wählen Sie Weiter.

5. Sobald Ihr Projekt erfolgreich erstellt wurde, sehen Sie Installationsanweisungen. Kopieren Sie die Projekt-ID für die Installation. Die Projekt-ID wird auch auf der Hauptseite „Projekte“ im Axe Developer Hub verfügbar sein, falls Sie später darauf zugreifen müssen.

2. Laden Sie das Axe DevTools Mobile Analyzer-Projekt von Deques Artifactory herunter

1. Melden Sie sich bei Deques Artifactory an: agora.dequecloud.com
   Hinweis: Wenn die Seite geladen wird, suchen Sie nicht nach einem Paket. Kehren Sie zu dieser Seite zurück und fahren Sie mit dem nächsten Schritt fort.

2. Klicken Sie auf diesen Link, um das Axe DevTools Mobile Analyzer-Projekt herunterzuladen: axe-devtools-android-uiautomator-v0.9.0.zip
   
   Wenn der Download der Datei nicht automatisch startet, klicken Sie auf die Schaltfläche „Download“ neben „URL to file“ auf der Agora-Website.
   

3. Sobald der ZIP-Download abgeschlossen ist, extrahieren Sie die Dateien an den gewünschten Speicherort auf Ihrem Computer.

4. Öffnen Sie den Stammordner in Android Studio, indem Sie File → Open auswählen und den Projektordner auswählen.

3. Richten Sie das Projekt ein

1. Erweitern Sie in Android Studio im Projekt-Navigation-Bereich app/src/androidTest/java/com/deque/mobile/axedevtoolsandroiduiautomator.

2. Doppelklicken Sie auf die Datei RunScan, um sie zu öffnen.

3. Ersetzen Sie den Text "YOUR_API_KEY_HERE" durch Ihren Axe DevTools Mobile API-Schlüssel.

4. Ersetzen Sie den Text "YOUR_PROJECT_ID_HERE" durch Ihre Axe Developer Hub Projekt-ID

4. Bereiten Sie Ihr Gerät/Emulator vor

1. Um einen Scan auszuführen, sollte Ihr Gerät oder Emulator mit Android Studio verbunden sein. Wenn Sie ein Gerät verwenden, müssen Sie die Entwicklereinstellungen aktivieren.
2. Als Nächstes muss die App, die Sie testen möchten, auf dem Emulator/Gerät installiert und zum Zeitpunkt des Scans ausgeführt werden. Wenn Sie Zugang zum Quellcode haben, können Sie die App entweder auf einem Android Emulator oder direkt auf einem physischen Gerät ausführen.

5. Führen Sie einen Barrierefreiheitsscan durch

1. Wenn die App läuft, wählen Sie das grüne Doppelpfeil-Symbol neben RunScan. Dies wird den Barrierefreiheitsscan gegen die laufende App starten.

2. Sie können Ihren Scan im Axe Developer Hub finden.

Wiederholen Sie dies für jeden Bildschirm, den Sie testen möchten.

Geschafft!

Herzlichen Glückwunsch, Sie haben den Axe DevTools Mobile Analyzer erfolgreich eingerichtet. Besuchen Sie den Axe Developer Hub, um Ihre Scans zu sehen.

Fragen? Besuchen Sie Häufig gestellten Fragen