Material recomendado pela documentação oficial do Appium.

Se este tutorial te ajudou, não esquece de deixar uma estrelinha ⭐️ 🌟

Este material é um guia para o setup do ambiente de configuração e uso do Appium para automação de testes funcionais em dispositivos móveis. Dentre outros aprendizados, destaco os seguintes pontos como principais aprendizados:

• Entender como funciona o framework Appium e como fazer o setup desta aplicação nas plataformas: Windows, Linux e Mac;
• Como instanciar um dispositivo Android emulado através do Android Studio;
• Como fazer mapeamento de elementos de uma aplicação em seu dispositivo;
• Como instalar um aplicativo da PlayStore em seu dispositivo emulado;
• Como iniciar testes de UI em sua aplicação através do Appium com a linguagem de programação Python;
• Conhecer sos e funcionalidades específicas do Appium.

A versão em inglês deste tutorial está aqui em appium-en.

🗂 A organização do tutorial se dá nas seguintes seções:

• Introdução
• Setup do ambiente
• Download de tudo que precisa
• Configuração Windows
• Configuração Linux
• Configuração Mac
• Setup simplificado para todos os SOs
• Instalação do Appium
• Appium Doctor: como validar se tá tudo configurado?
• Checklist
• Iniciando o Appium
• Comandos ADB
• Emulando um dispositivo Android através do Android Studio
• Recursos específicos do Appium

✏️ Tutoriais contidos aqui

• Tutorial 1: Instalando uma aplicação no meu dispositivo Android emulado
• Tutorial 2: Desired Capabilities: o que são e como iniciar uma sessão com o Appium
• Tutorial 3: Identificando os elementos da nossa aplicação
• Tutorial 4: Realizando atividades de GESTOS via Appium
• Tutorial 5: Realizando um fluxo simples de teste funcional
• Tutorial 6: Gravando nossas ações e transformando isso em código
• Tutorial 7: Operações aritméticas com a Calculadora nativa do Android
• Tutorial 8: Replicando tudo o que fiz utilizando apenas Python
• Tutorial 9: Operações aritméticas com a Calculadora nativa do Android - Fase 2
• Tutorial 10: Operações aritméticas com a Calculadora nativa do Android - Fase 3: organizando o código com padrões de projeto e realizando fluxo de teste funcional

Projetos com Appium

A parte 2 deste curso está relacionado a recursos e funcionalidades específicas do Appium. Os exemplos listados aqui serão em Python, mas quase todos os recursos usados aqui também existem em qualquer outra linguagem de programação que o Appium tenha suporte.

• Comandos sobre o dispositivo
• Interações
• Controle de recursos de rede
• Controle do sistema

🚧 Este documento sofrerá ajustes e complementos ao longo do tempo 😁

Este material também está em inglês e pode ser encontrado aqui.

Qualquer sugestão de melhoria ou correção, por favor entrar em contato 😍

Iniciei a elaboração deste tutorial porque pra aprender essa ferramenta tive que recorrer a diferentes fontes e tive que praticar muito pra ter dicas, criar tutoriais, entender melhor a dinâmica, etc. Espero que este documento seja muito útil pra você e te incentivo a também compartilhar o que você for aprendendo 🤘

Appium é uma ferramenta open-source e multi-plataforma (isso quer dizer que funciona em Windows, Linux e Mac) e cujo foco é de interações via UI em dispositivos móveis, possibilitando a automação de aplicações: nativas, híbridas e sites mobile para as plataformas Android e iOS.

Considero Appium uma excelente ferramenta para quem quer começar a aprender automação em dispositivos móveis ou para quem já é da área de mobile e gostaria de se aprofundar mais sobre o assunto.

Links importantes para esta seção:

Página oficial do Appium

Página oficial do repo do Appium no GitHub

Como dito mais acima, a finalidade do Appium é testar aplicações em dispositivos móveis, e aplicações podem ser classificadas em três diferentes naturezas : nativas, híbridas e móveis. Qual a diferença entre elas?

• Nativas: aquelas aplicações que foram desenvolvidas especificamente para Android ou iOS, ou seja, a partir de seus específicos SDKs.
• Híbridas: aquelas que são desenvolvidas em HTML, CSS, JavaScript e que são compatíveis com qualquer plataforma (Android, iOS, Windows).
• Móveis: aquelas que podemos acessar através de um link, via página web.

Nesta seção vamos ver os passos para realizarmos o setup do ambiente para Windows, Linux e Mac. Todos os meus projetos faço utilizando o Mac, então tendo a passar informações mais detalhadas para este SO.

✨ Uma dica muito importante:

Digo o que fazer para cada sistema operacional, mas você também pode optar por uma configuração mais simples (e efetiva da mesma forma) e que vai te poupar de muito tempo e dor de cabeça - confie em mim :) Se você quiser ir por esse caminho, pode pular direto para o tópico "Forma simplificada para Windows/Linux/Mac". O mesmo procedimento é utilizado para qualquer sistema operacional.

Durante o nosso workshop vamos utilizar algumas ferramentas essenciais para a prática de automação. Baixe e instale as seguintes ferramentas, que são comuns para Windows, MAC ou Linux:

• Appium Desktop: é a interface da ferramenta Appium que será o foco do nosso workshop. O download está disponível aqui: (aqui tem um acervo para vários Sistemas Operacionais. Baixe apenas aquele que for direcionado para o seu SO.)

• JDK (JAVA Development Kit): https://www.java.com/pt_BR/download/

• Android Studio: é um pacote do Android Studio que possibilita que possamos instanciar dispositivos móveis de várias configurações e modelos de forma emulada e em vários níveis de API. Para isso, é preciso baixar o Android Studio e, durante o setup, marcar a opção de instalar também o AVD: https://developer.android.com/studio/index.html?hl=pt-br

Depois de fazer o download de todo o conteúdo, agora podemos avançar com o setup do ambiente. Podemos configurar as variáveis de ambiente à nível de sistema (abaixo eu deixo detalhado como fazer para cada SO) e também podemos fazer de maneira bem mais simplificada, onde explico melhor após o detalhe de setup para cada SO.

Depois de realizadas as instalações do Appium Desktop, JAVA, Android Studio e da sua IDE, é hora de configurarmos as variáveis de ambiente para que seu sistema operacional identifique os processos e as aplicações de forma mais rápida e prática. Para isso, abra o seu terminal, identifique a localização de instalação dos pacotes e os exporte para a variável PATH. Após identificar a localização de onde foi instalado o seu Android, copie o caminho da pasta. Por exemplo, para macOS a localização normalmente fica em:

/Users/user_name/Library/Android/sdk

Então será a partir desta pasta que vamos identificar os outros caminhos necessários, como:

/Users/user_name/Library/Android/sdk/platform-tools
/Users/user_name/Library/Android/sdk/tools
/Users/user_name/Library/Android/sdk/build-tools

Quando você identificar estes caminhos em sua máquina, é hora de exportar esses valores para a variável PATH. Para isso, confira se no diretório "/Users/user_name" existe o arquivo ".bash_profile". Caso não exista, crie:

touch .bash_profile

O próximo passo é abrir o editor de texto do arquivo:

open -e ~/.bash_profile

Digite os comandos como sugere o exemplo a seguir e salve o arquivo:

export ANDROID_HOME=/your/path/to/Android/sdk 
export PATH=$ANDROID_HOME/platform-tools:$PATH 
export PATH=$ANDROID_HOME/tools:$PATH 
export PATH=$ANDROID_HOME/build-tools:$PATH 
export JAVA_HOME=/your/path/to/jdk1.8.0_112.jdk/Contents/Home 
export PATH=$JAVA_HOME/bin:$PATH

Após o download (link acima) e instalação do JDK do seu ambiente Windows, é hora de configurar as variáveis de ambiente. Para isso, siga as opções de menu:

1. Propriedades do Sistema >> Configurações avançadas do sistema >> Variáveis de ambiente >> Variáveis de usuário >> Novo.
2. Insira o nome da variável como "JAVA_HOME" e insira como valor a localização exata do seu arquivo jre, por exemplo, "C:\Arquivos de Programa\Java\jdk1.2.2_2\jre".
3. Na seção de variáveis de sistema, dê um clique duplo em "Path" e adicione a expressão "%JAVA_HOME%\bin". Isto significa que você está adicionando o mesmo valor criado para JAVA_HOME, só que também para a pasta \bin.
4. É só clicar OK e aplicar as mudanças de configuração.

Agora, para baixar (link acima) e instalar o Android SDK, siga os passos:

1. Siga o mesmo passo #1 descrito acima até alcançar o campo de variáveis de ambiente.
2. Agora, insira o nome da variável como "ANDROID_HOME" e insira como valor a localização exata onde seu Android SDK foi instalado, por exemplo, "C:\android-sdk".
3. Agora, mais uma vez precisamos adicionar o valor da sua nova variável à sua variável global do sistema, que é o Path: "%ANDROID_HOME%\platform-tools" e também "%ANDROID_HOME%\tools".
4. É só clicar OK e aplicar as mudanças de configuração.

A configuração de variáveis de ambiente para Linux funciona de forma muito semelhante a do Mac. Basta que vc identifique o caminho exato de instalação do JDK e do Android e aplicar (através de export) os caminhos no seu arquivo de configuração global, que neste caso é o ~/.bashrc

