Testes Direcionados com Espresso/UIAutomator

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

Nota: Pressupõe-se que você já tenha adicionado 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 startSession com a chave de API e ID do Projeto do Developer Hub.

private val axe = AxeDevTools()

init {
  ...
  axe.startSession(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.startSession(apiKey = "<DEQUE_APIKEY>")
  ...
}

Conecte-se com a Chave de Licença Offline

A automação offline está disponível para o Android SDK, mas exigirá uma chave de licença offline para fins de autenticação. Entre em contato com seu representante Deque ou suporte ao cliente para coordenar a entrega da sua chave de licença. Em seguida, use o trecho de código abaixo para se conectar à axeDevTools biblioteca. Veja a FAQ para mais informações sobre como usar os SDKs Offline para desempenho otimizado sem requisiçõ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 for Android conectar-se à hierarquia de visualizações. Isso pode ser configurado antes de seus testes rodarem 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 AxeDevTools biblioteca, você está pronto para examinar seu aplicativo móvel. Opcionalmente, você pode personalizar sua configuração antes de escanear, usando nossas APIs para nomear suas verificações, ignorar certos resultados, criar regras personalizadas, marcar verificações e mais.