O que iOS) faz?
Use esta skill quando o usuário precisar de perfilamento de desempenho ou análise de pilha para aplicativos nativos.
Foco: Time Profiler, CLI xctrace e seleção correta do binário/instância do aplicativo.
Início Rápido (CLI)
- Listar templates:
xcrun xctrace list templates - Gravar Time Profiler (lançamento):
xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --launch -- /path/To/App.app
- Gravar Time Profiler (anexar):
- Inicie o aplicativo você mesmo, obtenha o PID, então:
xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --attach <pid>
- Abrir trace no Instruments:
open -a Instruments /tmp/App.trace
Nota: xcrun xctrace --help não é um subcomando válido. Use xcrun xctrace help record.
Selecionando o Binário Correto (Crítico)
Atenção: o Instruments pode perfilar o aplicativo errado (ex.: um em /Applications) se o LaunchServices resolver um bundle diferente.
Use estas regras:
- Prefira o caminho direto do binário para lançamento determinístico:
xcrun xctrace record ... --launch -- /path/App.app/Contents/MacOS/App
- Se for lançar
.app, verifique se é o bundle pretendido:open -n /path/App.app- Confirme com
ps -p <pid> -o comm= -o command=
- Se ambos
/Applications/App.appe uma build local existirem, tenha como alvo explícito o caminho da build local. - Após o lançamento, confirme o caminho do processo antes de confiar no trace.
Argumentos de Comando (xctrace)
--template 'Time Profiler': nome do template dexctrace list templates.--launch -- <cmd>: tudo após--é o comando alvo (binário ou bundle do app).--attach <pid|name>: anexar a um processo em execução.--output <path>: saída.trace. Se omitido, o arquivo é salvo no diretório atual.--time-limit 60s|5m: definir duração da captura.--device <name|UDID>: obrigatório para execuções em dispositivos iOS.--target-stdout -: transmite a saída padrão do processo lançado para o terminal (útil para ferramentas CLI).
Exportando Pilhas (CLI)
- Inspecionar tabelas do trace:
xcrun xctrace export --input /tmp/App.trace --toc
- Exportar amostras brutas do time-profile:
xcrun xctrace export --input /tmp/App.trace --xpath '/trace-toc/run[@number="1"]/data/table[@schema="time-profile"]' --output /tmp/time-profile.xml
- Pós-processar em um script (Python/Rust) para agregar pilhas.
Fluxo de Trabalho na Interface do Instruments
- Template: Time Profiler
- Use “Record” e capture o caminho lento (inicialização vs estado estável)
- Dicas da Call Tree:
- Ocultar Bibliotecas do Sistema
- Inverter Call Tree
- Separar por Thread
- Foco em frames quentes e contagens de chamadas
Armadilhas e Correções
- Aplicativo errado perfilado: o LaunchServices resolve o aplicativo instalado em vez da build local.
- Correção: use o caminho direto do binário ou
--attachcom um PID conhecido.
- Correção: use o caminho direto do binário ou
- Nenhuma amostra / trace vazio: o aplicativo sai rapidamente ou nunca executa o trabalho.
- Correção: captura mais longa, dispare a carga de trabalho durante a gravação.
- Solicitações de privacidade:
xctracepode precisar de permissão de Ferramentas do Desenvolvedor.- Correção: Ajustes do Sistema → Privacidade e Segurança → Ferramentas do Desenvolvedor → permitir Terminal/Xcode.
- Exportações XML grandes: exportações de
time-profilesão enormes.- Correção: filtre com XPath e agregue offline; não imprima no terminal.
Notas Específicas para iOS
- Dispositivo: use
xcrun xctrace list devicese--device <UDID>. - Lance pelo Xcode se necessário; anexe com
xctrace --attach. - Certifique-se de ter símbolos de depuração para pilhas significativas.
Lista de Verificação
- Confirme que o caminho do processo no trace corresponde à build alvo.
- Confirme que as pilhas mostram frames esperados do aplicativo.
- A captura cobre a operação lenta (inicialização/atualização).
- Exporte pilhas para diff automatizado se estiver otimizando.