Por exemplo, para Linux a localização normalmente fica em:

/Users/user_name/Library/Android/sdk

Então será a partir desta pasta que vamos identificar os outros caminhos necessários, como:

/Users/user_name/Library/Android/sdk/platform-tools
/Users/user_name/Library/Android/sdk/tools
/Users/user_name/Library/Android/sdk/build-tools

Quando você identificar estes caminhos em sua máquina, é hora de exportar esses valores para a variável PATH, como sugere o exemplo a seguir:

export ANDROID_HOME=/your/path/to/Android/sdk 
export PATH=$ANDROID_HOME/platform-tools:$PATH 
export PATH=$ANDROID_HOME/tools:$PATH 
export PATH=$ANDROID_HOME/build-tools:$PATH 
export JAVA_HOME=/your/path/to/jdk1.8.0_112.jdk/Contents/Home 
export PATH=$JAVA_HOME/bin:$PATH

✨ Dica - Windows/Linux/Mac: Para identificar onde está a sua pasta para JAVA_HOME, é só usar o seguinte comando no terminal:

which java

Deverá ser retornado o caminho até seu pacote JAVA.

✨ Dica 2 - Linux/Mac: Para evitar que suas variáveis de ambiente percam os valores, salve o conteúdo da variável no seu arquivo bashrc (Linux) ou bash_profile (macOS). Após salvar os valores, não esqueça de "compilar" o arquivo para as mudanças serem refletidas: Para macOS:

source ~/.bash_profile

Para Linux:

source ~/.bashrc

Se você quiser simplificar a sua configuração de ambiente, é só utilizar o atalho de configuração do Appium e inserir manualmente os caminhos para as suas variáveis ANDROID_HOME e JAVA_HOME. Esta etapa é bem mais simples e da mesma forma efetiva para uso da ferramenta. Basta seguir os passos adiante:

Abra sua ferramenta Appium Desktop e clique no botão "Edit Configurations".

Quando você clicar em "Edit Configurations", um popup vai abrir com 2 campos: ANDROID_HOME e JAVA_HOME. É só você identificar estes caminhos na sua máquina (no setup de configuração para cada SO eu deixei comandos e dicas para obter estes valores), copiar e colar nestes campos e em seguida clicar em "Save and Restart". Pronto, configuração do Appium realizada com sucesso :)

A instalação do Appium é bastante simples e não requer configuração adicional - além da do Android e do JDK. Basta baixar o Appium Desktop na página oficial do Appium(como no link do começo do documento) ou via linha de comando através do terminal:

npm install -g appium

ATENÇÃO: Não instale o Appium com sudo.

✨ Dica - O que é npm?

Npm é o gerenciador de downloads para pacotes node.js.

Uma funcionalidade bem legal que o Appium oferece é o pacote Appium-doctor, cuja finalidade é conferir o checklist necessário para que seu ambiente funcione. Caso algo esteja faltando, o Appium-doctor te lista exatamente o que falta. Ele também confirma o que tá configurado como esperado. Para instalá-lo, é só instalar o pacote npm no seu terminal:

npm install -g appium-doctor --android

✨ Dica: Estamos usando a flag --android para indicar a plataforma que vamos usar o Appium. Caso fôssemos usar o iOS, usaríamos a flag --ios--.

Depois de instalado o Appium-doctor, é só fazer a chamada via terminal:

appium-doctor

Abaixo segue um exemplo de como é o retorno do Appium-doctor via terminal:

➜  bin appium-doctor
info AppiumDoctor Appium Doctor v.1.10.0
info AppiumDoctor ### Diagnostic for necessary dependencies starting ###
info AppiumDoctor  ✔ The Node.js binary was found at: /usr/local/bin/node
info AppiumDoctor  ✔ Node version is 8.11.4
WARN AppiumDoctor  ✖ Xcode is NOT installed!
info AppiumDoctor  ✔ Xcode Command Line Tools are installed in: /Library/Developer/CommandLineTools
info AppiumDoctor  ✔ DevToolsSecurity is enabled.
info AppiumDoctor  ✔ The Authorization DB is set up properly.
info AppiumDoctor  ✔ Carthage was found at: /usr/local/bin/carthage
info AppiumDoctor  ✔ HOME is set to: /Users/BEZERRA
WARN AppiumDoctor  ✖ ANDROID_HOME is NOT set!
WARN AppiumDoctor  ✖ JAVA_HOME is NOT set!
WARN AppiumDoctor  ✖ adb could not be found because ANDROID_HOME is NOT set!
WARN AppiumDoctor  ✖ android could not be found because ANDROID_HOME is NOT set!
WARN AppiumDoctor  ✖ emulator could not be found because ANDROID_HOME is NOT set!
WARN AppiumDoctor  ✖ Bin directory for $JAVA_HOME is not set
info AppiumDoctor ### Diagnostic for necessary dependencies completed, 7 fixes needed. ###

Tudo que estiver acompanhado do símbolo ✔ significa que está instalado corretamente. Tudo que estiver acompanhado do símbolo ✖ significa que NÃO está instalado ou identificado. Esses casos você deve ajustar.

O pacote do Xcode é específico para iOS, então, para Android, não devemos nos preocupar.

Se você chegou até aqui, significa que provavelmente o seu setup está pronto e agora você já pode usar todos os recursos do Appium! Só para checar, instalamos e configuramos:

• Appium Desktop ✔
• Android Studio (pacote AVD) ✔
• JAVA ✔
• IDE ✔
• Configuração de variáveis de ambiente ✔

Depois de tudo configurado, é hora de iniciarmos com o Appium Desktop. Assim que abrimos o Appium Desktop, esta é a carinha inicial que temos contato:

Observe que de cara já temos 2 campos preenchidos:
HOST: 0.0.0.0
Port: 4723

Estes são valores padrões do Appium e indicam que sempre que você começar a realizar requisições (lembra que o Appium é baseado em servidor HTTP?), o Appium irá utilizar o Host 0.0.0.0 e o serviço irá funcionar na porta 4723. Caso você queira mudar estes valores (quando algum outro serviço já está alocado para esta porta, por exemplo), é só você realizar a customização dessa configuração manualmente clicando no botão Advanced, que fica ao lado do já selecionado Simple. Você também pode salvar suas configurações personalizadas e exportá-las através do button Presets. Eu, particularmente, nunca precisei utilizar nenhuma das configurações além das que já vem por padrão. Também não vi nenhum material pela internet em que fosse necessário customizar a configuração. Se quer um conselho, siga com essa configuração padrão que tudo vai funcionar bem :)

Explicada essa tela inicial, agora podemos clicar em Start Server e observar já a segunda tela do Appium: uma escuta da chamada HTTP. Observe que ele indica aí exatamente o endereço onde o serviço está sendo executado (que são inseridos nos campos de Host e Port da tela anterior, onde deixamos os valores padrões).

Agora podemos ir para a tela seguinte do Appium, onde vamos começar iniciar uma sessão (essa é a expressão utilizada quando vamos iniciar o uso do Appium), e pra isso vamos clicar no ícone da lupa, onde diz: Start Inspector Session (como a imagem abaixo).

Agora podemos ver uma tela com vários campos para o Appium, mas aqui podemos seguir na aba Custom Server, que já vem escolhida por padrão. Observamos também os seguintes campos já preenchidos:
Remote Host: 127.0.0.1
Remote Path: /wd/hub
Remote Port: 4327

O Remote Port já falamos anteriormente. Remote Host tá com o valor de localhost para o serviço, mais uma vez você pode alterar caso já tenha algum serviço rodando local. Caso contrário, pode deixar esse valor mesmo. Remote Path também é um valor padrão do Appium e nunca precisei alterar, sempre deixo esse mesmo valor.

Agora chegou o momento de aprendermos um dos pontos mais importantes quando começamos a usar o Appium: entender o funcionamento dos Desired Capabilities (abaixo eu deixo o link oficial listando todos os valores que podemos usar nos desired capabilitites). Desired Capabilities pode ser grosseiramente traduzido por "Configurações desejadas". É onde você vai informar ao Appium o que é pra ele fazer exatamente.

Como citado mais acima, o Appium funciona através de requisições HTTP e, como padrão deste tipo de comunicação, utilizamos arquivos em JSON para indicar qualquer mensagem. O appium nos traz uma interface gráfica com campos de entrada de texto mas, após preenchermos os campos de texto, ao lado ele já converte o que digitamos em um arquivo JSON. Você pode editar diretamente no JSON ou usar o campo de texto, como quiser. As duas formas funcionam bem.

Para iniciarmos uma sessão vamos precisar de pelo menos 2 campos, que são:

{
    'platformName': 'Android',
    'deviceName': '<InserirOnomeDoSeuDispositivoAqui>'
}

🚦 Atenção: para entender como obter o valor do nome do seu dispositivo, você vai precisar ler a seção mais adiante sobre comandos ADB.

Os nomes são bem intuitivos, e aí estou criando um dicionário com a chave 'platformName' para indicar a plataforma que irei utilizar, que pode ser: Android, Windows, iOS. Já o identificador do dispositivo móvel iremos inserir em 'deviceName', e podemos obter esse valor através do comando adb 'adb devices' que já explicamos mais acima. Assim fica um exemplo de preenchimento destes campos básicos e ao lado já o retorno do conteúdo em JSON:

