Proxy em QA mobile: emulador, dispositivo real e adb reverse — guia passo a passo
Sumário do artigo
- Introdução: por que o testador precisa do próprio proxy entre o app e o servidor
- Preparação inicial: ferramentas, acessos e requisitos de sistema
- Conceitos básicos: como funciona a interceptação de tráfego
- Passo 1: subindo o proxy de interceptação no computador
- Passo 2: direcionando o tráfego do emulador android para o proxy
- Passo 3: instalando o certificado do proxy e resolvendo o problema de confiança
- Passo 4: conectando o dispositivo real por wi-fi
- Passo 5: port forwarding via adb reverse — proxy por usb sem wi-fi
- Passo 6: interceptando e substituindo o tráfego do ambiente de teste
- Verificação do resultado: checklist final
- Erros típicos e soluções
- Recursos adicionais para testadores avançados
- Faq: dúvidas frequentes sobre configuração de proxy em testes mobile
- Conclusão
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
- 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.
- 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.
- Java não é necessária separadamente: o Android Studio usa o JDK embutido.
- 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
- 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.
- Abra o terminal (no Windows — PowerShell ou Windows Terminal).
- Inicie a versão web com o comando:
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.mitmweb --listen-port 8080 - 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.
- 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
- Baixe o Charles no site oficial, instale e execute. Aparecerá a janela principal com a lista vazia à esquerda e as abas Overview, Contents à direita.
- 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.
- 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.
- 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.
- Windows: no PowerShell execute ipconfig e encontre a linha IPv4 do adaptador ativo Wi-Fi ou Ethernet. Normalmente algo como 192.168.1.45.
- macOS: Ajustes do Sistema → Rede → escolha a conexão ativa, o endereço aparece nos detalhes. Ou no terminal ipconfig getifaddr en0.
- 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.comSe 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
- 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.
- Clique no botão de criar dispositivo (o ícone de mais ou Create Virtual Device).
- Escolha um modelo, por exemplo Pixel 8, e clique em Next.
- 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.
- Na última tela, dê ao dispositivo um nome sem espaços, por exemplo Pixel_8_QA, e clique em Finish.
- 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)
- 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.
- No menu à esquerda escolha Settings, depois a aba Proxy.
- Desmarque a caixa "Use Android Studio HTTP proxy settings".
- Escolha Manual proxy configuration.
- 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.
- No campo Port number digite 8080 (para Charles — 8888).
- 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)
- 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).
- Execute:
Aqui já estamos "dentro" do Android, por isso o computador é indicado pelo endereço 10.0.2.2.adb shell settings put global http_proxy 10.0.2.2:8080 - Verifique se a configuração foi aplicada:
Deve retornar 10.0.2.2:8080.adb shell settings get global http_proxy - 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:8080O 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
- No emulador, abra o navegador Chrome e acesse qualquer site em HTTPS.
- 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
- Confirme que o proxy está ativo no emulador (Passo 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.
- Para o mitmproxy clique no botão Android e baixe o arquivo mitmproxy-ca-cert.cer. Para o Charles o arquivo baixa direto.
- 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".
- 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.
- 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:
- Inicie o emulador pelo terminal com a flag -writable-system.
- Execute adb root, depois adb remount.
- 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).
- 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
- Coloque o APK em uma pasta conveniente.
- Execute adb install -r caminho/para/app-debug.apk. A flag -r reinstala por cima da versão existente, preservando os dados.
- 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
- 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.
- Abra Configurações → Rede e internet → Wi-Fi (na Samsung: Conexões → Wi-Fi).
- 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".
- Expanda "Avançado" ou "Configurações avançadas".
- No item Proxy escolha Manual.
- 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.
- Salve. O celular vai reconectar à rede.
Instalando o certificado no celular
- Abra o Chrome no celular e acesse mitm.it ou chls.pro/ssl. Baixe o certificado.
- 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".
- 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
- 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".
- Volte para Configurações → Sistema → Opções do desenvolvedor (na Samsung — na raiz das Configurações). Ative a chave Depuração USB.
- 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.
- 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
- Confirme que o proxy no computador está rodando e escutando na porta 8080.
- Execute o comando:
O primeiro número é a porta no celular, o segundo é a porta no computador. Em resposta o comando imprime 8080 ou nada — isso é normal.adb reverse tcp:8080 tcp:8080 - Verifique a lista de redirecionamentos ativos:
Deve aparecer uma linha como host-número tcp:8080 tcp:8080.adb reverse --list - 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:8080O 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
- Remova o proxy: adb shell settings put global http_proxy :0 (ou "Nenhum" nas configurações de Wi-Fi).
- Cancele o redirecionamento: adb reverse --remove tcp:8080 ou todos de uma vez: adb reverse --remove-all.
- 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.
- 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.
- 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
- 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.
- 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.
- 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.
- 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.
- 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.
- 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:3000Agora, 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
- Inicie o proxy, o emulador e ative o proxy no emulador.
- Abra o app, faça login, abra qualquer lista de dados.
- Encontre no proxy a requisição que retornou essa lista. Coloque a interceptação na URL dela.
- Atualize a lista no app, na resposta pausada remova metade dos itens, solte.
- 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.