Quando depuro um app mobile, acabo com seis ferramentas abertas: o Logcat, a janela do Instruments, os profilers do Android Studio, um proxy como o Charles, um terminal cheio de adb shell e xcrun simctl, e um editor de texto para ler algum banco de dados que puxei do dispositivo. Cada uma conhece uma fatia do que o emulador sabe, e nenhuma conversa com as outras.
Por isso criei o EmuLabZip: um app open source que se conecta aos seus emuladores Android e simuladores iOS em execução e traz tudo isso para uma janela só. Ele é escrito em Rust, vem como app desktop (Tauri + Svelte) e como ferramenta de linha de comando, e nada é instalado no dispositivo.
O que ele faz
Você inicia um emulador ou liga um simulador, e ele aparece. Não há configuração no dispositivo e nada para adicionar ao seu app. A partir daí:
- Logs do logcat e do unified log do iOS em uma única tabela que continua fluida com milhares de linhas por segundo, com filtros por nível, tag, texto, regex e por app.
- Desempenho e memória: CPU, memória, taxa de quadros, frames travados e bateria do app que você escolher, snapshots de memória que você compara por categoria, e heap dumps do Android com um detector de vazamentos embutido.
- Network: um proxy de debug que decifra HTTPS, com mocks, breakpoints, limitação de banda, e decodificação de GraphQL e gRPC.
- Storage: navegue pelos arquivos de um app e abra SQLite, SharedPreferences, property lists, MMKV, Realm e mais, ali mesmo.
-
Crashes: crashes, crashes nativos e ANRs com suas stacks, legíveis quando você fornece o
mapping.txtdo R8, o source map ou o dSYM. - Sessions: grave uma execução inteira (logs, requisições, crashes, vídeo da tela, toques) em um único arquivo que você pode abrir depois, comparar ou coletar no CI.
Por que Rust, e por que sem agente no dispositivo
O EmuLabZip não injeta nada no seu app. Ele usa as interfaces públicas de cada plataforma: no Android, tem um cliente async próprio para o protocolo host do ADB (sem precisar chamar o adb a cada operação), e no iOS controla o xcrun simctl. O código de Android e o de Apple ficam em crates separados, atrás de uma única trait Backend, então o app desktop e a CLI usam exatamente o mesmo código.
Isso também significa que ele continua funcionando quando o Xcode ou o Android Studio atualizam, porque depende de interfaces que eles precisam manter.
Os mesmos dados no terminal
Tudo o que o app mostra também é um comando. Inicie um dispositivo e rode:
emulabzip devices
emulabzip logs
emulabzip mem com.example.app
emulabzip net --har capture.har
emulabzip crashes --app com.example.app
Cada comando imprime tabelas para pessoas e --json para scripts. O mesmo motor roda no CI: emulabzip ci grava uma sessão em volta do seu comando de teste e sai com o mesmo código de saída dele, então o pipeline se comporta como antes e você ganha um arquivo para abrir quando algo falha. Vou escrever sobre isso em um próximo post.
E conversa com assistentes de IA
O EmuLabZip inclui um servidor MCP (emulabzip mcp). Conecte o Claude, o Cursor ou o VS Code e o assistente consegue ler seus logs e crashes, acompanhar o tráfego ao vivo, controlar a tela e gravar uma sessão. Ele não consegue apagar nem reescrever nada, a menos que você inicie o servidor com --allow-writes, e aí cada alteração pede sua confirmação antes. Também vai ter um post sobre isso.
Experimente
O app desktop tem instaladores para macOS, Windows e Linux. A ferramenta de linha de comando se instala com o Cargo:
cargo install --git https://github.com/LuisPeixoto/EmuLabZip emulabzip-cli
Depois inicie um emulador ou simulador e rode emulabzip devices.
- Site e documentação: emulabzip.luispeixoto.dev
- Guia de primeiros passos: emulabzip.luispeixoto.dev/pt/docs/getting-started/
- Código-fonte e releases (MIT): github.com/LuisPeixoto/EmuLabZip
Se algo quebrar ou estiver faltando, me avise em uma issue. É um projeto de uma pessoa só e o roadmap segue o que as pessoas precisam.
Também em inglês: I built an open-source debugging lab for Android emulators and iOS simulators


Top comments (0)