Página oficial do Appium listando todos os Desired Capabilities:
http://appium.io/docs/en/writing-running-appium/caps/

Podemos usar o Appium em dispositivos reais, dispositivos emulados ou até mesmo em farms de dispositivos da Amazon, que funcionam com o mesmo conceito de computação em nuvem, onde você aloca recursos sob demanda e paga apenas o que for consumido. Durante nossos estudos podemos utilizar dispositivos emulados para a realização dos nossos testes. Isso nos dá grande versatilidade pela possibilidade de escolher o tipo de dispositivo e a versão de Android que iremos utilizar. Desta forma, é possível validar o mesmo apk em cenários diversos apenas alterando configurações, onde atingimos uma característica muito forte no Android que é a granularidade de versões: https://developer.android.com/about/dashboards?hl=pt-br

Antes de tudo... o que é um dispositivo emulado?
É a instanciação (criação) de um dispositivo que simula um celular real, só que ele é emulado a partir dos recursos da sua máquina. É como se fosse uma máquina virtual, só que o Sistema Operacional (imagem) utilizado será alguma versão oficial do Android e o formato da máquina será uma réplica do celular de verdade, inclusive sob aspectos de tamanho das telas.

Vamos utilizar um recurso do próprio Android Studio para instanciarmos nosso dispositivo emulado: o Android Virtual Device Manager. Para acessá-lo, basta abrir o seu Android Studio e seguir até o seguinte ícone:

Assim que você clicar no ícone do AVD Manager, o seguinte popup vai abrir e você vai clicar em + Create Virtual Device... para criar o seu novo dispositivo emulado, como na imagem a seguir:

Nesta nova tela, podemos escolher qual o tipo de dispositivo que queremos: TV, Phone, Wear OS, Tablet; além da marca do produto, tamanho e resoluções de tela e também a densidade. Você pode emular qualquer variação desses produtos. Vamos focar em phone e eu gosto bastante de utilizar o produto Pixel 2 em meus estudos, já que é um produto da Google e que tem um ótimo tamanho de tela, mas você fique à vontade de utilizar a variação de Phone que você achar melhor. Escolhido isso, é só clicar em Next.

Escolhido o produto que você quer prosseguir em seus estudos, agora é hora de escolher a versão do Android que você irá emular em seu produto. Veja que existe uma lista com várias versões anteriores do Android disponíveis para download. Neste exato momento, estamos na versão do Android Q no mercado e o Android R já está com sua versão Beta disponível para download. Usei algumas vezes o Android Q mas não achei a imagem tão completa em termos de recursos como o Android P, que é minha versão favorita atualmente. Vou prosseguir nos testes com o Android P, mas fique à vontade para baixar a versão que você quiser. Ah, você pode criar dispositivos com versões de Android diferentes e ir usando pra ver qual versão você acha que atende melhor às suas necessidades. Caso a imagem ainda não esteja disponível para você, clique em download. Caso já tenha baixado, é só selecionar a imagem e clicar em Next

Estou usando a seguinte configuração para meu dispositivo emulado:
Modelo de Device: Pixel 2
Versão de Android: Android P

Dispositivo criado, tente realizar algumas ações nele como abrir aplicativos, utilizar botões de acesso como Home, Back, Recent Apps.

Um mundo de possibilidades que também podemos explorar com dispositivos Android é que podemos usar comandos ADB no nosso dispositivo emulado e já ver que ele responde da mesma maneira que um dispositivo real. A próxima seção vai falar um pouco sobre isso.

Lembra quando falamos dos Desired Capabilities? Agora podemos adicionar a configuração para abrir o emulador em conjunto com a requisição de servidor do Appium. Faremos isso a partir do nome que demos ao Virtual Device que cadastramos anteriormente. Assim:

Alguns pontos importantes sobre este tópico:

• Em breve farei um material falando como emular um dispositivo iOS.
  
• Existem outras ferramentas que emulam dispositivos Androids mas, das que testei, nenhuma é tão boa quando a do Android Studio. Por esse motivo prefiro me manter nele e recomendo o uso.
  

ADB é uma abreviação para Android Debug Brigde. Grosseiramente traduzindo, é uma ferramenta que faz uma "ponte" de comunicação entre o seu computador e o seu dispositivo móvel Android através de linhas de comando. Através do ADB, é possível que possamos manipular o dispositivo através de comandos, de forma muito prática, como:

• Instalar/desinstalar aplicativos;
• Mudar configurações internas, como: tempo de desligar tela, bloqueio/desbloqueio de tela, etc.
• Habilitar/desabilitar funções de conexões, como: wifi, dados, modo avião.
• Transferência/manipulação de arquivos;
• Reiniciar e desligar o dispositivo - não funciona para ligá-lo (mas isso pode ser resolvido através de frameworks).

É também possível automatizar algumas atividades de rotina combinando comandos ADB e Python Script.

Como o assunto sobre comandos ADB merece maior aprofundamento e dedicação, criei um repositório à parte para falar mais sobre o tema: repo comandosadb

Links importantes desta seção:
Um pouco mais sobre comandos ADB: https://developer.android.com/studio/command-line/adb?hl=pt-br
Um pouco Python Script: https://realpython.com/run-python-scripts/
Meu Repositório sobre Comandos ADB: https://github.com/clarabez/comandosadb

Para realizar este tutorial é preciso que você tenha:

• Dispositivo emulado ativo - passo a passo na seção anterior
• ADB configurado e funcionando em seu terminal
• Conta na Play Store

O primeiro de tudo é escolher algum aplicativo disponível na Play Store para a realização dos estudos. Ultimamente tenho utilizado o aplicativo das Casas Bahia, pois tem boa parte de seus elementos mapeados e também porque tem diversos menus, itens e uma excelente usabilidade, o que facilita no processo de aprendizado. Daí, vamos procurar pelo aplicativo das Casas Bahia na Play Store e vamos chegar na página do aplicativo que deve parecer como esta abaixo:

Agora, é só copiar a URL da página principal do aplicativo, que no meu caso é o seguinte valor:

https://play.google.com/store/apps/details?id=com.novapontocom.casasbahia

Agora vamos acessar um site chamado Evozi, que tem como objetivo baixar qualquer aplicativo da Play Store tendo como base apenas o endereço URL da aplicação da Play Store, como mostro a seguir:

Agora é só clicar em Generate Download Link e realizar o download da sua aplicação. Veja que ela será baixada no formato .apk. Agora é só salvar em alguma pasta do seu computador e vamos instalar essa aplicação em seu dispositivo emulado, e isso podemos fazer de duas maneiras: segurando e arrastando o aplicativo; utilizando comando ADB. Vou ensinar as duas formas.

Segurando e arrastando:
Essa forma é super simples, basta que você esteja com seu dispositivo emulado ativo e em paralelo abra a pasta que sua aplicação está. Agora, segure o seu aplicativo e arraste até o seu dispositivo móvel e, quando chegar no dispositivo, pode soltar. Você verá que vai aparecer uma imagem de instalando... e em poucos segundos sua aplicação estará disponível em seu dispositivo. É só acessar via menu e utilizar para ver que funciona direitinho.

Através de comandos ADB:
Esta forma é mais elegante. É só você abrir o terminal, ir até a pasta que está sua aplicação (via terminal mesmo) e utilizar o seguinte comando:

adb install nome-do-apk

Com isso, o aplicativo deve ser instalado corretamente e já aparecer disponível na lista de aplicações do seu dispositivo.

Observação:
Aplicações na Play Store normalmente são bem ativas e constantemente sofrem alguma atualização de versão. Nessas atualizações, pode ser que alguma aplicação pare de funcionar em seu dispositivo. Por exemplo, já me aconteceu de a aplicação das Casas Bahia não mais funcionar em meu dispositivo porque deixou de ser compatível com a arquitetura dos dispositivos emulados. Isso pode acontecer. Caso isso aconteça com você, é só escolher uma outra aplicação para seguir seus estudos.

📝 Sugestão de exercícios:
Tente baixar outras aplicações de sua preferência e tente instalar em seu dispositivo via comando ADB e também arrastando o pacote até seu dispositivo.

Links utilizados neste tutorial:
Evozi - APK Downloader: https://apps.evozi.com/apk-downloader/
Google Play Store: https://play.google.com/store/apps?hl=pt_BR

Para realizar este tutorial é preciso que você tenha:

• Dispositivo emulado ativo - passo a passo na seção anterior
• ADB configurado e funcionando em seu terminal
• Aplicação da Play Store já instalada no dispositivo
• Appium Desktop configurado e funcionando

Caso você ainda não tenha lido a seção Iniciando com o Appium, recomendo que você dê um pulo lá para ler alguns conceitos que vai ajudar bastante neste segundo tutorial, especialmente porque fala da importância que são os Desired Capabilites para o Appium. Reforçando o que foi dito por lá, os Desired Capabilites são uma parte muito especial e importante quando estamos trabalhando com Appium. É a partir deles que vamos dizer o que queremos fazer exatamente utilizando o Appium.

