ruby-cucumber-appium-test

Projeto utilizando Ruby com cucumber(Gherkin) e appium para dispositivos mobile.

Pré-requisitos

Certifique-se de ter o Ruby, o bundler instalados em seu sistema. Além disso, configure o ambiente de desenvolvimento para executar testes em um dispositivo móvel ou emulador.

• Ruby (2.4.0 ou superior)
• Bundler (1.15.0 ou superior)
• Android Studio
  • Aqui utilizaremos o Android Studio para criar o device
• Java Development Kit (JDK) 8 ou superior
• Appium Desktop (Elements inspector)
  • Start Server 0.0.0.0:4723
  • Selecionar Start Inspector Session
  • Criar capabilities (Exemplo)

    {
    "appium:deviceName": "Pixel 6 Pro API 33",
    "appium:udid": "emulator-5554",
    "platformName": "Android",
    "appium:platformVersion": "13.0",
    "appium:app": "/home/tqi_dmachado/workspace/ruby-cucumber-appium-test/features/support/PreciseUnitConversion.apk"
    }
    

Como criar um novo projeto Gradle(Isso criará uma estrutura de diretórios básica para o seu projeto):

gradle init --type=ruby-library

Instale as dependências do projeto

bundle install

Estrutura de diretórios

projeto_login_mobile
├── Gemfile 
├── Gemfile.lock
├── features 
│   ├── login.feature  
│   ├── step_definitions 
│   │   └── login_steps.rb
│   └── support
│       ├── app.rb
│       └── env.rb 
│       └── app.apk 
└── cucumber.yml

• O diretório features contém os arquivos de feature em linguagem Gherkin para descrever os cenários de teste.
• O diretório step_definitions contém os arquivos de implementação dos passos dos cenários de teste.
• O arquivo Gemfile especifica as dependências do projeto.
• O arquivo env.rb configura o ambiente de teste, incluindo as configurações do Appium.
• O arquivo env.rb configura o ambiente de teste, incluindo as configurações do Appium.
• O arquivo hooks.rb configurao que serão executados antes e depois de cada cenário de teste, permitindo que você adicione código de inicialização e finalização personalizado, bem como capturas de tela automatizadas em caso de falha nos testes.
• O arquivo cucumber.yml configurao de tags de testes para utiliza-las como parêmetro na execução.

Executando os testes

1- Certifique-se de que o dispositivo móvel ou emulador esteja conectado e configurado corretamente.

2- No terminal, na raiz do projeto, execute o seguinte comando para iniciar a execução dos testes:

Comando para validar/gerar os steps

cucumber

Comando para verificar quais steps estão faltando

cucumber --dry-run

Validar teste com parâmetros

cucumber -t @default @wip

Comando quando possui tags customaizadas no arquivo cucumber.yml:

cucumber -p custom --dry-run

Verificar o gem instalado na máquina (appium_lib e o cucumber)

gem list

Listar devices local

adb devices

Obter/imprimir o objeto inteiro da tela do app

puts (get_source)

Utilizar biblioteca pry para fins de depuração no Cucumber,

require "pry"

sudo apt-get install pry

bundle install

binding.pry # Adicione esse ponto de interrupção

Comandos extras para iniciar automação com seu proprio aplicativo

adb devices

adb shell pm list packages # listar todos os pacotes disponíveis

adb shell pm path com.android.chrome # lista o caminho de uma packager especifica

adb pull /data/app/Chrome.apk # gera a apk no diretorio que vc estiver

Apos abrir o apk no emulador

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

Com esse comenod vc consegue obter appPackage e appActivity

Comando Jenkins Local

Após instalação:
1- http://localhost:8080/`
2- sudo cat /var/lib/jenkins/secrets/initialAdminPassword
3- Colar chave avançar
4- Selecionar opção Instalar plugins sugeridos
5- Realizar login local (criar user e pass)
6- Usar instancia padrão sugerida
7- Comandos:
  sudo service jenkins start
  sudo service jenkins stop
  sudo service jenkins restart
  sudo service jenkins status
  sudo find / -name jenkins.war # Localizar dir da instalação
  sudo cat /var/lib/jenkins/secrets/initialAdminPassword # reiniciar senha Admin
  Adicinar na pipe Shell Script
    cd /home/tqi_dmachado/workspace/ruby-cucumber-appium-test
    cucumber -p main
  Rodar pipeline

Trabalhando com elementos de Array no terminal

irb
3.0.0 :001 > ["Diego", "Theo"]
 => ["Diego", "Theo"] 
3.0.0 :002 > ar = ["Diego", "Theo"]
 => ["Diego", "Theo"] 
3.0.0 :003 > ar
 => ["Diego", "Theo"] 
3.0.0 :004 > ar[1]
 => "Theo" 
3.0.0 :005 > ar = ["Diego", "Theo", "Daniela"]
 => ["Diego", "Theo", "Daniela"] 
3.0.0 :006 > ar[2]
 => "Daniela" 
3.0.0 :007 > 

Report

Para gerar report nos testes passar os seguintes parâmetros no teste

--format html --out report.html --format pretty

report sera gerado na pasta raiz do projeto.

Links de apoio

• Appium Docs

• Instalações Linux:

  • Cucumber Ruby
  • Setup ambiente Ubuntu 20.04
  • Instação cucumber Ubuntu 20.04
    • Outros comando instação cucumber linux
  • Instação ruby Ubuntu
    • Outros comandos instação ruby linux
  • Soluções de problema de gem

• Dependencias:

  • Dep: pry
  • Dep: eventmachine

• Jenkins:

  • Jenkins
  • Install Linux

• Appium Desktop

• Android Studio