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 os primeiros usuários para as últimas mudanças do axe DevTools Mobile para Appium.

Not for use with personal data

Nota: Se você está começando agora com o axe DevTools Mobile para Appium, vá até 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

Nos 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 que será passado para o executeScript método 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 onde você gostaria de iniciar um teste de acessibilidade, substitua as chamadas do API de fonte de página pelo API de execução de script.

executeScript("axe:scan", Settings)

Parametro	Tipo	Descrição
Configurações	`Object`	Inclui as configurações necessárias para o axe DevTools Mobile. (Veja Chaves Necessárias nas Configurações).
FonteDaPágina	`String`	Opcional: Se você já obteve a FonteDaPágina para a tela atual, pode fornecê-la 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`	Necessário pela Deque para fornecer acesso a usuários autorizados. Acesse sua chave de API do axe DevTools Mobile no axé Conta portal.

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)