Skip to content

4-Appium-inspector.md

Latest commit

 

History

History
147 lines (107 loc) · 5.42 KB

4-Appium-inspector.md

File metadata and controls

147 lines (107 loc) · 5.42 KB
Raw

Appium Inspector

O Appium Inspector é uma ferramenta GUI que permite inspecionar a hierarquia de elementos de um app em execução, testar seletores e gravar ações. É essencial no dia a dia de quem escreve testes com Appium.

Instalação

Baixe o instalador para o seu sistema operacional:

github.com/appium/appium-inspector/releases

Versões disponíveis:

  • .dmg — macOS
  • .exe — Windows
  • .AppImage — Linux

Iniciando uma Sessão

1. Pré-requisitos

  • Servidor Appium rodando: appium
  • Emulador ou dispositivo conectado

2. Configurar Capabilities

Abra o Appium Inspector e preencha as capabilities na aba Desired Capabilities:

Para Android:

{
  "platformName": "Android",
  "appium:deviceName": "emulator-5554",
  "appium:automationName": "UiAutomator2",
  "appium:app": "/caminho/para/meuapp.apk"
}

Para iOS:

{
  "platformName": "iOS",
  "appium:deviceName": "iPhone 14",
  "appium:automationName": "XCUITest",
  "appium:app": "/caminho/para/meuapp.app",
  "appium:udid": "UDID_DO_SIMULADOR"
}

3. Iniciar a Sessão

Clique em Start Session. O Inspector vai:

  1. Conectar ao servidor Appium
  2. Abrir o app no dispositivo
  3. Capturar a hierarquia de elementos
  4. Exibir a tela do dispositivo no painel central

Interface do Inspector

┌─────────────────────────────────────────────────────────────┐
│  [Screenshot do App]  │  [Hierarquia de Elementos]          │
│                       │  ▼ android.widget.FrameLayout       │
│                       │    ▼ android.widget.LinearLayout    │
│                       │      ▶ android.widget.EditText      │
│                       │      ▶ android.widget.Button        │
│                       │                                     │
│───────────────────────│─────────────────────────────────────│
│  [Atributos]                                                │
│  resource-id: com.app:id/campo_email                        │
│  text: ""                                                   │
│  content-desc: "Campo de e-mail"                            │
│  bounds: [0,200][1080,350]                                  │
└─────────────────────────────────────────────────────────────┘

Usando o Inspector para Encontrar Seletores

Passo a passo

  1. Clique em um elemento na screenshot
  2. A hierarquia vai selecionar o elemento correspondente
  3. Os Atributos mostram resource-id, text, content-desc, class e outros
  4. Use esses valores nos seus seletores:
// Usando resource-id encontrado no Inspector
driver.findElement(By.id("com.meuapp:id/campo_email"));

// Usando accessibility-id (content-desc)
driver.findElement(AppiumBy.accessibilityId("Campo de e-mail"));

Testando Seletores

O Inspector tem uma caixa de busca onde você pode testar seletores antes de escrever o código:

  1. Clique em Search for element (ícone de lupa)
  2. Escolha a estratégia: id, xpath, accessibility id, etc.
  3. Digite o seletor e clique em Find
  4. O Inspector vai destacar o elemento encontrado na tela

Gravando Ações (Record)

O modo Record gera código automaticamente enquanto você interage com o app:

  1. Clique no botão Record (círculo vermelho)
  2. Clique nos elementos na screenshot
  3. O Inspector gera o código correspondente (Java, Python, JS, etc.)
  4. Escolha a linguagem no seletor de linguagem

Exemplo de código gerado (Java):

driver.findElement(By.id("com.app:id/campo_email")).click();
driver.findElement(By.id("com.app:id/campo_email")).sendKeys("teste@email.com");
driver.findElement(By.id("com.app:id/btn_entrar")).click();

Use o código gerado como ponto de partida — revise e refatore antes de usar em produção.

Atualizar a Hierarquia

Se o app mudar de tela, clique em Refresh para atualizar a hierarquia e a screenshot.

Salvando Configurações

Salve suas capabilities na aba Saved Capability Sets para não precisar redigitá-las a cada sessão.

Dicas de Uso

  • Use o Search para validar se um seletor funciona antes de escrever o teste
  • Prefira resource-id e accessibility-id — mais estáveis que XPath
  • Se um elemento não aparece na hierarquia, verifique se ele está dentro de uma WebView (app híbrido) — mude o contexto para WEBVIEW
  • Use o modo Record para acelerar a escrita de testes novos, mas sempre revise o código gerado

Boas Práticas

  • Mantenha o Appium Inspector sempre atualizado para compatibilidade com as versões mais recentes do Appium
  • Para apps híbridos, troque o contexto no Inspector para WEBVIEW antes de inspecionar elementos da parte web
  • Compartilhe as capabilities salvas com o time para garantir configurações consistentes

Parabéns! Você concluiu o Appium4Noobs! 🎉
Agora você tem o conhecimento para criar testes mobile profissionais com Appium.

Contribua com o projeto abrindo uma issue ou enviando um Pull Request.