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

Description: The workflow in Studio throws unexpected errors, and the activity packages don't display the versions installed.

Cause: Inside your project, the major version of the UI.Automation activity package doesn't match the major version of the Mobile.Automation activity package. For example, the major version of the UI.Automation package installed is 22.10.x, and the major version of the Mobile.Automation package installed is 22.4.x.

Remedy: Make sure that the major versions of the UI.Automation and Mobile.Automation activity packages, installed in your project, match. For example, pair UI.Automation.Activities version 22.10.x only with Mobile.Automation.Activities version 22.10.x.

Importante:

Always use the latest available patches for the UI.Automation and Mobile.Automation activity packages. For example, if you have UI.Automation or Mobile.Automation 22.10 installed, then download the latest available patches for 22.10.

Nenhuma rota encontrada para wd/hub/session

Condition: When using Appium 2.0.

Description: No route found for /wd/hub/session.

Remedy: Manually add the following parameter before starting the Appium session: --base-path /wd/hub.

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

Condition: When using Appium 2.0.

Description: All non-standard capabilities should have a vendor prefix.

Remedy: Manually add the appium: prefix for all capabilities, as follows:

• No prompt de comando ou terminal, em vez de --default-capabilities "{\"systemPort\": 8201}", insira --default-capabilities "{\"appium:systemPort\": 8201}".
• In the Add a device tab from Mobile Device Manager, manually add the appium: prefix before the name of any additional desired capability.

nomedaautomação não pode ficar em branco

Condition: When using Appium 2.0.

Description: The automationName capability can't be blank.

Remedy: Add appium: as a prefix. For example, appium:automationName.

Não é possível encontrar o driver instalado

Condition: When using Appium 2.0.

Description: Could not find the installed driver to support given caps.

Appium 2.0 doesn't automatically install the required drivers. You have to download them separately.

Remedy: Install the required driver for your platform.

• 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.Boolean

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

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

Falha na 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:

1. appium driver uninstall uiautomator2
2. 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 gera 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'

Solução de problema: configure o npm (Node Package Manager) para usar seu proxy. Siga os passos abaixo:

1. Obtenha o endereço do servidor proxy e o número da porta:

   • Vá para Opções da Internet.

   • Selecione a aba Conexões .

   • Selecione Configurações de LAN e copie o conteúdo dentro dos campos Endereço e Porta .

     

2. 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.
3. Execute o comando npm install -g appium (para o Appium 1.x), ou npm install -g appium@next (para o 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.

Remedies:

• 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

Description: Device not authorized.

Remedy: Take the following steps:

1. Use o comando adb devices para verificar os dispositivos existentes.
2. Revoke Debugging on phone.
3. Restart the ADB server, by using the following commands, in this order: adb kill-server, and then adb start-server.
4. 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.

Remedy: Start with a web browser instead.

Aplicativo Android não inicia

Description: the Android app that you created doesn't launch in Mobile Device Manager.

Remedy:

• Hover over the application and click Edit.
• Add information about the app inside the App package and App activity fields.

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

Description: iOS physical device fails to start.

Remedy: Take the following steps:

• 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: [e-mail]), 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

Description: iOS 16.0 device fails to start or connect.

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.

Mau funcionamento do iOS 12.4.5

Description: iOS 12.4.5 doesn't work as expected while paired with Appium 1.22.3.

Cause: This is caused by an issue with Appium.

Remedy: Choose one of the options below:

• Use uma versão inferior do Appium, como 1.17.0.

Importante:

Isso pode causar problemas com a versão mais recente do XCode e pode não funcionar conforme o esperado no macOS Instaler.

• Atualize o dispositivo para versões iguais ou superiores ao iOS 14.