Gerichte Tests met Espresso/UIAutomator

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

Opmerking: Dit gaat ervan uit dat je de bibliotheek al aan je project hebt toegevoegd. Voor stappen om de Gradle-plugin te installeren, zie Aan de slag.

Geautomatiseerd Testen

Initialiseer de Bibliotheek

In de testklasse init, maak verbinding met de bibliotheek met een van de volgende:

Start een Testsessie

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

private val axe = AxeDevTools()

init {
  ...
  axe.startSession(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.startSession(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 je Deque-vertegenwoordiger of neem contact op met de ondersteuning om de levering van je licentiesleutel te coördineren. Gebruik dan de onderstaande snippet 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 verbindt met de zichtbare hiërarchie. Dit kan worden ingesteld voordat je tests worden uitgevoerd in de @Before fun setup() blok.

private val axe = AxeDevTools()

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

Wat Nu?

Nu je een project hebt gemaakt en de AxeDevTools bibliotheek hebt geïmporteerd, ben je klaar om je mobiele app te scannen. Optioneel kun je je configuratie aanpassen voordat je scant, met behulp van onze API's om je scans een naam te geven, bepaalde resultaten te negeren, aangepaste regels te maken, scans te taggen en meer.