Test Suite

2022.10

falso

Guia do usuário do Test Suite

Última atualização 8 de mar de 2024

Cenários de solução de problemas

Se você tiver problemas, considere os seguintes cenários de solução de problemas:

Automação de dispositivos móveis

Os tópicos abaixo descrevem os problemas e suas correções correspondentes para automação de dispositivos móveis.

Fluxo de trabalho e atividades que geram erros

Descrição: o fluxo de trabalho no Studio gera erros inesperados e os pacotes de atividades não exibem as versões instaladas.

Causa: dentro do seu projeto, a versão principal do pacote de atividades UI.Automation não corresponde à versão principal do pacote de atividades Mobile.Automation . Por exemplo, a versão principal do pacote UI.Automation instalado é 22.10.x, e a versão principal do pacote Mobile.Automation instalado é 22.4.x.

Solução: Certifique-se de que as versões principais dos pacotes de atividade UI.Automation e Mobile.Automation , instalados em seu projeto, correspondam. Por exemplo, par UI.Automation.Activities versão 22.10.x somente com Mobile.Automation.Activities versão 22.10.x.

Importante: Sempre use os patches disponíveis mais recentes para os pacotes de atividades UI.Automation e Mobile.Automation . Por exemplo, se você tiver UI.Automation ou Mobile.Automation 22.10 instalado, baixe os últimos patches disponíveis para 22.10.

Nenhuma rota encontrada para wd/hub/session

Condição: Ao usar o Appium 2.0.

Descrição: Nenhuma rota encontrada para /wd/hub/session.

Solução: Adicione manualmente o seguinte parâmetro antes de iniciar a sessão do Appium: --base-path /wd/hub.

Prefixo do fornecedor necessário para todos os recursos não padrão

Condição: Ao usar o Appium 2.0.

Descrição: todos os recursos não padrão devem ter um prefixo de fornecedor.

Solução: adicione manualmente o prefixo appium: para todos os recursos, como a seguir:

No prompt de comando ou terminal, em vez de --default-capabilities "{\"systemPort\": 8201}", insira --default-capabilities "{\"appium:systemPort\": 8201}".
Na guia Adicionar um dispositivo do Mobile Device Manager, adicione manualmente o prefixo appium: antes do nome de qualquer recurso adicional desejado.

nomedaautomação não pode ficar em branco

Condição: Ao usar o Appium 2.0.

Descrição: o recurso automationName não pode ficar em branco.

Solução: Adicione appium: como um prefixo. Por exemplo, appium:automationName.

Não é possível encontrar o driver instalado

Condição: Ao usar o Appium 2.0.

Descrição: Não foi possível encontrar o driver instalado para suportar os caps especificados.

O Appium 2.0 não instala automaticamente os drivers necessários. Você tem que baixá-los separadamente.

Solução: Instale o driver necessário para sua plataforma.

Para dispositivos Android, instale o driver uiautomator2 usando o comando appium driver install uiautomator2 .
Para dispositivos iOS, instale o driver xcuitest, usando o comando appium driver install xcuitest.

Android

Os tópicos abaixo descrevem os problemas, e suas soluções correspondentes, para dispositivos Android.

A instalação do Appium falha devido ao proxy

Descrição: a execução do comando npm install -g appium (para Appium 1.x) ou npm install -g appium@next (para Appium 2.0) falha porque você está executando atrás de um proxy. O erro lança a seguinte mensagem:

npm ERRO! rede Este é um problema relacionado à conectividade de rede.

npm ERRO! rede Na maioria dos casos, você está atrás de um proxy ou tem configurações de rede ruins.

npm ERRO! rede npm ERR! rede Se você estiver atrás de um proxy, certifique-se de que o npm ERR! a configuração de 'proxy' da rede está definida corretamente. Veja: 'npm help config'

Solução: Configure o npm para usar seu proxy. Siga os passos abaixo:

Obtenha o endereço do servidor proxy e o número da porta:
- Vá para Opções da Internet.
- Selecione a guia Conexões .
- Selecione Configurações da LANe copie o conteúdo dentro dos campos Endereçoe Porta .
Retorne ao prompt de comando do Node.js e execute um comando que segue o formato abaixo:
- Para proxies HTTP: npm config set http://your_proxy_address:your_port_number.
- Para proxies do HTTPS: npm config set https://your_proxy_address:your_port_number.
Execute o comando npm install -g appium (para Appium 1.x) ou npm install -g appium@next (para Appium 2.0) novamente.

Não foi possível acessar o contexto da Web fornecido.

Descrição: não foi possível acessar o contexto da Web fornecido. Verifique se o Android WebView é depurável. Mais informações podem ser encontradas acessando https://developers.google.com/web/tools/chrome-devtools/remote-debugging/webviews.

Remédios:

Use os Seletores de modo de exibição da Web como seletores nativos nos contextos da web que não são reconhecidos.
Se os seletores funcionarem em aplicativos da Web, mas não em um aplicativo, então o aplicativo não habilita a depuração dos WebViews. Nesse caso, consulte Introdução à depuração remota dos Android WebViews e Depuração remota dos WebViews.

Dispositivo não autorizado

Descrição: Dispositivo não autorizado.

Solução: Siga os seguintes passos:

Use o comando adb devices para verificar os dispositivos existentes.
Revogue a depuração no telefone.
Reinicie o servidor ADBusando os seguintes comandos, nesta ordem: adb kill-servere, em seguida adb start-server.
Reconecte o dispositivo e confirme que você concorda com a conexão nesse dispositivo.

Automação do navegador ao iniciar na tela inicial

Descrição: O dispositivo Android inicia uma automação do navegador, em vez do aplicativo fornecido, causando erros.

Solução: Em vez disso, comece com um navegador da web.

Aplicativo Android não inicia

Descrição: o aplicativo Android que você criou não inicia no Mobile Device Manager.

Soluções de problemas:

Passe o mouse sobre o aplicativo e clique em Editar.
Adicione informações sobre o aplicativo nos campos Pacote do aplicativo e Atividade do aplicativo .

iOS

Os tópicos abaixo descrevem os problemas, e suas soluções correspondentes, para dispositivos iOS.

Falha na inicialização de dispositivo físico iOS

Descrição: o dispositivo físico iOS falha ao iniciar.

Solução: Siga os seguintes passos:

Certifique-se de que seu dispositivo está confiando no certificado. No seu dispositivo, acesse Configurações > Geral > Perfis e gerenciamento de dispositivos, toque na entrada de e-mail (por exemplo, Desenvolvimento da Apple: nomedousuario@email.com), e então confie no certificado. Se o dispositivo estiver usando sua conta corporativa, isso não será necessário.
Se você receber um erro de que a porta 8100 não está acessível, feche o Appium (ctrl + c) e reinicie-o
Se você receber um erro diferente, consulte Dispositivo real no driver XCUITest do Appium.

O dispositivo iOS 16.0 falha ao iniciar

Descrição: o dispositivo iOS 16.0 falha ao iniciar ou conectar.

Solução: Instale e use o Appium 2.0 em vez do Appium 1. Consulte a seção Pré-requisitos do dispositivo iOS local para obter mais informações sobre a instalação e gerenciamento do Appium 2.0.