Como mostra a documentação oficial do Appium sobre os Desired Capabilites, temos uma extensa lista de opções de uso e podemos partir de um uso mais genérico até um uso mais específico. Aqui vamos realizar a ação destas nesses dois formatos.

Desired Capabilities - forma genérica

Para isso, vamos precisar identificar apenas qual o platformName e o deviceName, que querem dizer o a plataforma (Android, iOS, Windows) e o nome do produto (serial number), respectivamente. O primeiro valor é bastante simples de saber, basta indicar a plataforma que você está usando no seu estudo - durante este tutorial irei usar Android. Para saber o Serial Number do seu celular, é só utilizar o seguinte comando ADB em seu terminal:

    adb devices

O comando irá retornar algo mais ou menos assim:

Assim que dou o comando adb devices o serviço ADB é iniciado e em seguida o valor de identificação do meu celular é retornado, que no caso foi: emulator-5554. É este o valor que vamos usar no campo deviceName.

Uma informação importante:
Estou utilizando um celular emulado, portanto este é o valor padrão do Android Device Manager do Android Studio para 1 dispositivo emulado. Se você estiver utilizando um dispositivo real, este valor será bem diferente do que foi retornado pra mim.

Segue então valores que irei utiliar para o Desired Capabilities:

{
    'platformName': 'Android',
    'deviceName': 'emulator-5554',
    'avd': 'AppiumP'
}

Agora com os valores identificados, podemos abrir o Appium até chegarmos na tela que temos a aba de Desired Capabilites e preencher os campos como mostra a imagem a seguir:

Repare que eu insiro o valor apenas na aba Desired Capabilities e automaticamente o Appium converte tudo em JSON na tela ao lado, onde aponto com uma seta. Uma dica que acrescento é a de salvar essa sua configuração, pois ela será a base de alguns outros tutoriais que vamos fazer. Para isso, é só clicar em Save As. Para acessar qualquer capability já salva, é só acessar a aba Save Capability Sets, que fica ao lado da aba Desired Capabilities.

Agora, é só clicar no botão Start Session que o Appium irá iniciar uma sessão com base nas informações que indicamos. Com os campos corretos e identificados (ou seja, celular detectado e compatível com o que você informou), agora podemos ver a seguinte tela:

Esta é a tela de início de atividades com o Appium, que veremos nos próximos tutoriais. Aqui já é possível ver que o Appium tirou um screenshot da tela em que estava o nosso celular no momento em que demos início à sessão. Essa é uma das características do Appium: ele espelha a tela exatamente de onde você iniciou a sessão - em casos de uso genérico do Desired Capabilities. Além disso, também já vemos novos botões e novas seções. Agora vamos ver como podemos iniciar uma sessão sendo mais específicos com as informações que queremos que o Appium trate.

Desired Capabilities - forma específica

Vimos anteriormente como criamos uma sessão genérica com o Appium e conhecemos também algumas telas e algumas características à medida que fomos avançando as ações. A finalidade de você iniciar uma sessão de forma mais específica é que vc indica ao Appium exatamente a tela que ele deve iniciar a sessão.

Exemplo:
Vamos querer automatizar nossa calculadora nativa do Android. Como já sabemos que nosso foco será essa aplicação específica, podemos ir direto para ela, pulando o fluxo em que chamamos a aplicação através de interface gráfica. Para isso, vamos incrementar os valores de Desired Capabilities que já tínhamos preparado no passo anterior, só que agora precisamos dos valores para as chaves: appPackage e appActivity. Segue explicação para cada um dos campos:

appPackage:
É o nome do pacote da sua aplicação. Isso é definido à nível de desenvolvimento da aplicação.

appActivity:
Uma tela em desenvolvimento Android é chamada de activity. Este valor é basicamente para indicar em qual tela da aplicação você quer estar quando a sessão for iniciada.

E como obter estes valores?
Através de comando ADB! <3 Para isso, vamos para nosso celular em teste (emulado ou real) e vamos abrir a aplicação que queremos testar e vamos deixar exatamente na tela que queremos fazer nossos teses. Depois disso, vamos usar o seguinte comando no terminal:

    adb shell dumpsys window windows | grep -E 'mCurrentFocus'

Visualmente fica assim:

Note que deixo em destaque o seguinte trecho do que foi retornado na estrutura:

com.android.calculator2/com.android.calculator2.Calculator

Ess é trecho em que temos tanto o valor de appPackage quanto o de appActivity. A divisão entre os dois campos se dá pela / (barra) que existe bem no meio do trecho. Sempre o que tiver antes da barra será o valor do package. O que tiver depois será o do activity da sua aplicação. Agora é só copiar e preencher nos campos com mostro a seguir:

{
    'platformName': 'Android',
    'deviceName': 'emulator-5554',
    'avd': 'AppiumP',
    'appPackage': 'com.android.calculator2',
    'appActivity': 'com.android.calculator2.Calculator'
}

Visualmente fica assim (em destaque no JSON o que eu acrescentei):

Agora, com todos os valores preenchidos, você pode salvar novamente esta configuração clicando em Save As... e em seguida podemos iniciar nossa sessão clicando em Start Session. Quando a sessão for iniciada, você verá que agora o print da tela será direto da aplicação Calculadora, que foi a que indiquei nos campos de appPackage e de appActivity. Veja que no seu dispositivo (emulado ou real) também vai estar na mesma tela que você indicou:

📝 Sugestão de exercícios:
Tente utilizar o comando ADB deste tutorial para identificar pacote e activity em aplicações diferentes, inclusive alguma que você baixou no Tutorial 1.

Links Importantes para este tutorial:
Página oficial do Appium com os Desired Capabilities listados: http://appium.io/docs/en/writing-running-appium/caps/

Para realizar este tutorial é preciso que você tenha:

• Realizado o Tutorial 2

Realizar a identificação de elementos é muito fácil quando estamos trabalhando com ferramentas/frameworks que tem o webDriver como base. Inclusive, a simples ação de mapear elementos de aplicações móveis também pode ser realizada através do UIAutomator, que é uma funcionalidade nativa também do Android Studio. Se você já trabalhou com Selenium, sabe que para mapearmos elementos de uma página web, basta clicar com o botão direito do mouse e selecionarmos a opção "inspecionar elementos" ou "inspecionar".

Com falei mais acima, identificar elementos é relativamente simples, porém, o grande desafio do mapeamento de elementos está em mapear de maneira inteligente e eficiente, de maneira que seu código não vá quebrar e, além disso, de maneira que a manutenabilidade do seu código não seja comprometida.
Qual a melhor prática?
No mundo perfeito, todos os elementos de uma aplicação/página web estão identificados seguindo boas práticas de desenvolvimento, com IDs intuitivos e únicos. Outro excelente caminho é se você tem acesso aos desenvolvedores da aplicação e consegue solicitar esse tipo de ajuste a eles. Porém, sabemos que essa é uma realidade muito específica e que não estará presente na maioria das aplicações que formos interagir - especialmente agora na nossa fase de estudos.

Uma ótima prática é utilizar partes estáticas quando temos IDs dinâmicos. No caso de usar IDs dinâmicos, os seus valores serão atualizados a cada acesso, ação normalmente realizada pelo framework utilizado em nível de desenvolvimento. Uma boa dica para isso? CSS Selector.

Em algums casos você vai ter que trabalhar com hierarquia dos seus elementos. Nestas condições, opte sempre pela hierarquia mais próxima ao elemento em foco e, melhor ainda, se o elemento pai/filho possuir IDs únicos.

Outra dica, já acompanhada de um exemplo para tornar o entendimento mais claro, é poder dividir os valores (muitas vezes gigantes) que você pode encontrar por XPATH, tornando-os mais curtos:

<button type=“submit” class=“signup-button button--black button--active”>Signup Here!</button>

Diante deste exemplo simples de XPATH, onde vemos um valor grande, podemos tratá-lo da seguinte maneira:

