CommunityPesquisa e Análise de Dadosgithub.com

Perfilamento com Instruments (macOS/iOS)

Perfilamento de desempenho/análise de pilha para aplicativos nativos usando Instruments e xctrace.

O que é iOS)?

Esta skill habilita um agente de IA (como Claude Code ou Cursor) a realizar perfilamento de desempenho e análise de pilha para aplicações nativas macOS e iOS usando a ferramenta Instruments da Apple e sua interface de linha de comando `xctrace`. Ela é essencial para desenvolvedores que precisam identificar gargalos de performance, analisar uso de CPU, e entender o fluxo de execução de seus apps. A skill suporta tanto o lançamento de um aplicativo já instrumentado quanto a anexação a um processo em execução, e fornece orientações detalhadas sobre como escolher o binário correto, evitando a armadilha comum do Instruments perfilando a versão instalada do aplicativo em vez da build local. Inclui comandos CLI para captura de traces, exportação de dados brutos para processamento em scripts (Python/Rust), e dicas para a interface gráfica do Instruments, além de notas específicas para iOS e verificações de pós-perfilamento para garantir a acurácia dos dados coletados.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/instruments-profiling

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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.app e 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 de xctrace 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 --attach com um PID conhecido.
  • 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: xctrace pode 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-profile sã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 devices e --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.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

Habilidades Relacionadas