test-suite

2024.10

true

Guia do usuário do Test Suite

ENTREGA:

Automation Cloud Automation Cloud Public Sector Automation Suite Standalone

Last updated 21 de out 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 a seguir descrevem os problemas para dispositivos Android e seus remédios correspondentes.

Falha de conexão devido a `InvalidArgumentException` para recursos

Descrição: a conexão entre um dispositivo local e um aplicativo pode falhar devido a um InvalidArgumentException resultante de uma discrepância no formato esperado de um recurso. O problema surge quando um recurso é inserido como uma String, enquanto o Appium espera um valor booleano. Uma mensagem de erro indicativa inclui:

Failed to create session. 
A new session could not be created. 
Details: io.appium.uiautomator2.common.exceptions.InvalidArgumentException: 
Invalid '<capability name>' setting value type. 
Got java.lang.String. Expected: java.lang.BooleanFailed to create session. 
A new session could not be created. 
Details: io.appium.uiautomator2.common.exceptions.InvalidArgumentException: 
Invalid '<capability name>' setting value type. 
Got java.lang.String. Expected: java.lang.Boolean

Solução: desinstale os seguintes aplicativos do dispositivo local:

io.appium.uiautomator2.server
io.appium.uiautomator2.server.test

Falha de atividade devido a um `WebDriverException`

Descrição: a execução de um fluxo de trabalho de automação móvel que automatiza um dispositivo Android pode resultar em um WebDriverException. Este erro normalmente é exibido como

Parameters were incorrect. We wanted {\"required\":[\"text\"]} and you sent [\"value\"]", "FaultCode":"WebDriverException"}

Solução: desinstale sua versão atual do UiAutomator 2. Em seguida, instale uma versão mais recente, usando os seguintes comandos na ordem determinada:

appium driver uninstall uiautomator2
appium driver install uiautomator2@2.29.0, onde 2.29.0 é a versão que você deseja instalar. Você pode substituir isso por qualquer versão disponível.

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 ERR! network This is a problem related to network connectivity.
npm ERR! network In most cases you are behind a proxy or have bad network settings.
npm ERR! network npm ERR! network If you are behind a proxy, please make sure that the npm ERR! network 'proxy' config is set properly. 
See: 'npm help config'npm ERR! network This is a problem related to network connectivity.
npm ERR! network In most cases you are behind a proxy or have bad network settings.
npm ERR! network npm ERR! network If you are behind a proxy, please make sure that the npm ERR! network 'proxy' config is set properly. 
See: 'npm help config'

Solução de problema: configure o npm (Gerenciador de pacotes de nós) 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. Acesse Depuração remota WebViews para obter mais informações sobre o acesso a contextos da Web.

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 nativo, o aplicativo não habilita a depuração de 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 de navegador em vez do aplicativo determinado, 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.

Não é possível clicar em elementos do WebView no iOS 13

Descrição: quando você clica em um elemento WebView, o seletor não funciona e não é possível automatizar o elemento.

Solução: use simuladores com a versão mais recente do iOS e Appium 2.

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.