WebElement signupXPath = browser.findElement(By.xpath(“//button[contains(@id, ‘signup-button’)]”));

Também, de forma muito similar, podemos realizar a identificação do elemento a partir de CSS Selector:

WebElement signupCSS = browser.findElement(By.cssSelector(“button[class*=‘signup-button’]”));

Destas formas seu elemento será sendo identificado da mesma maneira, só que agora de forma mais legível e com menor vulnerabilidade de quebra futura :)

Qual a prática devemos evitar?
A prática ruim mais comum que vejo acontecer é o uso de XPATH longos, sem tratamentos, e uso de identificadores dinâmicos, que deixam de fazer sentido numa segunda execução - visto que ele muda a cada load da página.

Agora identificando elementos no Appium
Para realizar a identificação de elementos, basta dar um clique no elemento que você deseja mapear e, na barra lateral direita, irá aparecer uma lista de opções de valores que você pode utilizar no seu mapeamento:

No meu print, utilizei o elemento "9" e me foi retornado 2 opções: id, xpath. Como o número 9 tem ID e vejo que ele é único (clicando nos demais elementos pude perceber isso), então decidi que o valor de ID é a melhor abordagem para eu seguir na identificação dos elementos da minha calculadora.

📝 Sugestão de exercício:
Para praticar um pouco mais, sugiro que você vá observando a diferença entre elementos da sua aplicação. Tente também mapear elementos de alguma outra aplicação e observar se você tem o campo de ID e XPath.

Para realizar este tutorial é preciso que você tenha:

• Dispositivo emulado ativo - passo a passo na seção anterior
• ADB configurado e funcionando em seu terminal
• Aplicação da Play Store já instalada no dispositivo
• Appium Desktop configurado e funcionando

Vamos dividir este tutorial para cada uma das funcionalidades: Swipe by Coordinates e Tap by Coordinates.

Swipe by Coordinates - deslizar o dedo numa coordenada específica

Esta funcionalidade de fazer swipe, ou melhor, de deslizar o dedo na tela em uma direção é muito utilizada (especialmente no Android) para abrir menu suspenso (inferior ou superior) mudar de tela, encerrar aplicações, inserir senha personalizada de desbloquear tela, etc. No Appium, para utilizar esta funcionalidade, é só clicar no botão que está em destaque na imagem abaixo:

Para exemplificar o uso dessa funcionalidade, vou realizar a ação de baixar o menu suspenso superior do dispositivo Android. Com minha sessão do Appium iniciada para o meu Android emulado, irei realizar o gesto de deslizar o dedo a partir do topo da tela até mais ou menos a metade.

Note que quando posicionamos o cursor do mouse na tela com a funcionalidade de Swipe, o canto superior esquerdo nos diz a posição do cursor em X e Y. Isso significa a localização que você está na tela e esses valores podem variar de acordo com o tamanho da sua tela. De ação, cliquei bem na margem superior no meio da tela e daí já dá pra ver um ponto indicando a localização do clique. Depois, vou um pouco pra metade pra baixo da dela e realizo outro clique. Em seguida o Appium executa a ação e o menu superior aparece no Appium e no dispositivo emulado.

Tap by Coordinates - Clicar numa posição específica da tela

É indiscutível a importância do gesto de toque na tela em um dispositivo móvel :) Como se trata de algo dependente de posição (X, Y) na tela, às vezes isso pode ser um desafio de tratar em automação. Esta funcionalidade também está presente no Appium e pode ser encontrara através do botão que destaco a seguir:

Para exemplificar esta funcionalidade, irei realizar a ação de abrir um aplicativo que estiver em minha tela inicial, simplesmente tocando na exata posição que ele está na tela. Vamos ao gif demonstrativo:

Essa ação é composta por menos passos que o de coordenadas, visto que ele é realiza através de um único clique. Da mesma maneira, os valores de X e Y são atualizados à medida que eu vou andando com o cursor na tela. Dei um clique na localização de onde está o aplicativo Dialer (chamadas) e em seguida ele foi executado sem nenhuma ação extra.

📝 Sugestão de exercícios:

Tentar utilizar os funcionalidades swipe e tap em outras telas, menus e aplicações.

Agora que já sabemos mexer bastante com as principais funcionalidades do Appium, é hora realizarmos um fluxo bem simples de teste funcional em uma aplicação. Como estamos iniciando, vou realizar este tutorial através da aplicação Calculadora nativa do Android emulado. Como estamos falando de um teste funcional, irei estruturar o teste aqui:

Cenário de teste:
Realizar operações aritméticas

O caso de teste é bastante simples, vou realizar a soma dos números 2 e 3:

Não tem mistério, é só clicar nos elementos seguindo o fluxo definido e verificar que no final ele retorna o resultado de forma correta. Depois vamos fazer um tutorial para validar isso através de linguagem de programação :)

Para realizar este tutorial é preciso que você tenha:

• Tenha um dispositivo (real ou emulado) ativo
• Uma sessão iniciada no Appium
• Calculadora inicializada

Agora é hora de conhecermos uma outra funcionalidade muito boa que o Appium traz, que é o de converter em código de programação qualquer ação que você realizar em seu dispositivo, seja esta ação apenas para inicializar uma aplicação, ou até para ações mais elaboradas e interessantes como os que vimos mais acima: swipe e tap coordinates.

Considero essa função uma das que torna o Appium uma excelente aplicação para automação, especialmente se você está iniciando neste mundo ou ainda não tem muito contato com alguma linguagem de programação - de forma geral ou em alguma linguagem específica. O Appium consegue converter código para as seguintes linguagens: Python, JAVA, Ruby, RobotFramework e JS.

A funcionalidade de gravar as ações fica disponível com o seguinte ícone na aplicação:

É só clicar neste ícone e deixar também ativa a função "Select elements", que fica ao lado esquerdo do botão swipe. Vou deixar em destaque na próxima imagem. Ao clicar em cada um dos ícones do teste, teremos que clicar também no botão Tap, que irá realizar a ação de clique no elemento. Este botão também deixo em destaque na imagem que segue:

Agora é só realizar alguma ação e irei repetir o fluxo que fizemos no tutorial anterior, só que agora vamos gravar cada uma das ações que realizarmos:

Observe que à medida que nós vamos inserindo os dígitos na nossa calculadora, o código vai sendo gerado no campo Recorder que fica ao lado direito :) veja que o código já faz atribuições às variáveis que ele mesmo cria para receber elementos e assim facilitar acções como o .click. O código gerado será assim para Python:

el1 = driver.find_element_by_id("com.android.calculator2:id/digit_2")
el1.click()
el2 = driver.find_element_by_accessibility_id("plus")
el2.click()
el3 = driver.find_element_by_id("com.android.calculator2:id/digit_3")
el3.click()
el4 = driver.find_element_by_accessibility_id("equals")
el4.click()

É um código que trata apenas das interações que você faz e abstrai imports e demais recursos que você iria precisar para iniciar um projeto de automação. Porém, é possível também obter esse nível de código através do botão BoilerPlate Code como mostramos na imagem a seguir:

Através desta funcionalidade podemos obter todo o código gerado, inclusive com todos os imports e recursos necessários. O código fica assim para Python:

# This sample code uses the Appium python client
# pip install Appium-Python-Client
# Then you can paste this into a file and simply run with Python

from appium import webdriver

caps = {}
caps["platformName"] = "Android"
caps["deviceName"] = "AppiumP"
caps["avd"] = "AppiumP"
caps["appPackage"] = "com.android.calculator2"
caps["appActivity"] = "com.android.calculator2.Calculator"

driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", caps)

el1 = driver.find_element_by_id("com.android.calculator2:id/digit_2")
el1.click()
el2 = driver.find_element_by_accessibility_id("plus")
el2.click()
el3 = driver.find_element_by_id("com.android.calculator2:id/digit_3")
el3.click()
el4 = driver.find_element_by_accessibility_id("equals")
el4.click()

driver.quit()

Desta forma fica muito mais tranquilo de gerar um código inicial através do Appium e depois aproveitar muita coisa que foi gerada adicionando ou alterando as partes que quisermos.

Nos tutoriais seguintes iremos focar mais no código, então vamos explicar melhor algumas partes particulares do Appium em Python.

📝 Sugestão de exercícios: Agora que você já conhece também a funcionalidade de gravar suas ações e transformá-las em código, você pode realizar outros fluxos na calculadora ou até utilizar qualquer outra aplicação para gerar ações com gestos, por exemplo. Depois é só exportar o código e fazer alterações de acordo da maneira que você desejar.

A partir daqui, considero que o nível de dificuldade de uso e interação com o Appium cresce um pouco e passamos a trabalhar com tutoriais um pouco mais avançados.

Para realizar este tutorial é preciso que você tenha:

• Tenha um dispositivo (real ou emulado) ativo
• Uma sessão iniciada no Appium
• Calculadora inicializada

No "Tutorial 5: Realizando um fluxo simples de teste funcional" vimos um fluxo bem simples da operação de soma com dois números inteiros. Agora que sabemos como converter ações em código, vamos começar a elaborar um pouco mais estas ações e dar continuidade ao uso da Calculadora aplicando as demais operações aritméticas: subtração, divisão e multiplicação.

Para isso, vou mais uma vez utilizar a funcionalidade Record do Appium, visto que quero gerar o código destas ações através de Python. Segue gif para representar a sequência que realizei:

Note que, como estou usando a função Record, o código em Python foi sendo gerado dinamicamente e ao final ficamos com o seguinte código:

# This sample code uses the Appium python client
# pip install Appium-Python-Client
# Then you can paste this into a file and simply run with Python

from appium import webdriver

caps = {}
caps["platformName"] = "Android"
caps["deviceName"] = "AppiumP"
caps["appPackage"] = "com.android.calculator2"
caps["appActivity"] = "com.android.calculator2.Calculator"

driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", caps)

el1 = driver.find_element_by_id("com.android.calculator2:id/digit_1")
el1.click()
el2 = driver.find_element_by_accessibility_id("plus")
el2.click()
el3 = driver.find_element_by_id("com.android.calculator2:id/digit_3")
el3.click()
el4 = driver.find_element_by_accessibility_id("equals")
el4.click()
el5 = driver.find_element_by_accessibility_id("multiply")
el5.click()
el6 = driver.find_element_by_id("com.android.calculator2:id/digit_2")
el6.click()
el7 = driver.find_element_by_accessibility_id("equals")
el7.click()
el8 = driver.find_element_by_accessibility_id("minus")
el8.click()
el9 = driver.find_element_by_id("com.android.calculator2:id/digit_1")
el9.click()
el10 = driver.find_element_by_accessibility_id("equals")
el10.click()
el11 = driver.find_element_by_accessibility_id("divide")
el11.click()
el12 = driver.find_element_by_id("com.android.calculator2:id/digit_2")
el12.click()
el13 = driver.find_element_by_accessibility_id("equals")
el13.click()

