Introdução: por que o testador precisa do próprio proxy entre o app e o servidor

Imagine: você está testando um aplicativo mobile, aperta um botão e na tela aparece um erro genérico "Algo deu errado". O desenvolvedor pergunta: "Qual requisição foi enviada? Qual resposta voltou? Qual o código de status?". Sem proxy, você abre as mãos. Com proxy — você abre a lista de requisições, copia o corpo da resposta do servidor e anexa ao bug em trinta segundos. Essa é a diferença entre o testador que "clica" e o testador que entende o que acontece por baixo do capô.

Este artigo é propositalmente diferente de tutoriais para usuários comuns, que explicam como inserir o endereço do proxy nas configurações de Wi-Fi do celular. Aqui abordamos o fluxo de trabalho do engenheiro de QA: proxy de interceptação no computador, direcionamento do tráfego do emulador Android para ele, conexão do dispositivo real por Wi-Fi e por USB via port forwarding com o comando adb reverse, além de interceptação e substituição de tráfego do ambiente de teste. A configuração de proxy no celular pelo usuário é apenas um pequeno tijolo nesse processo.

O que você terá no final

  • Um proxy de interceptação funcionando (mitmproxy ou Charles) que mostra cada requisição HTTP e HTTPS do seu app.
  • Um emulador Android cujo tráfego passa por esse proxy, incluindo o tráfego criptografado.
  • Um smartphone real conectado ao proxy de duas formas: por Wi-Fi e por cabo USB via adb reverse.
  • Entendimento de por que o app "não confia" no certificado e como isso se resolve na build de teste.
  • Habilidade de substituir respostas do ambiente de teste, emular rede lenta e erros do servidor sem depender do desenvolvedor de backend.

Para quem é este guia

Para testadores manuais e de automação de aplicativos mobile que querem ver o tráfego de rede em vez de adivinhar. Para juniores a quem, no novo trabalho, disseram "olha no Charles", mas não explicaram o que é nem como usar. Para desenvolvedores que configuram o ambiente de teste para a equipe.

O que você precisa saber antes

Entendimento básico do que é uma requisição HTTP, resposta, códigos de status 200 e 500. Saber abrir um terminal ou prompt de comando e executar um comando nele. Experiência instalando aplicativos no Android. Se você nunca iniciou um emulador — sem problema, vamos percorrer esse caminho juntos.

Quanto tempo vai levar

Com uma boa internet e o Android Studio já instalado — de uma hora e meia a duas horas para o guia inteiro. Se ainda não tem Android Studio, adicione 30-60 minutos para baixar as imagens de sistema. Depois da primeira vez, a configuração repetida em um novo projeto leva cerca de dez minutos.

Preparação inicial: ferramentas, acessos e requisitos de sistema

O que precisa ser instalado no computador

  1. Android Studio na versão atual de 2025-2026. Junto com ele vêm o Android SDK, o Android Emulator e o utilitário adb. Esse é o conjunto principal de ferramentas.
  2. Proxy de interceptação. O guia mostra duas opções: o mitmproxy gratuito (funciona no terminal e via interface web mitmweb) e o Charles Proxy comercial com modo de teste gratuito. Escolha um, o outro você pode aprender depois. Todas as instruções são dadas para ambos.
  3. Java não é necessária separadamente: o Android Studio usa o JDK embutido.
  4. Build de teste do aplicativo em formato APK. Ela deve ser uma build debug ou uma build especial de QA, não a versão de release da loja. Por que isso é crítico — explicaremos na seção sobre certificados.

Requisitos de sistema

  • Sistema operacional: Windows 10 ou 11 (64-bit), macOS 12 ou mais recente, Linux com suporte a KVM.
  • Memória RAM: mínimo 8 GB, confortável — 16 GB. O emulador sozinho consome 2-4 GB.
  • Espaço livre em disco: pelo menos 20 GB. Uma imagem de sistema Android pesa 1,5-2 GB, mais o próprio Android Studio.
  • Virtualização por hardware habilitada na BIOS/UEFI (Intel VT-x ou AMD-V). Sem ela o emulador vai rodar de forma dolorosamente lenta ou não vai iniciar.
  • Um dispositivo Android real com versão Android 8 ou superior e cabo USB para transferência de dados (não apenas para carregar).

