Testes Direcionados com Espresso/UIAutomator

Quando você deseja ter controle total sobre quando e onde as verificações de acessibilidade ocorrem nos seus testes, deve implementar Testes Direcionados. Siga as etapas abaixo para configurar a biblioteca AxeDevTools em seus testes de UI para verificar problemas de acessibilidade. Você chamará explicitamente o método axe.scan() em pontos específicos do seu código.

Nota: Isto assume que você já adicionou a biblioteca ao seu projeto. Para etapas de instalação do plugin Gradle, consulte Primeiros Passos.

Testes Automatizados

Inicializar a Biblioteca

Na classe de teste init, conecte-se à biblioteca com uma das seguintes opções:

Iniciar uma Sessão de Teste

Gere uma chave de API em axe.deque.com. Para postar resultados no Axe Developer Hub, use startScanSession com a Chave de API e o ID do Projeto do Developer Hub.

private val axe = AxeDevTools()

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

Se você quiser salvar os resultados apenas localmente, não é necessário incluir o ID do Projeto.

private val axe = AxeDevTools()

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

Conecte-se com a Chave de Licença Offline

Automação offline está disponível para o SDK do Android, mas exigirá uma chave de licença offline para fins de autenticação. Entre em contato com seu representante da Deque ou suporte ao cliente para coordenar a entrega de sua chave de licença. Em seguida, use o trecho abaixo para conectar-se à biblioteca axeDevTools. Veja a FAQ para mais informações sobre o uso dos SDKs Offline para desempenho otimizado sem solicitações de rede.

val axe = AxeDevTools()

init {
    axe.setOfflineLicenseKey("OFFLINE_LICENSE_KEY")
}

Configure o Instrumentation Registry

Esta é a peça que permite ao Axe DevTools para Android conectar-se à hierarquia de visualização. Isso pode ser configurado antes da execução dos testes no bloco @Before fun setup().

private val axe = AxeDevTools()

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

O que vem a seguir?

Agora que você criou um projeto e importou a biblioteca AxeDevTools, está tudo pronto para examinar seu aplicativo móvel. Opcionalmente, você pode personalizar sua configuração antes de fazer a varredura, usando nossas APIs para nomear suas varreduras, ignorar certos resultados, criar regras personalizadas, marcar varreduras e muito mais.