driver.quit()

Agora temos uma boa parte de código que nos dá uma ideia de como nosso projeto para automação da Calculadora deve seguir. Já temos alguns botões mapeados e também todos os operadores aritméticos.

📝 Sugestão de exercício:

Você pode continuar mapeando os demais elementos restantes da calculadora até ter o código de todos os elementos existentes na sua aplicação.

Para realizar este tutorial é preciso que você tenha:

• Tenha um dispositivo (real ou emulado) ativo
• Uma sessão iniciada no Appium
• Calculadora inicializada

Brincamos bastante com o Appium ao longo dos tutoriais e conhecemos as principais funcionalidades gráficas que conseguimos acessar com muita facilidade, basicamente clicando nos elementos e coletando os códigos gerados.

Agora, podemos ir direto pra IDE de sua escolha (eu estou utilizando o PyCharm durante este documento) para replicarmos tudo que já fizemos, só que agora sem interagir diretamente com o Appium. Vamos utilizá-lo agora apenas para mapear elementos que ainda não mapeamos :)

Como estou utilizando o PyCharm, então criei um novo projeto, então um novo arquivo Python e instalei os seguintes pacotes no terminal do projeto:

1. Selenium:

pip install selenium

2. Appium:

npm install -g appium

O princípio se dá importando a biblioteca necessária para que a gente possa utilizar os recursos do Appium em qualquer linguagem de programação. Lembram que já citamos acima que o Appium e o Selenium tem muita coisa em comum? Aqui a gente vê de forma mais explícita que tanto o Appium quanto o Selenium utilizam recursos da biblioteca webdriver, e ele que iremos importar pra dar início ao nosso projeto:

from appium import webdriver

Como já vimos por aqui na seção Iniciando com o Appium, o Desired Capabilities é uma parte super importante no Appium pois é através dele que faremos a conexão HTTP entre o Appium e o nosso dispositivo, além de indicarmos se queremos apenas iniciar o dispositivo ou se queremos iniciar numa aplicação em especial, através do uso das chaves: appPackage e appActivity. Nos exemplos anteriores já tivemos uma ideia de como isso acontece, que é através de um dicionário contendo as chaves e valores que precisamos:

caps = {}
caps["platformName"] = "Android"
caps["deviceName"] = "AppiumP"
caps["avd"] = "AppiumP"
caps["appPackage"] = "com.android.calculator2"
caps["appActivity"] = "com.android.calculator2.Calculator"

Foi criado um dicionário chamado caps indicando a plataforma, o nome do dispositivo e as informações da aplicação Calculadora. Lembrando que isso foi gerado pelo Appium, apenas copiei e colei, ainda não fizemos ajustes.

Outro ponto importante é como a conexão é estabelecida. O Appium nos retorna essa solução:

driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", caps)

É aí que começamos a utilizar os recursos da biblioteca WebDriver. Criamos uma variável chamada driver e dentro dela armazenamos a instância de uma nova conexão, que se dá através da chamada do recurso Remote. Passamos 2 parâmetros para essa chamada:

1. Localização do nosso serviço: "http://127.0.0.1:4723/wd/hub", que é composto pelos valores que já conhecemos via interface do Appium. Aí está uma junção dos campos que são preenchidos de forma padrão: Remote Host + Remote Port + Remote Path.
2. Desired capabilities: Como já explicamos anteriormente, nós criamos um dicionário para armazenarmos as chaves e valores do que queremos que o Appium trate. Aqui é só passar o nome deste dicionário.

A partir do código gerado do Appium, fiz alguns ajustes e o começo do meu código ficou assim:

from appium import webdriver

desired_cap = {
    "platformName": "Android",
    "deviceName": "AppiumP",
    "avd": "AppiumP",
    "appPackage": "com.android.calculator2",
    "appActivity": "com.android.calculator2.Calculator"
}

driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_cap)

Com isso apenas já é possível estabelecer uma sessão com o Appium utilizando o Python. Uma imagem do meu projeto inicial:

Veja que assim que pedi para executar este código, em paralelo o listenning do Appium já abriu e começou a consumir o que eu tinha informado via código.

Em seguida, veja que o código do PyCharm finalizou a execução e, no Appium, me foi retornado o status code 200, que indica que obtive sucesso na minha requisição - lembre-se que no final das contas o Appium trabalha com requisições HTTP e isso fica bem explícito quando analisamos via estes logs:

Como resultado destas operações, é só observarmos o nosso dispositivo (real ou emulado) que, na tela, estará presente a aplicação que estamos testando - neste caso segue sendo a Calculadora nativa do Android:

Por fim, veja que com poucas linhas de código em Python nós conseguimos iniciar uma sessão do Appium em um dispositivo indo diretamente para a tela da aplicação Calculadora.

📝 Sugestão de exercício:

Tente explorar alguns recursos existentes na biblioteca webdriver. Caso você não a conheça, recomendo que faça uma pesquisa sobre ela e tente explorar mais funcionalidades que ela pode oferecer ao seu projeto.

Para realizar este tutorial é preciso que você tenha:

• Tenha um dispositivo (real ou emulado) ativo
• Projeto do Tutorial 8

No tutorial anterior vimos como funciona a parte inicial do código em Python para o Appium: imports, desired capabilities, webdriver. Este início é basicamente igual (em termos de estrutura) para todos os projetos que você irá fazer utilizando Appium. Agora, vamos ver o mapeamento dos nossos elementos como números e operadores.

Com os códigos gerados pelo Appium, obtivemos o seguinte código, bem geral:

el1 = driver.find_element_by_id("com.android.calculator2:id/digit_1")
el1.click()
el2 = driver.find_element_by_accessibility_id("plus")
el2.click()
el3 = driver.find_element_by_id("com.android.calculator2:id/digit_3")
el3.click()
el4 = driver.find_element_by_accessibility_id("equals")
el4.click()
el5 = driver.find_element_by_accessibility_id("multiply")
el5.click()
el6 = driver.find_element_by_id("com.android.calculator2:id/digit_2")
el6.click()
el7 = driver.find_element_by_accessibility_id("equals")
el7.click()
el8 = driver.find_element_by_accessibility_id("minus")
el8.click()
el9 = driver.find_element_by_id("com.android.calculator2:id/digit_1")
el9.click()
el10 = driver.find_element_by_accessibility_id("equals")
el10.click()
el11 = driver.find_element_by_accessibility_id("divide")
el11.click()
el12 = driver.find_element_by_id("com.android.calculator2:id/digit_2")
el12.click()
el13 = driver.find_element_by_accessibility_id("equals")
el13.click()

Agora é hora de organizarmos esse código e aproveitarmos para identificarmos todos os elementos restantes da nossa aplicação. Uma dica muito importante: como a aplicação da Calculadora é pequena, eu tomei a decisão de mapear todos os elementos. Porém, num projeto de automação, onde normalmente você tem aplicações e páginas complexas com muitos fluxos e elementos, faça o mapeamento apenas daquilo que você irá precisar. Caso contrário, seu trabalho será 80% focado em mapear elementos, e isso não é eficiente =)

Depois de fazer alguns ajustes, deixei meu código organizado da seguinte maneira:

from appium import webdriver

desired_cap = {
    "platformName": "Android",
    "deviceName": "emulator-5554",
    "avd": "AppiumP",
    "appPackage": "com.android.calculator2",
    "appActivity": "com.android.calculator2.Calculator"
}

driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_cap)

# numbers
num1 = driver.find_element_by_id("com.android.calculator2:id/digit_1")
num2 = driver.find_element_by_id("com.android.calculator2:id/digit_2")
num3 = driver.find_element_by_id("com.android.calculator2:id/digit_3")
num4 = driver.find_element_by_id("com.android.calculator2:id/digit_4")
num5 = driver.find_element_by_id("com.android.calculator2:id/digit_5")
num6 = driver.find_element_by_id("com.android.calculator2:id/digit_6")
num7 = driver.find_element_by_id("com.android.calculator2:id/digit_7")
num8 = driver.find_element_by_id("com.android.calculator2:id/digit_8")
num9 = driver.find_element_by_id("com.android.calculator2:id/digit_9")
num0 = driver.find_element_by_id("com.android.calculator2:id/digit_0")

# operators
op_mais = driver.find_element_by_accessibility_id("plus")
op_multi = driver.find_element_by_accessibility_id("multiply")
op_menos = driver.find_element_by_accessibility_id("minus")
op_div = driver.find_element_by_accessibility_id("divide")

# common
op_igual = driver.find_element_by_accessibility_id("equals")

Já temos os elementos mapeados, mas como podemos realizar as operações em si? A opção mais simples e básica, é reproduzir o comportamento do teste de maneira sequencial, como deixo abaixo o exemplo de uma adição:

num1.click()
op_mais.click()
num2.click()
op_igual.click()

print('O resultado da soma foi: ', result.text)