Acessos que você precisa solicitar à equipe

  • Endereço do ambiente de teste (por exemplo, https://api-stage.example-team.ru) e credenciais de teste.
  • Build debug do aplicativo ou build com a flag "QA build". Confirme com os desenvolvedores se ela confia em certificados do usuário e se o certificate pinning está desabilitado.
  • Se o ambiente for restrito por IP ou exigir conexão à rede corporativa — pergunte ao administrador como se conectar a partir do seu computador de trabalho. Não consideramos nenhuma forma de contornar restrições: apenas os acessos legítimos concedidos pela sua equipe.

Backups e segurança

As configurações de proxy no emulador e no dispositivo são totalmente reversíveis. Porém, antes de começar, vale fazer duas coisas. Primeiro, se o celular real já tem configurações de Wi-Fi ou certificados em uso, tire prints das telas de configuração — assim você retorna tudo como estava rapidamente. Segundo, é melhor usar um dispositivo de teste separado, e não o telefone pessoal com aplicativos de banco: o certificado raiz do proxy dá ao seu dono a capacidade de ler o tráfego criptografado. Em um dispositivo de teste isso é normal, em um pessoal é risco.

Atenção: Nunca instale o certificado raiz do proxy de interceptação em um dispositivo pessoal que tenha aplicativos bancários e de pagamento, e não envie o arquivo da chave privada do proxy para colegas por mensageiros. O certificado é gerado localmente no seu computador e deve permanecer lá.

Conceitos básicos: como funciona a interceptação de tráfego

O que é um proxy de interceptação

Um proxy comum é um intermediário que recebe a requisição do cliente e a repassa ao servidor. O proxy de interceptação (também chamado de proxy de depuração ou man-in-the-middle) faz o mesmo, mas guarda uma cópia de cada requisição e resposta, mostra tudo de forma organizada e permite pausar, alterar e substituir as mensagens. Para o testador, é como um raio-X para o médico.

Por que o HTTPS não é visível assim tão fácil

Quase todo o tráfego moderno é criptografado pelo protocolo TLS. O proxy vê que o celular se conectou ao servidor api-stage.example-team.ru, mas o conteúdo das requisições é um fluxo criptografado para ele. Para descriptografar, o proxy gera um certificado raiz próprio (CA) e emite certificados falsos para cada site em tempo real. O celular precisa confiar nesse certificado raiz — caso contrário, o aplicativo detecta a substituição e encerra a conexão com um erro do tipo "Trust anchor for certification path not found". Por isso a instalação do certificado do proxy no dispositivo é um passo obrigatório.

Certificados de usuário e de sistema no Android

A partir do Android 7, os aplicativos por padrão confiam apenas em certificados do sistema e ignoram os que o usuário instalou pelas configurações. O navegador Chrome é exceção, ele confia nos do usuário. Para que seu app confie no certificado do proxy, os desenvolvedores têm dois caminhos legítimos: ou adicionam na build debug um arquivo network_security_config.xml permitindo confiar em certificados do usuário, ou você instala o certificado como de sistema em um emulador com root. O primeiro caminho é mais simples e mais correto para o trabalho em equipe.

Certificate pinning

Alguns aplicativos adicionalmente "fixam" um certificado específico do servidor e se recusam a funcionar com qualquer outro, mesmo que confiável. Isso é uma boa proteção em produção, mas para teste no ambiente staging o pinning geralmente é desabilitado nas builds debug. Se depois de todas as configurações o app ainda não passa pelo proxy, pergunte aos desenvolvedores exatamente sobre o pinning.

Como o emulador enxerga o seu computador

O emulador Android é uma máquina virtual com rede própria. Dentro dele, o endereço 127.0.0.1 significa o próprio emulador, não o seu computador. Para acessar o computador a partir do emulador, usa-se um endereço especial 10.0.2.2. Memorize-o — ele vai aparecer nos comandos abaixo.

O que é adb e adb reverse

O adb (Android Debug Bridge) é um utilitário de linha de comando que controla um dispositivo Android a partir do computador: instala aplicativos, executa comandos, faz port forwarding. O comando adb reverse faz com que uma porta no dispositivo "aponte" para uma porta do seu computador. Por exemplo, depois de adb reverse tcp:8080 tcp:8080, um aplicativo no celular que acessa localhost:8080 na verdade chega à porta 8080 do computador, onde o proxy está escutando. Isso funciona via USB, não exige rede Wi-Fi compartilhada e não depende de restrições corporativas do ponto de acesso. O comando inverso, adb forward, funciona ao contrário: a porta do computador leva ao dispositivo. Não os confunda.

Ambiente de teste

O ambiente (stage, staging, dev) é a cópia da parte servidor do aplicativo para testes. No ambiente é possível quebrar dados, substituir respostas e ver logs. O aplicativo geralmente é direcionado ao ambiente por uma build separada ou por um menu oculto. Toda a interceptação de tráfego é feita justamente com o ambiente, e não com produção.

Passo 1: Subindo o proxy de interceptação no computador

Objetivo da etapa: no computador há um proxy rodando, escutando em uma porta (8080 para mitmproxy ou 8888 para Charles), e você sabe o endereço IP do computador na rede local.

Opção A: mitmproxy

  1. Baixe o instalador do mitmproxy para o seu sistema operacional no site oficial do projeto ou instale via gerenciador de pacotes. No macOS, é prático via Homebrew; no Windows, o instalador em formato .msi; no Linux, via pipx ou arquivo binário.
  2. Abra o terminal (no Windows — PowerShell ou Windows Terminal).
  3. Inicie a versão web com o comando:
    mitmweb --listen-port 8080
    No terminal aparecerão linhas sobre a inicialização do proxy na porta 8080, e no navegador abrirá uma aba com a interface web no endereço 127.0.0.1:8081. É aqui que as requisições vão aparecer.
  4. Atenção: a interface do mitmweb roda na porta 8081, e o próprio proxy escuta na 8080. Nas configurações dos dispositivos você sempre indica a 8080.
  5. Na primeira execução o mitmproxy cria a pasta .mitmproxy no diretório home do usuário. Nela está o arquivo mitmproxy-ca-cert.cer — esse é o certificado raiz que vamos instalar nos dispositivos mais adiante.

Dica: Se quiser trabalhar totalmente no terminal sem navegador, use o comando mitmproxy em vez de mitmweb. A interface será em modo console: setas para navegar, Enter para abrir a requisição, q para voltar. Para automação existe o mitmdump, que grava o fluxo em arquivo.

Opção B: Charles Proxy

  1. Baixe o Charles no site oficial, instale e execute. Aparecerá a janela principal com a lista vazia à esquerda e as abas Overview, Contents à direita.
  2. Abra o menu Proxy → Proxy Settings. Na aba Proxies, confirme que a porta é 8888 e que a caixa "Enable transparent HTTP proxying" está desmarcada. Clique em OK.
  3. Abra Proxy → SSL Proxying Settings. Marque a caixa Enable SSL Proxying. No bloco Include, clique em Add e adicione o host * com a porta 443. Assim o Charles vai descriptografar todo o HTTPS. Depois você poderá restringir a lista ao domínio do ambiente.
  4. Se o Charles oferecer para configurar o proxy do sistema macOS ou Windows, recuse: precisamos do tráfego do celular, não do navegador do computador. É possível desativar no menu Proxy, desmarcando macOS Proxy ou Windows Proxy.

Descobrindo o IP do computador

Para o dispositivo real via Wi-Fi, você vai precisar do endereço do computador na rede local.

  1. Windows: no PowerShell execute ipconfig e encontre a linha IPv4 do adaptador ativo Wi-Fi ou Ethernet. Normalmente algo como 192.168.1.45.
  2. macOS: Ajustes do Sistema → Rede → escolha a conexão ativa, o endereço aparece nos detalhes. Ou no terminal ipconfig getifaddr en0.
  3. Linux: comando ip addr show ou hostname -I.

Anote esse endereço. No restante do texto vamos chamá-lo de 192.168.1.45, substitua pelo seu.

Abrindo a porta no firewall

O Windows, na primeira execução do mitmproxy ou Charles, vai perguntar se permite que o programa aceite conexões. Autorize para redes privadas. Se a janela não aparecer, abra "Firewall do Windows Defender → Permitir um aplicativo pelo firewall" e adicione o programa manualmente. No macOS a permissão é solicitada de forma semelhante na primeira conexão de entrada.

Verificação: Abra o navegador no computador, nas configurações dele indique provisoriamente o proxy 127.0.0.1 e a porta 8080 (ou 8888) e acesse qualquer site. No mitmweb ou Charles devem aparecer linhas de requisições. Depois da verificação, remova o proxy do navegador para não atrapalhar. Uma alternativa sem configurar o navegador — o comando:

curl -x http://127.0.0.1:8080 -k https://example.com
Se no proxy aparecer uma linha com example.com, o proxy está funcionando.

Possíveis problemas nesta etapa

  • Porta ocupada. Mensagem do tipo "Address already in use". Significa que algo já está escutando na 8080 — muitas vezes um ambiente local ou outra ferramenta. Inicie o proxy em outra porta, por exemplo 8082, e use-a em todo o restante.
  • O mitmweb não abre o navegador. Abra manualmente o endereço 127.0.0.1:8081. No terminal será impresso um endereço com token, copie ele inteiro.
  • O Charles não mostra o conteúdo HTTPS, apenas cabeçalhos CONNECT. O SSL Proxying não está ativado ou o host não foi adicionado em Include. Volte ao item 3 da opção B.

Passo 2: Direcionando o tráfego do emulador Android para o proxy

Objetivo da etapa: o emulador em execução envia todas as requisições HTTP e HTTPS para o seu proxy, e você as vê na interface.

Criando e iniciando o emulador

  1. Abra o Android Studio. Se não houver projeto aberto, na tela inicial escolha More Actions → Virtual Device Manager. Dentro de um projeto: menu Tools → Device Manager.
  2. Clique no botão de criar dispositivo (o ícone de mais ou Create Virtual Device).
  3. Escolha um modelo, por exemplo Pixel 8, e clique em Next.
  4. Escolha a imagem de sistema. Importante: para testar com proxy é mais prático usar uma imagem com rótulo Google APIs, em vez de Google Play. Nas imagens Google Play o acesso root é bloqueado, e você não conseguirá instalar um certificado de sistema caso precise. No Android 14-16 essas imagens se chamam algo como "Android 15.0 Google APIs x86_64" (em computadores com processadores Apple — arm64-v8a). Se ao lado da imagem houver uma flecha de download, baixe-a, isso leva de 5 a 15 minutos.
  5. Na última tela, dê ao dispositivo um nome sem espaços, por exemplo Pixel_8_QA, e clique em Finish.
  6. Inicie o emulador com o botão de triângulo. A primeira inicialização leva de 1 a 3 minutos.

Método 1: configuração pelo painel do emulador (o mais simples)

  1. Na janela do emulador em execução, encontre o painel vertical à direita. Clique nos três pontos na parte inferior — abrirá a janela Extended Controls.
  2. No menu à esquerda escolha Settings, depois a aba Proxy.
  3. Desmarque a caixa "Use Android Studio HTTP proxy settings".
  4. Escolha Manual proxy configuration.
  5. No campo Host name digite 127.0.0.1. Aqui, ao contrário das configurações dentro do próprio Android, o emulador aplica o proxy no nível da máquina host, então o endereço do computador é indicado como 127.0.0.1.
  6. No campo Port number digite 8080 (para Charles — 8888).
  7. Clique em Apply. Abaixo deve aparecer o status "Proxy status: Success". Se estiver escrito Error — o proxy não está rodando ou a porta está errada.

Método 2: configuração via adb (flexível, ideal para scripts)

  1. Abra o terminal. Confirme que o adb está disponível: o comando adb devices deve mostrar uma linha como emulator-5554 device. Se o comando não for encontrado, adicione ao PATH a pasta platform-tools dentro do Android SDK (o caminho pode ser visto no Android Studio: Settings → Languages and Frameworks → Android SDK).
  2. Execute:
    adb shell settings put global http_proxy 10.0.2.2:8080
    Aqui já estamos "dentro" do Android, por isso o computador é indicado pelo endereço 10.0.2.2.
  3. Verifique se a configuração foi aplicada:
    adb shell settings get global http_proxy
    Deve retornar 10.0.2.2:8080.
  4. Para desativar o proxy, execute:
    adb shell settings put global http_proxy :0

Método 3: parâmetro de linha de comando na inicialização

Se você inicia o emulador pelo terminal (por exemplo, em CI ou scripts), adicione a flag:

emulator -avd Pixel_8_QA -http-proxy http://127.0.0.1:8080

O executável emulator fica na pasta emulator dentro do Android SDK. O proxy será aplicado a toda a sessão do emulador.

Dica: Faça dois pequenos scripts — proxy_on e proxy_off — com os comandos adb do método 2. Durante o dia de teste você vai ligar e desligar o proxy dezenas de vezes, e cliques extras nos menus cansam.

Verificando que o tráfego começou a passar

  1. No emulador, abra o navegador Chrome e acesse qualquer site em HTTPS.
  2. No mitmweb ou Charles devem aparecer requisições. Provavelmente a página no Chrome mostrará um erro de segurança — isso é normal, ainda não instalamos o certificado. O importante é que as requisições apareçam como registros com host e método CONNECT.

Verificação: Na interface do proxy aparecem linhas com o domínio do site que você abriu no emulador, e o comando adb shell settings get global http_proxy retorna o endereço e a porta do seu proxy. Se as duas condições estão satisfeitas — o emulador está direcionado ao proxy corretamente.

Possíveis problemas

  • Proxy status: Error no painel do emulador. O proxy não está rodando, ou a porta é outra. Inicie o mitmweb ou o Charles e clique em Apply novamente.
  • As requisições não aparecem, embora o status seja Success. O aplicativo pode usar um stack de rede próprio que ignora o proxy do sistema (por exemplo, apps em Flutter por padrão). Sobre isso — na seção de erros típicos.
  • O emulador perdeu a internet depois de desligar o proxy. Você provavelmente deixou o valor de http_proxy vazio, e não ":0". Repita o comando de desligar com dois-pontos e zero e reinicie o emulador.

Passo 3: Instalando o certificado do proxy e resolvendo o problema de confiança

Objetivo da etapa: o emulador e o app de teste confiam no certificado raiz do proxy, e você vê o conteúdo descriptografado das requisições HTTPS: URL, cabeçalhos, corpos de requisição e resposta.

Instalando o certificado como de usuário

  1. Confirme que o proxy está ativo no emulador (Passo 2).
  2. No navegador Chrome dentro do emulador, abra o endereço mitm.it (para mitmproxy) ou chls.pro/ssl (para Charles). Esses são endereços especiais que o proxy intercepta e entrega a página de download do certificado. Se em vez da página você vê um site comum ou um erro — o tráfego não está passando pelo proxy, volte ao Passo 2.
  3. Para o mitmproxy clique no botão Android e baixe o arquivo mitmproxy-ca-cert.cer. Para o Charles o arquivo baixa direto.
  4. No emulador, abra Configurações → Segurança e privacidade → Mais configurações de segurança → Criptografia e credenciais → Instalar certificado → Certificado de CA (em algumas versões o caminho é: Segurança → Configurações adicionais → Criptografia e credenciais). Aparecerá um aviso sobre riscos — clique em "Instalar mesmo assim".
  5. Escolha o arquivo baixado na pasta Downloads. Se o emulador pedir para definir um PIN de tela, defina um simples, por exemplo 1234, e memorize.
  6. Após a instalação, verifique: Criptografia e credenciais → Certificados confiáveis → aba Usuário. Deve aparecer ali um registro mitmproxy ou Charles Proxy CA.

Um método alternativo sem navegador é copiar o arquivo com o comando adb push e depois selecioná-lo no gerenciador de arquivos:

adb push ~/.mitmproxy/mitmproxy-ca-cert.cer /sdcard/Download/

Agora o Chrome no emulador abrirá qualquer site HTTPS sem erros, e no proxy você verá as requisições descriptografadas do navegador. Mas o seu app de teste provavelmente ainda vai falhar com erro de rede. Vamos ao ponto principal.

Por que o app não confia e o que pedir aos desenvolvedores

Como vimos nos conceitos básicos, apps no Android 7+ ignoram certificados de usuário. A solução correta é que a build debug contenha o arquivo de configuração de segurança de rede. O desenvolvedor adiciona em res/xml/network_security_config.xml algo assim:

<network-security-config><debug-overrides><trust-anchors><certificates src='system' /><certificates src='user' /></trust-anchors></debug-overrides></network-security-config>

E o conecta no AndroidManifest.xml pelo atributo android:networkSecurityConfig. O bloco debug-overrides funciona apenas em builds de depuração, então a versão release permanece protegida. Essa é a prática padrão, e na maioria das equipes esse arquivo já existe. Copie o trecho acima em uma tarefa para o desenvolvedor, caso não exista.

Atenção: Não peça para adicionar confiança em certificados de usuário na configuração base sem debug-overrides e não aceite desativar a verificação de certificados em release. Isso enfraquecerá a proteção dos usuários reais. Todas as alterações devem afetar apenas builds debug e de QA.

Caminho alternativo: certificado de sistema em emulador com root

Se não conseguirem alterar a build para você, em um emulador com imagem Google APIs (não Google Play) o certificado pode ser colocado no armazenamento do sistema. Então qualquer app sem pinning vai confiar nele. Resumidamente, o procedimento para Android 14 e mais recente, onde os certificados de sistema ficam na partição apex:

  1. Inicie o emulador pelo terminal com a flag -writable-system.
  2. Execute adb root, depois adb remount.
  3. Calcule o nome do arquivo de certificado no formato hash.0 com o comando openssl x509 -inform PEM -subject_hash_old -in mitmproxy-ca-cert.cer -noout e renomeie o arquivo para o valor obtido com sufixo .0 (por exemplo, c8750f0d.0).
  4. Copie o arquivo para o armazenamento de certificados do sistema via adb push em /system/etc/security/cacerts/ e reinicie o emulador. No Android 14+ é necessário ainda remontar o diretório de onde o sistema carrega os certificados; na documentação do mitmproxy há um script pronto para isso.

Esse caminho é mais poderoso, mas mais frágil: depois de atualizar a imagem tudo se reseta, e no Android 14+ os passos são mais complicados. Para o dia a dia, recomendamos o primeiro caminho com network_security_config.

Instalando o aplicativo de teste

  1. Coloque o APK em uma pasta conveniente.
  2. Execute adb install -r caminho/para/app-debug.apk. A flag -r reinstala por cima da versão existente, preservando os dados.
  3. Em 10-30 segundos aparecerá Success, e o ícone do aplicativo surgirá no emulador.

Verificação: Abra o app de teste, faça login no ambiente. No mitmweb ou Charles apareceram requisições para o domínio do ambiente, e ao clicar em qualquer uma delas você vê abas com cabeçalhos, corpo da requisição em JSON e corpo da resposta. Se o corpo da resposta estiver legível — o certificado está instalado e o app confia nele. Esse é o principal ponto de controle de todo o guia.

Possíveis problemas

  • O Chrome abre os sites, mas o app mostra erro de rede. O app não confia no certificado de usuário. É necessária uma build com network_security_config ou um certificado de sistema.
  • Nos logs do app (adb logcat) aparece "Certificate pinning failure". O pinning está ativo. Peça uma build de QA com pinning desabilitado para o domínio do ambiente.
  • O mitm.it mostra a página "If you can see this, traffic is not passing through mitmproxy". O proxy não foi aplicado. Verifique a configuração do Passo 2.

Passo 4: Conectando o dispositivo real por Wi-Fi

Objetivo da etapa: um smartphone real na mesma rede Wi-Fi que o computador envia o tráfego para o proxy.

Esse é o método descrito em tutoriais comuns para usuários, mas o testador tem suas particularidades: precisa entender quando ele não funciona e conseguir alternar rapidamente. O emulador não substitui um dispositivo real: nele não há câmera real, as notificações push chegam de forma diferente, os sensores e a economia de energia se comportam de outra forma. Por isso, testar cenários de rede em um celular real é obrigatório.

Configurando o proxy nos parâmetros de Wi-Fi

  1. Conecte o celular à mesma rede Wi-Fi que o computador. Um roteador doméstico serve. Rede corporativa de visitantes — muitas vezes não, veja abaixo.
  2. Abra Configurações → Rede e internet → Wi-Fi (na Samsung: Conexões → Wi-Fi).
  3. Toque na engrenagem ao lado da rede atual ou faça um toque longo no nome da rede para abrir o menu e escolha "Modificar rede".
  4. Expanda "Avançado" ou "Configurações avançadas".
  5. No item Proxy escolha Manual.
  6. Nome do host do proxy: o endereço IP do seu computador, por exemplo 192.168.1.45. Porta: 8080 ou 8888. O campo "Não usar proxy para" deixe vazio.
  7. Salve. O celular vai reconectar à rede.

Instalando o certificado no celular

  1. Abra o Chrome no celular e acesse mitm.it ou chls.pro/ssl. Baixe o certificado.
  2. Configurações → Segurança → Criptografia e credenciais → Instalar certificado → Certificado de CA → escolha o arquivo. Os nomes dos itens variam um pouco entre Samsung, Xiaomi, Huawei, mas a lógica é a mesma: procure as palavras "credenciais" ou "certificado".
  3. Instale o aplicativo de teste via adb install ou diretamente a partir do arquivo.

Dica: Atribua ao computador um endereço IP fixo nas configurações do roteador (reserva DHCP por MAC address). Caso contrário, depois de reiniciar o roteador o endereço mudará, e todos os celulares da equipe deixarão de passar pelo proxy, e você vai perder meia hora procurando a causa.

Quando o método Wi-Fi não funciona

  • Isolamento de clientes (AP isolation) em rede corporativa ou de visitantes. Os dispositivos acessam a internet, mas não se enxergam. Sintoma: o celular com o proxy perde completamente a internet, e o mitm.it não abre. Verificação: do computador, execute ping no IP do celular (pode ser visto nas propriedades do Wi-Fi). Sem resposta — há isolamento.
  • Computador e celular em sub-redes diferentes. Por exemplo, o notebook em rede cabeada 10.10.0.x e o celular em Wi-Fi 192.168.1.x.
  • O firewall do computador bloqueia entradas. Problema especialmente comum no Windows com rede "Pública". Mude o perfil de rede para "Privada".

Em todos esses casos a solução é a mesma — port forwarding via USB, para o qual vamos agora.

Verificação: Na interface do proxy apareceram requisições do celular, e no Charles na coluna Client aparece o IP do celular, diferente de 127.0.0.1. Abra o app de teste, faça qualquer ação — a requisição correspondente ao ambiente apareceu na lista com o corpo descriptografado.

Passo 5: Port forwarding via adb reverse — proxy por USB sem Wi-Fi

Objetivo da etapa: um celular real conectado apenas por cabo USB direciona o tráfego para o proxy no computador, independentemente da rede Wi-Fi.

Esse é o método mais confiável para escritório, coworking e qualquer rede onde você não administra o roteador. A ideia: com o comando adb reverse fazemos a porta 8080 do próprio celular apontar para a porta 8080 do computador. Depois dizemos ao celular para usar o proxy 127.0.0.1:8080 — ou seja, "ele mesmo", e o adb entrega os pacotes ao computador de forma transparente.

Ativando a depuração USB

  1. No celular, abra Configurações → Sobre o telefone e toque sete vezes em "Número da versão". Aparecerá a mensagem "Você agora é um desenvolvedor". No Xiaomi é preciso tocar em "Versão MIUI" ou "Versão HyperOS".
  2. Volte para Configurações → Sistema → Opções do desenvolvedor (na Samsung — na raiz das Configurações). Ative a chave Depuração USB.
  3. Conecte o celular por cabo ao computador. No celular aparecerá o pedido "Permitir depuração USB?" com a impressão digital do computador. Marque "Sempre permitir" e clique em Permitir.
  4. No computador execute adb devices. Deve aparecer uma linha com o número de série e a palavra device. Se estiver escrito unauthorized — olhe a tela do celular, ali há um pedido. Se estiver offline — reconecte o cabo.

Atenção: Use um cabo que suporte transferência de dados. Muitos cabos baratos que vêm com baterias externas só carregam. Se o celular carrega, mas o adb devices fica vazio — primeiramente troque o cabo, e não reinstale drivers.

Executando o port forwarding

  1. Confirme que o proxy no computador está rodando e escutando na porta 8080.
  2. Execute o comando:
    adb reverse tcp:8080 tcp:8080
    O primeiro número é a porta no celular, o segundo é a porta no computador. Em resposta o comando imprime 8080 ou nada — isso é normal.
  3. Verifique a lista de redirecionamentos ativos:
    adb reverse --list
    Deve aparecer uma linha como host-número tcp:8080 tcp:8080.
  4. Se você tem vários dispositivos conectados (por exemplo, emulador e celular), indique o número de série com a flag -s:
    adb -s R58M1234ABC reverse tcp:8080 tcp:8080

Indicando ao celular o proxy em localhost

Aqui há dois caminhos. O primeiro — via adb, o mais rápido:

adb shell settings put global http_proxy 127.0.0.1:8080

O segundo — manualmente nas configurações de Wi-Fi do celular, como no Passo 4, mas no campo de host indicar 127.0.0.1 e a porta 8080. O segundo método é necessário em algumas ROMs, onde a configuração global via adb não se aplica a todos os aplicativos.

Note um detalhe importante. A configuração global http_proxy é aplicada pelo sistema à conexão de rede atual. Se o Wi-Fi estiver desligado e o celular estiver usando dados móveis, algumas ROMs ainda aplicam, outras não. O mais confiável é manter o Wi-Fi ligado (qualquer rede, mesmo sem acesso ao computador) e indicar o proxy 127.0.0.1 nas suas configurações. O tráfego via adb reverse passará pelo USB independentemente de a qual rede Wi-Fi o celular está conectado.

Instalando o certificado

O procedimento é o mesmo de antes: Chrome → mitm.it → baixar → instalar como certificado de CA. Se o certificado já foi instalado neste celular no Passo 4, não é preciso repetir.

Desativando o port forwarding após o trabalho

  1. Remova o proxy: adb shell settings put global http_proxy :0 (ou "Nenhum" nas configurações de Wi-Fi).
  2. Cancele o redirecionamento: adb reverse --remove tcp:8080 ou todos de uma vez: adb reverse --remove-all.
  3. Considere que ao desconectar o cabo os redirecionamentos se perdem automaticamente, mas a configuração de proxy no celular permanece. Se esquecer de removê-la, o celular sem cabo ficará sem internet. É exatamente assim que aparece a reclamação mais comum dos novatos: "o celular não carrega nada".

Dica: Faça uma cola de três linhas: adb reverse tcp:8080 tcp:8080, adb shell settings put global http_proxy 127.0.0.1:8080, adb shell settings put global http_proxy :0. Esses três comandos bastam para 90 por cento das situações de trabalho com dispositivo real.

Verificação: Desligue o Wi-Fi do computador ou use o celular em uma rede onde o computador não é acessível. Execute adb reverse, defina o proxy 127.0.0.1:8080, abra mitm.it no Chrome do celular. A página de download do certificado abriu — o redirecionamento funciona. Em seguida abra o app de teste e confirme que as requisições dele aparecem no proxy.

Possíveis problemas

  • adb reverse retorna "error: closed" ou "more than one device". Há vários dispositivos conectados; indique -s número_de_série. Ou o dispositivo ficou offline — reconecte o cabo.
  • O redirecionamento existe, mas o mitm.it não abre. Verifique se o proxy no computador escuta exatamente em 127.0.0.1 ou em todas as interfaces, e não apenas no IP externo. No mitmproxy, por padrão, todas as interfaces. No Charles também.
  • Depois de reconectar o cabo o tráfego sumiu. O adb reverse é resetado a cada reconexão. Execute o comando novamente. A configuração de proxy no celular permanece.

Passo 6: Interceptando e substituindo o tráfego do ambiente de teste

Objetivo da etapa: você sabe filtrar requisições ao ambiente, ler corpos de requisição e resposta, pausar uma requisição e substituir a resposta do servidor, emular erros e rede lenta, além de direcionar o app a um backend local via adb reverse.

Filtrando apenas o necessário

O app envia dezenas de requisições de fundo: analytics, atualização de configs, verificação de versão. Para não se afogar, configure um filtro pelo domínio do ambiente.

  1. No mitmweb, no campo de filtro superior, digite uma expressão como ~d api-stage.example-team.ru — só ficarão requisições a esse domínio. A expressão ~u /orders filtra por parte da URL, ~c 500 mostra apenas respostas com código 500, e ~m POST — apenas requisições POST. As expressões podem ser combinadas com espaço.
  2. No Charles ative o modo Focus: clique com o botão direito no host do ambiente → Focus. Os outros hosts ficam agrupados em Other Hosts. Adicionalmente, no campo Filter inferior, você pode digitar parte da URL.

Lendo a requisição e a resposta para anexar ao bug

  1. Clique na linha da requisição. No mitmweb à direita aparecerão as abas Request, Response, Detail. No Charles — as abas Overview, Contents, Summary e embaixo os alternadores Headers, JSON Text, Raw.
  2. Copie a URL, o método, o código de resposta e o corpo da resposta em JSON. No mitmweb é possível clicar com o botão direito e escolher Export → curl: você obtém um comando que o desenvolvedor reproduz em um segundo. No Charles igualmente: botão direito → Copy cURL Request.
  3. Um bom relatório de bug sobre erro de rede sempre contém: passos, URL com método, código e corpo da resposta, o horário da requisição (para localizar nos logs do servidor) e o identificador da requisição nos cabeçalhos, se o backend retornar um (frequentemente X-Request-Id).

Pausando a requisição e alterando a resposta

Cenário clássico: é preciso verificar como o app exibe um carrinho com cem produtos ou um preço negativo, mas o ambiente não tem esses dados. Substituímos a resposta.

  1. No mitmweb, no campo Intercept, digite um filtro como ~u /cart. Agora todas as requisições com essa URL serão pausadas. Execute a ação no app. A requisição aparecerá marcada como intercepted. Clique nela, pressione Resume depois de editar a resposta na aba Response (ícone de lápis). O app receberá os dados alterados.
  2. No Charles ative Breakpoints: botão direito na requisição → Breakpoints. Na próxima requisição desse tipo abrirá uma janela com duas fases: primeiro Edit Request, depois Edit Response. Altere o JSON na aba Response e clique em Execute.
  3. Considere que os apps têm timeout, geralmente de 10 a 30 segundos. Se você levar mais tempo para editar a resposta, o app mostrará um erro de rede, e não os seus dados. Prepare o JSON de antemão em um editor de texto e cole inteiro.

Substituição permanente da resposta: Map Local

Se o cenário se repete, pausas manuais são inconvenientes. No Charles existe Tools → Map Local: você indica a URL e um arquivo local com JSON, e toda requisição desse tipo receberá o conteúdo do arquivo em vez da resposta do ambiente. No mitmproxy o equivalente é a opção map_local com um padrão de URL e o caminho do arquivo, além de pequenos scripts em Python com a função response, capaz de alterar quaisquer campos. Por exemplo, um script de cinco linhas consegue, em todas as respostas do ambiente, substituir o valor do campo balance pelo número que você quiser.

Emulando erros do servidor

Como o app se comporta diante de um 500, um 401 ou uma resposta vazia? Testar isso no ambiente é difícil, mas pelo proxy é fácil. No Charles: Tools → Rewrite → adicione uma regra para a URL do ambiente com o tipo Response Status e o valor 500. No mitmproxy: no modo de interceptação, altere o código de status no editor da resposta, ou use um script com flow.response.status_code = 500. Verifique se o app mostra um erro claro, em vez de travar ou ficar preso em um loader infinito.

Emulando rede lenta

No Charles ative Proxy → Throttle Settings, escolha o preset 3G ou defina seus próprios valores: largura de banda, latência, percentual de perdas. Não esqueça de restringir o Throttle apenas ao host do ambiente, senão outras conexões também ficarão lentas. Teste o carregamento de listas, o cancelamento de requisições ao sair da tela e o comportamento em caso de timeout. O emulador Android também sabe limitar a rede: Extended Controls → Cellular → Network type, mas o proxy dá um controle mais fino.

Direcionando o app a um backend local

Tarefa frequente: o desenvolvedor subiu um servidor no notebook dele na porta 3000 e pede para verificar a feature antes de subir ao ambiente. O app no celular real não enxerga o localhost dele. A solução é o mesmo adb reverse:

adb reverse tcp:3000 tcp:3000

Agora, no aplicativo (via menu oculto de seleção de ambiente ou configuração de base URL na build de QA), indique o endereço http://localhost:3000, e as requisições irão para o computador. Se a interceptação também for necessária, deixe o proxy ativo: o mitmproxy verá as requisições a localhost:3000 como comuns. No emulador, em vez do adb reverse, pode-se simplesmente usar o endereço http://10.0.2.2:3000.

Dica: Salve as sessões. No Charles — File → Save Session; no mitmproxy — o comando mitmdump -w session.mitm ou o botão de salvar no mitmweb. Um arquivo de sessão com a reprodução do bug vale mais que qualquer descrição: o desenvolvedor vai abri-lo e ver todas as requisições na mesma ordem em que passaram por você.

Verificação: Você consegue: mostrar apenas as requisições ao ambiente; copiar qualquer requisição como curl; pausar uma requisição e devolver ao app um JSON alterado que aparece na tela; fazer o app receber um código 500 e ver a reação; desacelerar a rede e ver o indicador de carregamento. Se os cinco pontos funcionaram — você dominou o proxy no nível de usuário confiante.

Verificação do resultado: checklist final

Percorra a lista e marque cada item. Todos devem estar cumpridos — assim o ambiente está totalmente pronto para o trabalho diário.

Proxy no computador

  • mitmweb ou Charles inicia sem erros e escuta na sua porta.
  • O comando curl -x http://127.0.0.1:8080 -k https://example.com exibe a requisição na interface.
  • O arquivo do certificado raiz foi encontrado e você sabe onde ele está.

Emulador

  • adb devices mostra o emulador com status device.
  • adb shell settings get global http_proxy retorna 10.0.2.2:8080 ou no painel Extended Controls o status é Success.
  • O Chrome no emulador abre sites HTTPS sem avisos.
  • O certificado aparece na aba Usuário das configurações de segurança.
  • O app de teste funciona, suas requisições ao ambiente aparecem com corpos descriptografados.

Dispositivo real

  • A depuração USB está ativada, o adb devices enxerga o celular.
  • Por Wi-Fi: proxy no IP do computador, o mitm.it abre, as requisições do app aparecem.
  • Por USB: adb reverse --list mostra tcp:8080, o proxy 127.0.0.1:8080 está definido, o mitm.it abre com o Wi-Fi do computador desligado.
  • Você sabe desativar o proxy e o redirecionamento, e depois de desativar o celular acessa a internet normalmente.

Trabalho com o ambiente

  • O filtro pelo domínio do ambiente está configurado.
  • Foi feita pelo menos uma substituição de resposta via pausa ou Map Local.
  • A reação do app ao código 500 foi verificada.
  • Uma sessão com exemplo de tráfego foi salva.

Cenário de teste para autoverificação

  1. Inicie o proxy, o emulador e ative o proxy no emulador.
  2. Abra o app, faça login, abra qualquer lista de dados.
  3. Encontre no proxy a requisição que retornou essa lista. Coloque a interceptação na URL dela.
  4. Atualize a lista no app, na resposta pausada remova metade dos itens, solte.
  5. A tela do app deve exibir menos itens. Se sim — o ambiente está totalmente funcional.

Erros típicos e soluções

Problema 1: o app mostra erro de rede, mas o navegador funciona

Causa: o app não confia no certificado de usuário (comportamento padrão do Android 7+) ou o certificate pinning está ativo. Solução: solicite uma build debug com network_security_config e o bloco debug-overrides, ou uma build de QA com pinning desabilitado para o ambiente. Como alternativa temporária em emulador Google APIs — certificado de sistema. Ajuda a descobrir a causa o adb logcat com filtro pela palavra Trust ou pinning.

Problema 2: não há requisição alguma, embora o proxy esteja definido

Causa: o aplicativo usa uma biblioteca de rede que ignora o proxy do sistema. É assim que se comportam apps em Flutter (cliente dart:io), algumas builds em React Native e aplicativos em gRPC. Solução: para Flutter, o desenvolvedor adiciona na build debug suporte ao proxy do sistema através de um pacote que lê configurações de proxy ou define explicitamente findProxy para 10.0.2.2:8080 em modo de depuração. É um pedido padrão, desenvolvedores Flutter o conhecem. A alternativa é o modo de proxy transparente, mas é mais complexo e não é abordado aqui.

Problema 3: o celular fica sem internet depois dos testes

Causa: o proxy ficou nas configurações de Wi-Fi ou na configuração global http_proxy, e o servidor proxy está desligado ou o cabo foi desconectado. Solução: adb shell settings put global http_proxy :0, e nas configurações de Wi-Fi, coloque o proxy em "Nenhum". Adicione essa ação ao final do seu ritual de trabalho.

Problema 4: o adb não enxerga o dispositivo

Causa: cabo só para carregamento, pedido de depuração não confirmado, driver não instalado no Windows, dispositivo no modo "Somente carregar" em vez de "Transferência de arquivos". Solução: troque o cabo, verifique a tela do celular, mude o modo USB na gaveta de notificações para "Transferência de arquivos", no Windows instale o Google USB Driver pelo SDK Manager ou o driver do fabricante. Também ajuda adb kill-server e depois adb start-server.

Problema 5: o Charles mostra apenas CONNECT sem conteúdo

Causa: o SSL Proxying não está ativado ou o domínio não foi adicionado em Include. Solução: Proxy → SSL Proxying Settings → Enable → Add host * porta 443. Depois de ativar, reabra o aplicativo: as conexões já estabelecidas não são descriptografadas retroativamente.

Problema 6: no painel do emulador Proxy status: Error

Causa: o proxy no computador não está rodando ou a porta é outra. Às vezes — o Android Studio intercepta as configurações com o próprio proxy. Solução: inicie o proxy, desmarque a caixa de usar as configurações do Android Studio, clique em Apply novamente. Se não resolver — defina o proxy via adb com o comando com endereço 10.0.2.2.

Problema 7: o mitm.it não abre, mas o resto da internet funciona

Causa: o tráfego está passando fora do proxy. Em dispositivo real via Wi-Fi, muitas vezes a culpa é do isolamento de clientes na rede. Solução: verifique o ping ao celular a partir do computador. Sem resposta — mude para adb reverse. Com resposta — verifique o firewall e a porta.

Problema 8: depois de atualizar o Android Studio o certificado desapareceu

Causa: você fez Wipe Data do emulador ou o recriou. Solução: o certificado de usuário é instalado em um minuto via mitm.it. Para não perder o estado, use snapshots do emulador (Snapshots em Extended Controls): salve um snapshot depois de instalar o certificado e o aplicativo.

Problema 9: vários dispositivos e os comandos são aplicados no lugar errado

Causa: o adb sem a flag -s, com dois ou mais dispositivos conectados, se recusa a trabalhar ou trabalha com um inesperado. Solução: use sempre adb -s número_de_série, e veja os números de série com adb devices. É possível definir a variável de ambiente ANDROID_SERIAL com o número desejado.

Recursos adicionais para testadores avançados

Simulador iOS e iPhone real

A lógica é a mesma, as ferramentas são outras. O simulador iOS usa as configurações de rede do macOS, então o proxy é definido nos ajustes de Rede do Mac, e o certificado é arrastado para a janela do simulador e ativado em Ajustes → Geral → Sobre → Ajustes de confiança de certificados. Em um iPhone real, o proxy é definido nas propriedades do Wi-Fi, o certificado é baixado via mitm.it e ativado pelo mesmo caminho com confiança. Não há equivalente ao adb reverse para iPhone via USB; em redes fechadas usa-se o compartilhamento de internet do Mac por cabo.

Automação com mitmdump e scripts

O mitmdump funciona sem interface e aceita scripts em Python. Exemplo de tarefa: em todas as respostas do ambiente, substituir o campo feature_flags para habilitar uma funcionalidade experimental sem acesso ao admin. O script é executado com a flag -s script.py, e o tráfego é gravado em arquivo com a flag -w. Esses scripts convém guardar no repositório de testes junto com os autotestes.

Integração com Appium e autotestes

Nos autotestes, o proxy é ativado antes de iniciar a sessão: configuração via adb, depois verificação de asserções não apenas pela UI, mas também pelo tráfego. Por exemplo, o teste clica no botão "Pagar" e verifica que no mitmproxy apareceu um POST para /payments com o valor correto. Isso captura bugs que a UI não mostra: requisições duplicadas, envio de campos extras, formato de data errado.

Verificação de analytics e tracking

O proxy é insubstituível para testar eventos de analytics: você vê quais eventos e com quais parâmetros o app envia a cada ação. O filtro pelo domínio do sistema de analytics e a coluna com o corpo da requisição substituem longas esperas pelo aparecimento de eventos nos dashboards.

Vários emuladores com proxies diferentes

Se for preciso comparar o comportamento com respostas diferentes do ambiente, inicie dois proxies nas portas 8080 e 8090 e dois emuladores, cada um com seu proxy via adb -s. Assim é prático verificar variantes de A/B: um emulador recebe a resposta substituída via Map Local, o outro — a original.

Snapshots do emulador como ambiente limpo

Depois de configurar o proxy, o certificado e o aplicativo, salve um snapshot do emulador. Antes de cada rodada de teste, carregue-o — e você obtém um ambiente idêntico em segundos, sem reinstalação.

Separação de ambientes e segurança

Mantenha perfis separados do Charles ou configurações do mitmproxy para projetos diferentes. Não ative a interceptação de todo o tráfego do computador de forma sistêmica — apenas o tráfego dos dispositivos. E verifique periodicamente que os dispositivos de teste não têm contas pessoais, afinal todo o tráfego deles é visível no proxy.

FAQ: dúvidas frequentes sobre configuração de proxy em testes mobile

Qual a diferença entre adb reverse e adb forward?

O adb reverse faz com que uma porta do dispositivo leve ao computador: um aplicativo no celular acessa localhost e chega ao PC. O adb forward é o contrário: a porta do computador leva ao dispositivo, é assim que se conecta, por exemplo, a um depurador ou a um servidor web dentro do celular. Para proxy e backend local, é exatamente o reverse que se usa.

É obrigatório instalar o certificado se eu só quero ver as URLs das requisições?

Não. Sem o certificado você verá os hosts e as requisições CONNECT, mas não os caminhos, parâmetros e corpos. Porém o aplicativo receberá erros de TLS, então não será possível testá-lo adequadamente. Na prática, o certificado sempre é instalado.

Por que no emulador o endereço do computador é 10.0.2.2, mas no painel Extended Controls é preciso usar 127.0.0.1?

O painel do emulador aplica o proxy no lado da máquina host, por isso ali o endereço do computador é 127.0.0.1. Já o comando adb shell é executado dentro do Android, onde 127.0.0.1 é o próprio emulador, e o computador está acessível em 10.0.2.2. Memorize a regra: dentro do Android — 10.0.2.2, fora — 127.0.0.1.

É possível usar proxy no dispositivo sem root?

Sim. Tudo o que é descrito no guia, exceto a instalação de certificado de sistema, funciona sem root. A condição-chave é uma build debug do aplicativo que confie em certificados de usuário.

O que fazer se o aplicativo parou de funcionar pelo proxy depois de atualizar a build?

Provavelmente os desenvolvedores ativaram o pinning ou removeram os debug-overrides. Verifique o adb logcat em busca de erros de certificado e confirme com a equipe o que mudou na configuração de rede. Frequentemente isso acontece ao migrar para uma nova biblioteca de cliente HTTP.

Como verificar o aplicativo pelo proxy usando internet móvel, e não Wi-Fi?

Use o adb reverse por USB e a configuração global http_proxy 127.0.0.1:8080. Na maioria dos dispositivos o proxy se aplica também aos dados móveis. Se não — teste por Wi-Fi, e os cenários de troca de rede verifique separadamente sem proxy.

É possível interceptar o tráfego de uma versão de produção da loja?

Tecnicamente, builds de release não confiam em certificados de usuário e frequentemente contêm pinning, então sem modificações isso não funciona. E isso está correto: a proteção dos usuários é mais importante que a conveniência do testador. Faça todas as verificações em builds de teste e no ambiente.

Como entender que a requisição saiu do aplicativo, e não de um serviço em segundo plano ou do navegador?

No Charles há a coluna Client Process no macOS, e no dispositivo a informação sobre o processo não é transmitida. Uma dica prática: feche todos os outros aplicativos, filtre pelo domínio do ambiente e reproduza a ação de forma pontual. Em casos duvidosos, olhe o cabeçalho User-Agent — os aplicativos costumam incluir seu nome e versão.

Como salvar o tráfego e enviar ao desenvolvedor?

No Charles — File → Save Session As em formato .chls ou Export em formato HAR. No mitmproxy — a flag -w para gravar ou salvar pela interface web. O HAR é lido por quase qualquer ferramenta, incluindo a aba Network das ferramentas de desenvolvedor do navegador.

Quanto tempo leva a configuração diária depois da primeira vez?

Iniciar o proxy, o emulador a partir do snapshot e ativar o proxy via adb — cerca de um minuto. Dispositivo real por USB — dois comandos e dez segundos. A configuração do certificado só se repete após reset do dispositivo.

Conclusão

Vamos resumir. Você subiu um proxy de interceptação no computador e confirmou que ele vê o tráfego. Direcionou para ele o emulador Android de três maneiras diferentes e entendeu os endereços 127.0.0.1 e 10.0.2.2. Instalou o certificado raiz e entendeu por que o aplicativo pode não confiar nele e o que exatamente pedir aos desenvolvedores. Conectou um dispositivo real por Wi-Fi, esbarrou nas limitações das redes de escritório e resolveu com port forwarding via adb reverse. Aprendeu a filtrar o tráfego do ambiente, pausar requisições, substituir respostas, emular erros do servidor e rede lenta, além de direcionar o aplicativo a um backend local do colega.

Esse é o conjunto de habilidades que distingue o testador de aplicativos mobile capaz de encontrar e localizar bugs de rede por conta própria. Seus relatórios de bug ficarão mais precisos, e os desenvolvedores agradecerão pelos comandos curl prontos e arquivos de sessão.

O que fazer a seguir

  • Repita a configuração no seu projeto de trabalho, garanta o aparecimento das requisições descriptografadas ao ambiente.
  • Monte uma cola pessoal com os comandos adb e salve o snapshot do emulador com o ambiente pronto.
  • Faça um ciclo completo de teste de uma feature com o proxy aberto e conte quantos bugs foram encontrados graças à visibilidade do tráfego.

Para onde evoluir

O próximo nível são scripts para mitmproxy em Python, que substituem respostas automaticamente, a integração de verificações de tráfego em autotestes com Appium e o teste da API do ambiente diretamente via Postman ou curl em paralelo com o cliente mobile. Vale a pena estudar os fundamentos de TLS e a estrutura dos certificados, para falar com segurança com os desenvolvedores sobre pinning e configuração de segurança de rede. E não deixe de dominar a parte iOS: comandos que testam os dois clientes valorizam profissionais que se sentem igualmente confiantes nas duas plataformas. Você vai conseguir — já fez o mais difícil.