Linha de comando

O comando emulabzip dá os mesmos dados do app desktop, em um terminal ou em um script. É um único binário estático, sem dependências de runtime além de adb e Xcode.

cargo install --git https://github.com/LuisPeixoto/EmuLabZip emulabzip-cli

Arquivos pré-compilados para macOS, Linux e Windows estão anexados a cada release.

Escolhendo um dispositivo#

Todo comando, exceto devices, trabalha com um dispositivo. Quando só um está em execução, ele é usado automaticamente. Caso contrário, passe --device (ou defina EMULABZIP_DEVICE) com um serial do adb, um UDID de simulador, um nome ou parte de um nome:

emulabzip --device pixel info
emulabzip -d "iPhone 17" logs

Comandos#

emulabzip devices#

PLATFORM  NAME       OS                   STATE   ID
Android   Pixel 9    Android 16 (API 36)  online  emulator-5554
iOS       iPhone 17  iOS 26.2             online  F8CE84C1-04D1-4E33-B52B-02B59E8A09C5

--json imprime a lista como JSON. O alias emulabzip ls faz o mesmo.

emulabzip info#

Imprime os mesmos grupos do Overview (dispositivo, software, hardware, tela, bateria, locale). --json imprime um objeto de objetos.

emulabzip apps#

Lista os apps do usuário com sua versão e id de processo. --all adiciona os apps do sistema, --running mantém só os que estão em execução.

emulabzip logs#

Acompanha o log do dispositivo, colorido por nível, até você pressionar Ctrl+C.

emulabzip logs --app com.example.app --level warn
emulabzip logs -g 'skipped \d+ frames' -E
emulabzip logs --json | jq -r 'select(.level == "error") | .message'

emulabzip screenshot#

Salva um PNG da tela. -o, --output <file> escolhe o caminho; por padrão o arquivo recebe o nome do dispositivo e da hora.

emulabzip perf#

Imprime uma linha por amostra: CPU do app e do dispositivo, memória do app e do dispositivo, taxa de quadros, quadros com jank e bateria.

emulabzip mem <app>#

Um detalhamento da memória: PSS por categoria no Android, footprint por região de VM no iOS. Veja Memória.

emulabzip heapdump <app>#

Salva um heap dump .hprof (Android, apps debuggable) ou um grafo de memória .memgraph (iOS). -o escolhe o arquivo. Com --analyze ele também procura vazamentos, veja Encontrando vazamentos.

emulabzip heap analyze <file>#

Procura vazamentos em um .hprof (qualquer plataforma) ou em um .memgraph (em um Mac). --json; --top <n> define quantos objetos e classes listar; --all-heaps olha além do heap do próprio app. Veja Encontrando vazamentos.

emulabzip startup <app>#

Mede quanto tempo o app leva para abrir. -k, --kind cold|warm|hot (padrão cold), -r, --runs <n> (1 a 50, padrão 5), --json. Veja Tempo de abertura do app.

emulabzip energy <app>#

Mede a energia que o app usa enquanto você o usa. -s, --seconds <n> (padrão 30; Ctrl+C lê o que houver), --json. Veja Energia.

emulabzip files <app> [path]#

Lista uma pasta do app. --root escolhe a raiz de armazenamento (data ou external no Android; data, bundle ou group:<id> no iOS); por padrão a primeira legível é usada. Veja Storage.

emulabzip pull <app> <path>#

Copia um arquivo para este computador. -o escolhe o destino.

emulabzip db <app> <path>#

Abre um banco SQLite em modo somente leitura. Sem opções, lista tabelas e views; --table imprime linhas (--limit, --offset); -q, --query executa uma instrução somente leitura. Todos aceitam --json.

emulabzip net#

Executa o proxy, aponta o dispositivo para ele e imprime cada requisição quando ela termina, até Ctrl+C. O dispositivo é restaurado quando ele para, inclusive após um erro. Veja Rede.

Operações GraphQL e métodos e status gRPC são impressos depois de cada requisição.

emulabzip net import <file> [--har <file>] [--json] [--dns] lê uma captura .pcap ou .pcapng e imprime as requisições que ela contém, com as consultas DNS quando pedido. Veja Importando uma captura.

emulabzip layout e emulabzip a11y#

layout imprime as views da tela como uma árvore (--json para tudo, --png <file> para salvar o screenshot tirado junto, --depth <n>, --app <id> para marcar uma tela iOS com o framework do seu app). a11y audita a tela e imprime os resultados; --fail-on note|warning|error sai com 1 quando algo pelo menos tão grave é encontrado. Veja Layout e acessibilidade.