Agora vimos que é possível adicionar o início de uma validação, que começamos com o print na tela do que a calculadora nos retornou no resultado da tela. Sendo assim, agora podemos comparar se o valor resultado em tela é condizente com o valor da realização da soma feita em Python. De forma simples, fiz dessa maneira:

somapython = int(num1.text) + int(num2.text)
somaappium = int(result.text)

print('O resultado da soma via Appium foi: ', somaappium)
print('O resultado da soma via Python foi: ', somapython)

assert somapython == int(result.text), 'Resultados divergentes entre o python e o Appium'

Minha resolução foi criar uma variável para armazenar a soma dos operadores em Python (somapython) e outra variável para armazenar o resultado encontrado no campo de resultado da calculadora através do Appium (somaappium).

Em seguida imprimo na tela o resultado dos dois campos e em seguida utilizo um assert para comparar os resultados. Se os resultados são iguais, a validação está OK e nada é retornado na tela. Caso contrário, isto é, se os valores forem divergentes, uma mensagem de erro é retornada no terminal: 'Resultados divergentes entre o python e o Appium'.

O uso de assertions em projetos de automação para qualidade de software é extremamente importante. Sem o uso de assertions não é possível comparar o resultado obtido com o resultado esperado, ou seja, não temos como validar se o comportamento observado está de acordo com o esperado ou se é um bug.

📝 Sugestão de exercício:

Agora que estamos trabalhando de forma mais direta com o código, sugiro que você complemente o código que já alcançamos até aqui, adicionando as outras operações como subtração, divisão e multiplicação. Não se esqueça de aplicar assertions e, aproveitando, também sugiro que você faça algumas pesquisas sobre isso e a importância do uso deste recurso em automação de teste de software.

Para realizar este tutorial é preciso que você tenha:

• Projeto do Tutorial 9

Nota importante:
Todo o código gerado neste tutorial está commitado neste repositório :)

Até agora chegamos a um código legal, mas sem nenhum tipo de padrão. Esse tipo de código chamamos de espaguette já que ele é bem escorrido :)

Agora vamos organizar um pouco nosso código, separando algumas partes do que programamos e utilizando Classes, construtores e alguns conceitos de Python e Programação Orientada à Objetos.

A primeira coisa que irei fazer, é começar a utilizar alguns conceitos de padrão de projetos (não irei entrar em detalhes de padrões de projeto aqui) para tornar nosso código mais legível, mais bem estruturado para receber automação e de fácil manutenabilidade. Pra isso, irei separar o código responsável pela conexão do Appium, isolando-o num arquivo único, o qual chamarei de webdriver.py, que ficará numa pasta de mesmo nome:

from appium import webdriver


class Driver:
    def __init__(self):
        desired_cap = {
            'platformName': 'Android',
            'deviceName': 'AppiumP',
            'avd': 'AppiumP',
            'appPackage': 'com.android.calculator2',
            'appActivity': 'com.android.calculator2.Calculator'
        }
        self.instance = webdriver.Remote('http://localhost:4723/wd/hub', desired_cap)

Neste código eu apenas criei uma classe com o nome de Driver e dentro desta classe criei o construtor init que é onde adiciono as características dos objetos que vamos instanciar a partir desta classe. Em seguida, modifico a forma que inicio o serviço alterando de 'drive' para 'instance', assim fica mais intuitivo de mostrar que sempre que estivermos iniciando o serviço, na verdade estaremos instanciando um objeto da classe Driver.

Agora, vou criar uma pasta chamada 'pageobjects' e nesta pasta vou criar um arquivo Calc.py, onde irei registrar todos os elementos e as ações que são possíveis de serem realizadas na tela principal da aplicação Calculadora. Caso a aplicação Calculadora tivesse mais telas (ou activities), iríamos criar um arquivo para cada uma das telas para mantermos o código mais bem organizado.

Irei começar o arquivo Calc.py fazendo uso de mais recursos da biblioteca do Selenium, através dos seguintes imports:

from webdriver.webdriver import Driver
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.support.wait import WebDriverWait
from appium.webdriver.common.mobileby import MobileBy

Expected conditions, o qual atribuo o apelido de EC - já que é uma expressão longa, é utilizado para indicar que a condição esperada irá acontecer diante da condição que eu atrelar a este recurso.
WebDriverWait é uma excelente solução para eliminarmos o famoso uso do time.sleep(10) do nosso código. É um recurso que basicamente fica no aguardo da presença de algum elemento e que pode receber um valor de timeout indicado por você. Gosto de usar o valor 10.
MobileBy é o recurso responsável por indicar que estamos em um contexto de dispositivo móvel, daí então podemos acessar tipos de IDs relacionados a este contexto.

Depois dos imports, é hora de criarmos uma classe, a qual dei o nome de Calculadora. Para esta classe também criei um construtor para identificarmos os elementos que caracterizam a nossa classe e, consequentemente, os objetos que iremos instanciar a partir dela. Além dos elementos, também iremos criar os métodos relacionados aos comportamentos da nossa classe que, para a nossa calculadora, iremos definir que são as ações de somar, subtrair, multiplicar e dividir.

Antes de iniciar a reestruturação da identificação dos nossos elementos, vale dizer que todos os nossos dígitos numéricos (do 0 ao 9) possuem a mesma estrutura, mudando apenas o último dígito do valor do elemento. Com isso, podemos tentar usar uma estratégia diferente para otimizar isso. Então, decidi criar um método para tratar disso. Portanto, irei mapear agora apenas os elementos de operações e os mais gerais como o de resultado. Nosso mapeamento fica assim:

class Calculadora:
    def __init__(self, driver):
        self.driver = driver
        self.result = WebDriverWait(self.driver.instance, 10).until(EC.presence_of_element_located(
            MobileBy.ID, 'com.android.calculator2:id/result'
        ))
        self.soma = WebDriverWait(self.driver.instance, 10).until(EC.presence_of_element_located(
            MobileBy.ACCESSIBILITY_ID, 'plus'
        ))
        self.divisao = WebDriverWait(self.driver.instance, 10).until(EC.presence_of_element_located(
            MobileBy.ACCESSIBILITY_ID, 'divide'
        ))
        self.multiplicacao = WebDriverWait(self.driver.instance, 10).until(EC.presence_of_element_located(
            MobileBy.ACCESSIBILITY_ID, 'multiply'
        ))
        self.subtracao = WebDriverWait(self.driver.instance, 10).until(EC.presence_of_element_located(
            MobileBy.ACCESSIBILITY_ID, 'minus'
        ))

Depois de mapeados os elementos, é hora de iniciarmos a elaboração dos métodos da nossa Calculadora. Como falei mais acima, também irei utilizar um método para tratar a identificação dos dígitos, visto que a estrutura de todos são idênticas, mudando apenas o último dígito. Meu código ficou assim:

    def clicknumber(self, numero):
        _num = str(numero)
        self.driver.instance.find_element(MobileBy.ID, 'com.android.calculator2:id/digit_' + _num).click()
        assert _num in self.result.text, 'Resultado no result não é o esperado com o valor inserido'

Esta solução é uma sugestão para termos um código mais enxuto. Você pode fazer algo parecido para aplicarmos o operador.

Agora, também irei utilizar a biblioteca unitTest para controlarmos o fluxo de testes da nossa aplicação. Através desta biblioteca iremos utilizar os métodos setUp() e tearDown(). São métodos que fazem muito sentido em projetos de testes, pois o setUp tem por objetivo preparar o que é necessário para iniciarmos os testes, enquanto que o tearDown finaliza a execução encerrando os serviços que foram iniciados durante a execução. Para organizar isso em um padrão de projetos, irei criar uma pasta chamada "tests" e, dentro desta pasta irei criar um arquivo Python de nome CalculadoraTestes.py, onde farei os imports dos arquivos que fazem parte do meu projeto e, na construção da classe irei definir que esta classe será do tipo casos de teste (unittest.TestCase). Este arquivo será muito simples e nele faremos o setUp, o tearDown e (atenção para esta parte) criaremos métodos que irão realizar nossos testes. Todo método que começar com "test" será executado já que inserimos a biblioteca unitTest. A ordem de execução será de acordo com a distribuição dos métodos neste arquivo.

Bem, em resumo, nossa estrutura terá as seguintes pastas:

• Webdriver: Aqui iremos isolar a conexão do nosso serviço.

• PageObjects: Aqui será o mapeamento da nossa aplicação. Para cada página, uma classe dedicada - não necessariamente em arquivos separados. Todos os elementos e todas as funcionalidades da página serão identificados e trabalhados aqui.

• Tests: Aqui iremos criar nossos métodos de inicialização, finalização e elaboração dos nossos testes. SetUp é o método responsável por inicializar a execução. Setup é o responsável por finalizar a execução. Todo método iniciado com "test" será executado como teste. Essas funcionalidades são abstraídas graças ao uso da biblioteca unitTest.

Desta maneira, finalizamos os tutoriais do início do uso do Appium testando nossa aplicação Calculadora nativa do Android.

📝 Exercícios sugeridos:

• Como não entramos em detalhes do que são padrões de projeto e quais os padrões especificamente devemos usar, eu deixo como sugestão a pesquisa sobre padrões de projeto em Python, especialmente para automação de teste de software.
• Explorar os recursos existentes na biblioteca Selenium.
• Explorar os recursos e o uso da biblioteca unitTest.
• Com base no método que deixei para a soma, você pode criar ou demais métodos para os outros operadores como multiplicação, divisão e multiplicação.
• Gostaria de de ampliar seu projeto e realizar a automação do modelo Calculadora Científica? Esse é o momento! =)
• Gostaria de aplicar estes conceitos a alguma aplicação que vc baixou na PlayStore? Esta também é uma excelente oportunidade! Não se esqueça de compartilhar seu projeto com a comunidade <3

Uma das vantagens de se utilizar um framework para resolver um problema, é o uso dos recursos que esse framework é capaz de prover ao seu ambiente de automação. O Appium traz muitos recursos poderosos que dão contexto mobile pros seus testes, e que podem ser utilizados de acordo com sua estratégia de testes.

Considerar cenários e interações de rede é um dos itens obrigatórios quando estamos falando de testes para mobile. Aqui estão alguns dos comandos que podemos utilizar neste sentido:

Esse recurso é chamado de GSM Call. Sua estrutura espera 2 parâmetro: "phone_number" e "action", ambos são strings em Python, onde "phone_number" é o número a ter interações e "action" é a ação a ser feita, e pode ser: call (realizar a chamada), accept (aceitar a chamada), cancel (recusar a chamda) e hold (colocar a chamada em aguardo).

Receber uma chamada: Para aparecer a notificação de chegada de ligação. Por si só este comando não irá aceitar a chamada, apenas irá notificar a chegada de uma nova ligação.

driver.make_gsm_call("123123", "call")

Com o uso do comando acima, a chamada irá aparecer na sua tela. Para aceitá-la, é preciso utilizar o seguinte comando:

driver.make_gsm_call("123123", "accept")

Porém, se você quiser recursar a chamada, basta utilizar o seguinte comando:

driver.make_gsm_call("123123", "cancel")

Este comando também é utilizado para finalizar uma chamada em curso.

Uma vez que a chamada é estabelecida, você pode colocá-la em aguardo através do seguinte comando:

driver.make_gsm_call("123123", "hold")

Referência oficial do Appium

driver.send_sms('1010101', 'hello wold')

• Mudar orientação da tela:

A depender da disposição de tela do seu dispositivo, isso pode habilitar ou desabilitar nossas funcionalidades no sistema ou no aplicativo em teste. Um exemplo disso, é a Calculadora do Android que na posição "portrait" tem a Calculadora padrão, porém, quando na posição "landscape", a Calculadora se transforma em Calculadora Científica.

Em alguns momentos do teste pode ser necessário você verificar a orientação corrente que está seu dispositivo, e com base nisso realizar alguma ação. Para identificar a orientação atual do dispositivo, utilize o seguinte recurso:

driver.orientation()

Este é o modo na vertical, o que usamos como padrão.

driver.orientation = "PORTRAIT"

Este é o modo de visão na horizontal.

driver.orientation = "LANDSCAPE"

• 🔋 Alterar o % de bateria do dispositivo:

Este é um recurso super poderoso pois a depender do % de bateria do seu dispositivo podemos ver a presença de alguma notificação do sistema indicando nível crítico de bateria, ou até mesmo sugerindo que você entre no modo econômico de bateria. Tudo isso pode influenciar no estado do seu dispositivo e, consequentemente, influenciar na condução dos seus testes ou até mesmo sugerir uma suíte de testes voltada para esse tipo de validação.

O recurso para isto é o set_power_capacity e apenas 1 parâmetro é passado, que é o valor de 0 a 100 para o valor do nível de bateria.

driver.set_power_capacity(10)

• 🔌 Simular estar ligado no carregador:

O recurso para isto é o set_power_ac, e aguarda apenas 1 parâmetro que é a string "on" para indicar que está em carga ou "off" para indicar que não está em carga.

driver.set_power_ac("on")

• Verificar se um aplicativo está instalado no sistema:

Testes de instalação também é algo muito presente no universo mobile. É muito frequente que a instalação/desinstalação de aplicativos seja uma realidade na rotina de quem utiliza um dispositivo móvel. E, se sua aplicação será lançada na Play Store, testar se o aplicativo foi instalado com sucesso será um dos primeiros testes que você deve considerar.

O recurso para isto é o "is_app_installed" que retorna um booleano (True/False) para o valor do pacote que você deverá passar como parâmetro na chamada da função.

driver.is_app_installed('com.example.appiumcurso')

Saber o contexto da sua aplicação é algo muito importante. Se for uma aplicação nativa, pode ser que você tenha que utilizar uma abordagem diferente dos casos de uma aplicação web, por exemplo. Apenas olhando um aplicativo muitas vezes não é possível dizer qual o tipo daquele aplicativo, mas o Appium fornece um recurso para nos ajudar com isso.

driver.contexts

Este comando retorna uma string indicando se o aplicativo que estiver aberto na tela do dispositivo naquele momento é um aplicativo nativo, híbrido ou web.

driver.AC_OFF

driver.AC_ON

driver.activate_app()

driver.activate_ime_engine()

driver.active_ime_engine

driver.add_cookie()

driver.add_credential()

driver.add_virtual_authenticator()

driver.all_sessions

driver.app_strings()

driver.application_cache

driver.available_ime_engines

driver.back()

driver.background_app()

driver.battery_info

driver.bidi_connection()

driver.capabilities

driver.caps

driver.close()

driver.close_app()

É necessário indicar o nome do aplicativo, como nesse exemplo:

driver.close_app('com.example.cursoappium')

driver.command_executor

```python
driver.context

driver.contexts

driver.create_web_element()

driver.current_activity

driver.current_context

Pode ser uma aplicação "nativa" ou "web".

driver.current_package

driver.current_url

driver.current_window_handle

driver.deactivate_ime_engine()

driver.delete_all_cookies()

driver.delete_cookie()

driver.delete_extensions()

driver.desired_capabilities

driver.device_time

driver.drag_and_drop()

driver.end_test_coverage()

driver.error_handler

driver.events

driver.execute()

driver.execute_async_script()

driver.execute_driver()

driver.execute_script()

driver.file_detector

driver.file_detector_context()

driver.find_element()

driver.find_elements()

driver.find_image_occurrence()

driver.finger_print()

driver.flick()

driver.forward()

driver.fullscreen_window()

driver.get()

driver.get_clipboard()

driver.get_clipboard_text()

driver.get_cookie()

driver.get_cookies()

driver.get_credentials()

driver.get_device_time()

driver.get_display_density()

driver.get_events()

driver.get_images_similarity()

driver.get_log()

driver.get_performance_data()

driver.get_performance_data_types()

driver.get_pinned_scripts()

driver.get_screenshot_as_base64()

driver.get_screenshot_as_file()

driver.get_screenshot_as_png()

driver.get_settings()

driver.get_system_bars()

driver.get_window_position()

driver.get_window_rect()

driver.get_window_size()

driver.hide_keyboard()

driver.implicitly_wait()

driver.install_app()

driver.is_app_installed()

É necessário informar o nome do aplicativo nesse formato:

driver.is_app_installed('com.example.cursoappium')

driver.is_ime_active()

driver.is_keyboard_shown()

driver.is_locked()

driver.keyevent()

A lista completa de todos os keyevents e seus respectivos valores pode ser encontrada na página oficial do Android aqui.

driver.launch_app()

driver.location

driver.lock()```

```python
driver.log_event()

driver.log_types

driver.long_press_keycode()

driver.make_gsm_call()

driver.match_images_features()

driver.maximize_window()

driver.minimize_window()

driver.mobile

driver.name

driver.network_connection

driver.open_notifications()

driver.orientation

driver.page_source

driver.pin_script()

driver.pinned_scripts

driver.press_button()

driver.press_keycode()

driver.print_page()

driver.pull_file()

driver.pull_folder()

driver.push_file()

driver.query_app_state()

driver.quit()

driver.refresh()

driver.remove_all_credentials()

driver.remove_app()

driver.remove_credential()

driver.remove_virtual_authenticator()

driver.reset()

driver.save_screenshot()

driver.scroll()

driver.send_sms()

driver.session

driver.session_id

driver.set_clipboard()

driver.set_clipboard_text()

driver.set_gsm_signal()

driver.set_gsm_voice()

driver.set_location()

driver.set_network_connection()

driver.set_network_speed()

driver.set_page_load_timeout()

driver.set_power_ac()

driver.set_power_capacity()

driver.set_script_timeout()

driver.set_user_verified()

driver.set_value()

driver.set_window_position()

driver.set_window_rect()

driver.set_window_size()

driver.shake()

driver.start_activity()

driver.start_client()

driver.start_recording_screen()

driver.start_session()

driver.stop_client()

driver.stop_recording_screen()

driver.swipe()

driver.switch_to

driver.tap()

driver.terminate_app()

driver.timeouts

driver.title

driver.toggle_location_services()

driver.toggle_touch_id_enrollment()

driver.toggle_wifi()

driver.touch_id()

driver.unlock()

driver.unpin()

driver.update_settings()

driver.virtual_authenticator_id

driver.wait_activity()

driver.window_handles