Migrar o Plugin Appium para 2.0.0

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Guia para migrar usuários pioneiros para as últimas mudanças do Axe DevTools Mobile para Appium.

Not for use with personal data

Nota: Se você está começando agora a usar o Axe DevTools Mobile para Appium, vá para o guia de configuração.

Obrigado pelo feedback! Fizemos algumas mudanças em nosso Plugin Appium para melhor atendê-lo e à forma como você está testando aplicativos móveis hoje. Se você implementou a versão 1.0.0 do Plugin Appium, siga este guia para saber os passos fáceis para mudar para a 2.0.0.

Atualizar para a versão 2.0.0

Desinstalar axeDevToolsMobile:

appium plugin uninstall axeDevToolsMobile

Uma instalação nova do plugin irá buscar a versão mais recente. Instale o plugin na sua instância de Appium através da linha de comando:

appium plugin install --source=npm @axe-devtools/appium-plugin

Atualizar Capacidades

Dos seus scripts de automação Appium, copie e depois remova a capacidade 'key' anteriormente necessária para a chave de API do Axe DevTools Mobile.

A chave de API será movida para um objeto de configurações a ser passado no método executeScript do Appium.

tip

Você pode considerar adicionar uma função utilitária ao seu script de teste como um ponto central para iniciar uma varredura de acessibilidade.

Atualizar Como Escanear Problemas de Acessibilidade

Anteriormente, o plugin interceptava o método de fonte de página do Appium para verificar problemas de acessibilidade. Isso foi substituído para que a fonte de página ainda esteja disponível para uso nos testes como anteriormente!

Em qualquer lugar que você queira iniciar um teste de acessibilidade, substitua as instâncias de chamada do API de fonte de página por API de execução de script.

executeScript("axe:scan", Settings)

Parametro	Tipo	Descrição
Configurações	`Object`	Inclui as configurações necessárias para Axe DevTools Mobile. (Veja Chaves Necessárias nas Configurações).
FonteDaPágina	`String`	Opcional: Se você já capturou o PageSource para a tela atual, pode fornecê-lo ao Axe DevTools Mobile sem incorrer novamente no custo dessa consulta. Nota: Se você perceber que a captura de tela e os resultados não estão combinando no painel, a FonteDaPágina pode estar desatualizada e não deve ser usada.

Chaves Necessárias nas Configurações

Chave	Tipo	Descrição
apiKey	`String`	Exigido pela Deque para fornecer acesso a usuários autorizados. Acesse a sua Chave de API do Axe DevTools Mobile no portal Conta Axe.

Exemplos

Aqui está um exemplo das mudanças destacadas acima. Exemplos completos estão disponíveis em outras linguagens de cliente.

Exemplo em Python

def runAccessibilityScan(self):
    settings = {}
    settings['apiKey'] = "<your-api-key-here>"
    return self.driver.execute_script('axe:scan', settings)

Exemplo com FonteDaPágina em Python

def runAccessibilityScan(self):
    settings = {}
    settings['apiKey'] = "<your-api-key-here>"
    pageSource = self.driver.page_source
    return self.driver.execute_script('axe:scan', settings, pageSource)