Testes Direcionados com Appium
Configure-se para testes de acessibilidade em iOS e Android com Axe DevTools Mobile no Appium.
Após você ter instalado os drivers Axe DevTools Mobile para Appium, pode configurar seus testes para verificar problemas de acessibilidade.
Teste Automatizado
Inicie o servidor Appium normalmente:
appiumConfigure seus Testes
A partir dos seus scripts de automação Appium, adicione as capacidades necessárias para o Axe DevTools Mobile para a plataforma em teste:
Capacidade Requerida para Android:
| Nome | Tipo | Descrição |
|---|---|---|
| automationName | String |
Defina como 'AxeUiAutomator2' para utilizar o driver com Axe DevTools Mobile embutido para executar verificações de acessibilidade. |
| appPackage | String |
O pacote da aplicação em teste. Note que appPackage é parte do driver UiAutomator2; você pode já tê-lo configurado. |
Capacidade Requerida para iOS:
| Nome | Tipo | Descrição |
|---|---|---|
| automationName | String |
Defina como 'AxeXCUITest' para utilizar o driver com Axe DevTools Mobile embutido para executar verificações de acessibilidade. |
| bundleId | String |
O identificador do pacote da aplicação em teste. Note que bundleId é parte do driver XCUITest; você pode já tê-lo configurado. |
Inicialize a Biblioteca
Na classe de teste initialization, conecte-se ao driver com uma das seguintes opções:
Inicie uma Sessão de Teste com uma Chave de API Deque
Gere uma chave de API do Axe DevTools Mobile em axe.deque.com. Para enviar resultados para o Axe Developer Hub, você também precisará de um ID de Projeto. Chame a API Execute Script, passando axeStartSession juntamente com a chave de API e o ID de Projeto para iniciar a sessão de teste.
beforeAll(async () => {
...
const axeAuthSettings = {
apiKey: "<DEQUE_APIKEY>",
projectId: "<DEQUE_PROJECT_ID>"
};
await driver.execute('mobile: axeStartSession', axeAuthSettings);
...
})Nota: Embora você ainda possa salvar os resultados localmente, a omissão do projectId irá acionar um aviso de descontinuação. Recomendamos fortemente incluir este valor com axeStartSession.
Inicie uma Sessão de Teste com Chave de Licença Offline
A automação offline está disponível para os drivers do Appium, mas exigirá uma chave de licença offline para fins de autenticação. Por favor, entre em contato com seu representante da Deque ou contate o suporte para coordenar a entrega da sua chave de licença. Em seguida, use o trecho abaixo para se conectar ao driver Appium. Saiba mais sobre como usar nossos drivers Appium offline para executar verificações de acessibilidade sem fazer requisições de rede em Perguntas Frequentes.
beforeAll(async () => {
...
await driver.execute('mobile: axeStartSession', { licenseKey: "<DEQUE_OFFLINE_LICENSE_KEY>" });
...
}O Que Vem a Seguir?
Agora que você configurou seus testes Appium, está pronto para verificar seu aplicativo móvel. Opcionalmente, você pode personalize a sua configuração antes de escanear, usando nossas APIs para nomear suas verificações, ignorar certos resultados, taguear verificações e mais.
