Gerichte Tests met Espresso/UIAutomator

Wanneer u volledige controle wilt hebben over wanneer en waar toegankelijkheidsscans in uw tests worden uitgevoerd, moet u Gerichte Testen implementeren. Volg de onderstaande stappen om de AxeDevTools-bibliotheek in te stellen binnen uw UI-tests om toegankelijkheidsproblemen te controleren. U roept expliciet de axe.scan()-methode aan op specifieke punten in uw code.

Opmerking: Er wordt van uitgegaan dat u de bibliotheek al aan uw project heeft toegevoegd. Voor stappen om de Gradle-plug-in te installeren, zie Aan de slag.

Geautomatiseerd Testen

Initialiseer de Bibliotheek

In de testklasse init, verbind met de bibliotheek met een van de volgende opties:

Start een Testsessie

Genereer een API-sleutel op axe.deque.com. Om resultaten naar Axe Developer Hub te posten, gebruik startScanSession met de API-sleutel en Project-ID van Developer Hub.

private val axe = AxeDevTools()

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

Als je de resultaten alleen lokaal wilt opslaan, hoef je de Project ID niet mee te nemen.

private val axe = AxeDevTools()

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

Verbind met Offline Licentiesleutel

Offline automatisering is beschikbaar voor de Android SDK, maar vereist een offline licentiesleutel voor authenticatiedoeleinden. Neem contact op met uw Deque-vertegenwoordiger of neem contact op met de ondersteuning om de levering van uw licentiesleutel te coördineren. Gebruik vervolgens de onderstaande codefragmenten om verbinding te maken met de axeDevTools-bibliotheek. Zie de FAQ voor meer informatie over het gebruik van de Offline SDK's voor geoptimaliseerde prestaties zonder netwerkverzoeken.

val axe = AxeDevTools()

init {
    axe.setOfflineLicenseKey("OFFLINE_LICENSE_KEY")
}

Stel het Instrumentatieregister in

Dit is het onderdeel dat Axe DevTools voor Android in staat stelt verbinding te maken met de weergavehiërarchie. Dit kan worden ingesteld voordat uw tests worden uitgevoerd in het @Before fun setup()-blok.

private val axe = AxeDevTools()

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

Wat Nu?

Nu u een project heeft aangemaakt en de AxeDevTools-bibliotheek heeft geïmporteerd, bent u klaar om je mobiele app te scannen. Optioneel kunt u je configuratie aanpassen voordat u een scan uitvoert, waarbij u onze API's gebruikt om uw scans een naam te geven, bepaalde resultaten te negeren, aangepaste regels te maken, scans te taggen en meer.