Wenn du die Barrierefreiheit testest, kannst du deine App aus der Perspektive aller Nutzer erleben, einschließlich derer mit besonderen Anforderungen an die Barrierefreiheit. Diese Art von Tests kann Möglichkeiten aufzeigen, wie Sie Ihre App leistungsfähiger und vielseitiger machen können.
Auf dieser Seite wird beschrieben, wie Sie Ihren vorhandenen Espresso-Tests Prüfungen der Barrierefreiheit im Internet hinzufügen. Weitere Informationen zur Barrierefreiheit im Internet finden Sie in den Leitfäden zur Barrierefreiheit im Internet.
Prüfungen aktivieren
Sie können Tests zur Barrierefreiheit im Internet mit der Klasse AccessibilityChecks aktivieren und konfigurieren:
Kotlin
import androidx.test.espresso.accessibility.AccessibilityChecks
@RunWith(AndroidJUnit4::class)
@LargeTest
class MyWelcomeWorkflowIntegrationTest {
init {
AccessibilityChecks.enable()
}
}
Java
import androidx.test.espresso.accessibility.AccessibilityChecks;
@RunWith(AndroidJUnit4.class)
@LargeTest
public class MyWelcomeWorkflowIntegrationTest {
@BeforeClass
public void enableAccessibilityChecks() {
AccessibilityChecks.enable();
}
}
Standardmäßig werden die Prüfungen ausgeführt, wenn Sie eine in androidx.test.espresso.action.ViewActions definierte Ansichtsaktion ausführen, z. B. click() oder scrollTo().
Jede Prüfung umfasst die Ansicht, in der die Aktion ausgeführt wird, sowie alle untergeordneten Ansichten. Sie können die gesamte Ansichtshierarchie eines Bildschirms bei jeder Prüfung auswerten, indem Sie true an setRunChecksFromRootView() übergeben, wie im folgenden Code-Snippet gezeigt:
Kotlin
AccessibilityChecks.enable().setRunChecksFromRootView(true)
Java
AccessibilityChecks.enable().setRunChecksFromRootView(true);
Teilmengen von Ergebnissen unterdrücken
Nachdem Espresso die Barrierefreiheit Ihrer App geprüft hat, finden Sie möglicherweise mehrere Möglichkeiten, die Barrierefreiheit Ihrer App zu verbessern, die Sie nicht sofort umsetzen können. Damit Espresso-Tests nicht ständig aufgrund dieser Ergebnisse fehlschlagen, können Sie sie vorübergehend ignorieren. Das Accessibility Test Framework (ATF) bietet diese Funktion über die Methode setSuppressingResultMatcher(), die Espresso anweist, alle Ergebnisse zu unterdrücken, die dem angegebenen Matcher-Ausdruck entsprechen.
Wenn Sie Änderungen an Ihrer App vornehmen, die einen Aspekt der Barrierefreiheit betreffen, ist es von Vorteil, wenn Espresso Ergebnisse für so viele andere Aspekte der Barrierefreiheit wie möglich anzeigt. Aus diesem Grund ist es am besten, nur bestimmte bekannte Verbesserungsmöglichkeiten zu unterdrücken.
Wenn Sie Ergebnisse von Tests zur Barrierefreiheit im Internet vorübergehend unterdrücken, die Sie später beheben möchten, ist es wichtig, dass Sie nicht versehentlich ähnliche Ergebnisse unterdrücken. Verwenden Sie daher Matcher mit einem engen Bereich. Wählen Sie dazu einen Matcher aus, damit Espresso ein bestimmtes Ergebnis nur dann unterdrückt, wenn es jede der folgenden Prüfungen auf Barrierefreiheit erfüllt:
- Prüfungen der Barrierefreiheit im Internet eines bestimmten Typs, z. B. Prüfungen der Größe des Berührungszielbereichs.
- Prüfungen der Barrierefreiheit im Internet, bei denen ein bestimmtes UI-Element wie eine Schaltfläche bewertet wird.
Das ATF definiert mehrere Abgleiche, mit denen Sie festlegen können, welche Ergebnisse in Ihren Espresso-Tests angezeigt werden sollen. Im folgenden Beispiel werden die Ergebnisse von Prüfungen unterdrückt, die sich auf den Farbkontrast eines einzelnen TextView-Elements beziehen. Die ID des Elements lautet countTV.
Kotlin
AccessibilityChecks.enable().apply {
setSuppressingResultMatcher(
allOf(
matchesCheck(TextContrastCheck::class.java),
matchesViews(withId(R.id.countTV))
)
)
}
Java
AccessibilityValidator myChecksValidator =
AccessibilityChecks.enable()
.setSuppressingResultMatcher(
allOf(
matchesCheck(TextContrastCheck.class),
matchesViews(withId(R.id.countTV))));