emulabzip frameworks <app>#

Lista os frameworks de UI com os quais o app é construído (Flutter, React Native, Hermes, Jetpack Compose, SwiftUI) e o que os revelou. --json. Veja Por dentro dos frameworks.

emulabzip flutter tree|frames|memory <app>#

Olha dentro de um app Flutter em debug ou profile pelo serviço da VM Dart. --uri <address> informa onde ele escuta quando não está no log; tree tem --depth <n>, frames tem -s, --seconds <n> (padrão 10), memory tem --top <n>. Todos aceitam --json.

emulabzip rn tree|heap|console|state <app>#

Olha dentro de um app de desenvolvimento React Native pelo Metro (--metro <port>, padrão 8081). tree tem --depth <n>, console tem -s, --seconds <n>. state lê Redux, React Query, contextos e stores registrados; --watch acompanha as ações do Redux e imprime o que mudou. Veja Estado do React Native. Todos aceitam --json. O Metro permite que um debugger se conecte por vez.

emulabzip state save|restore|show|diff#

save <app> -o file.ezstate [--external] grava os dados de um app em um arquivo. restore <file> --yes substitui os dados do app por ele, depois de salvar o que está sendo substituído. show <file> diz o que um arquivo contém. diff <a> [b] lista as tabelas, colunas, índices e chaves que mudaram entre dois arquivos, ou entre um e o app agora. Veja Estado do app.

emulabzip edit#

Muda dados no dispositivo: cell (-t <table>, --rowid <n> ou --pk col=value, --set, --text, --null), insert, delete, pref-set <key> <value> [--as type], pref-remove, plist-set <key/path> <value> [--as type], plist-remove e undo <folder>. Cada um recebe o app e o arquivo, e todos exigem --yes. Veja Alterando os dados de um app.

emulabzip avd, sim e snapshot#

avd e sim têm list, options, create <name> --image <id> --model <id>, boot <device> (--headless, --cold, --wipe), shutdown, wipe (erase no sim) e delete. snapshot tem list, save, load e delete para o emulador em execução escolhido com -d. wipe, delete, boot --wipe, snapshot load e snapshot delete exigem --yes. emulabzip devices --all também lista dispositivos que não estão em execução. Veja Dispositivos.

emulabzip audit security <app>#

Procura segredos e dados pessoais no log, nas preferências e nos bancos de dados, HTTP puro e segredos em requisições (--har), as flags debuggable e allowBackup, componentes que outros apps podem alcançar, exceções do App Transport Security e lacunas no privacy manifest. --only manifest,logs,storage,traffic, --json, --fail-on <note|warning|error>. A evidência é cortada para que um segredo nunca seja repetido. Veja Auditoria de segurança.

emulabzip size show|diff#

show <file> detalha um .apk, .aab ou .ipa por tipo, ABI nativa e arquivo dex (--top, --json); com --budget ele confronta o build com a seção [size] do emulabzip.toml (--config, --baseline) e sai com 1 se passar de um limite. diff <before> <after> diz o que mudou (--fail-on-growth <percent>). Veja Tamanho do build.

emulabzip i18n check|sweep#

check procura texto cortado, fora da tela, truncado ou não espelhado na tela como ela está (--rtl, --fail-on). sweep testa em outros idiomas e tamanhos de texto (--locales en-XA,ar-XB, --scales 100,130,200, --app, --fail-on-worse) e restaura o dispositivo. Veja Idioma, tamanho do texto e texto que não cabe.

emulabzip control locale|reset-locale|font-scale|display|reset-display#

Mudam o idioma de um app (Android) ou do simulador (iOS), o tamanho do texto e o tamanho da tela do Android. a11y --simulate <kind> [-o file] mostra a tela como alguém com daltonismo a vê.

emulabzip visual capture|update|compare|list|diff|session#

Baselines da tela, e o que mudou desde então. capture e compare aceitam --status-bar (uma barra limpa 9:41), --dir, --threshold; update exige --yes. compare sai com 1 acima do limite e desenha a diferença. Veja Regressão visual.

emulabzip analytics#

Executa o proxy e imprime os eventos que um app envia para Segment, Amplitude, Mixpanel e Firebase (--service, --port, --no-connect, --json), ou, com --firebase-log, as linhas de debug do Firebase no log do dispositivo. Veja Inspetor de analytics.

emulabzip session e emulabzip ci#

session record -o run.ezsession [--app <id>] [--network] [--screens <s>] [--duration <s>] [--video [<s>]] [--taps] [--replay <file> [--passthrough] [--timing]] grava até Ctrl+C; --video grava a tela em pedaços (30 s por padrão, de 1 a 180), --taps grava os toques, e --replay responde às requisições do app a partir de uma gravação enquanto isso (exige --network). session show <file> [--json | --markdown] resume uma sessão ou a pasta .partial de uma que foi interrompida. session timeline <file> [--lane <name>…] [--json] imprime toques, requisições, problemas de log, quadros lentos, garbage collections, crashes, screenshots e vídeo em um único eixo de tempo, e session video <file> [-o <dir>] grava os pedaços da gravação de tela. ci -o run.ezsession [--app <id>] [--network] [--screens <s>] [--fail-on-crash] [--summary <file>] [--video [<s>]] [--taps] [--replay <file> [--fail-on-miss]] -- <command…> grava em volta de um comando e sai com o código dele. Veja Sessões, Linha do tempo e vídeo da tela, Reproduzindo uma gravação e Modo CI.

emulabzip compare <a> <b>#

Lista o que difere entre dois dispositivos (--all para o que também confere, --json). Veja Comparando dispositivos.

emulabzip crashes e emulabzip crash <id>#

crashes lista o que o dispositivo registrou, do mais novo para o mais antigo, com um id para cada; -a, --app e -k, --kind crash|native|anr restringem a lista. crash mostra um com seu stack e dicas: --all-threads imprime todas as threads, --raw imprime o relatório como o dispositivo o escreveu, e -m, --mapping <file> o lê com um mapping.txt, um source map ou um .dSYM que você indicar, além dos guardados para o app e a versão dele. Ambos aceitam --json. Veja Crashes e Stacks legíveis.

emulabzip mappings e emulabzip symbolicate#

mappings add <app> <version> <file> guarda um mapping.txt, um source map ou um .dSYM para um build (-k, --kind mapping|sourcemap|dsym quando não dá para saber pelo arquivo), mappings list [app] [--json] mostra o que está guardado, e mappings remove <app> <version> [-k <kind>] o esquece. symbolicate <stack.txt|-> -m <file> lê um stack que você colou, de um arquivo ou da entrada padrão. Veja Stacks legíveis.

emulabzip report#

Grava o que um relatório de bug precisa em um único arquivo HTML: [--session <file>] [-a, --app <id>] [-o <file>] [--title <text>] [--description <text>] [--without screenshot|logs|requests|crashes|video] [--issue github:owner/repo | gitlab:[host/]group/project | jira:site/PROJECTID/ISSUETYPEID] [--open]. Com --issue ele imprime um link que abre a issue com um resumo preenchido, e --open a abre no navegador. Veja Relatórios de bug.

emulabzip control#

Muda o dispositivo. Veja Controls.

emulabzip webview#

As páginas dentro de uma WebView de um app, ou no Chrome, em um dispositivo Android. Veja Páginas web em apps.

Cada um aceita --app <package>, --socket <name> e --page <id or part of its address> para dizer qual página, e --json.

emulabzip flow#

Grava toques em um fluxo, o reproduz e o exporta. Veja Entrada e fluxos.

emulabzip link#

Abre um deep link e verifica se o domínio e o app concordam sobre ele. Veja Deep links.

emulabzip openapi check#

openapi check --spec <file> --har <file> [--json] verifica cada resposta de um arquivo HAR contra uma descrição OpenAPI 3, e sai com erro quando uma não confere. Veja Regras de rede.

emulabzip script#

Aprova os scripts WebAssembly que as regras executam. script show <file>, script approve <file>, script revoke <file or hash> e script list. Veja Scripts de regras.

emulabzip plugin#

Executa seus próprios coletores. Veja Plugins.

emulabzip mcp [--allow-writes [--no-confirm]]#

Serve os dispositivos a um assistente de IA por MCP na entrada e saída padrão. Veja Servidor MCP e a referência do MCP.

emulabzip trace#

Grava e analisa traces. Veja Traces. Ctrl+C durante uma gravação a interrompe mais cedo e mantém o que foi gravado.

summary e query baixam o trace processor na primeira vez (veja Traces).

emulabzip ca install#

Faz o dispositivo confiar no certificado: o repositório do sistema em um emulador Android com acesso root, o keychain em um simulador iOS, e, para outros dispositivos Android, copia o arquivo e imprime os passos. emulabzip ca path imprime onde está o arquivo do certificado.

Ambiente#