Desempenho de App Nativo (apenas CLI)
Objetivo: gravar o Time Profiler via xctrace, extrair amostras, simbolizar e propor hotspots sem abrir o Instruments.
Início rápido (CLI)
- Gravar Time Profiler (anexar):
# Inicie o app você mesmo, depois anexe
xcrun xctrace record --template 'Time Profiler' --time-limit 90s --output /tmp/App.trace --attach <pid>
- Gravar Time Profiler (iniciar):
xcrun xctrace record --template 'Time Profiler' --time-limit 90s --output /tmp/App.trace --launch -- /caminho/App.app/Contents/MacOS/App
- Extrair amostras de tempo:
scripts/extract_time_samples.py --trace /tmp/App.trace --output /tmp/time-sample.xml
- Obter endereço de carga para simbolização:
# Enquanto o app estiver em execução
vmmap <pid> | rg -m1 "__TEXT" -n
- Simbolizar + ranquear hotspots:
scripts/top_hotspots.py --samples /tmp/time-sample.xml \
--binary /caminho/App.app/Contents/MacOS/App \
--load-address 0x100000000 --top 30
Notas de fluxo de trabalho
- Sempre confirme que você está analisando o binário correto (build local vs /Applications). Prefira o caminho direto do binário para
--launch. - Certifique-se de acionar o caminho lento durante a captura (abrir/fechar menu, atualizar, etc.).
- Se as pilhas estiverem vazias, capture por mais tempo ou evite seções ociosas.
xcrun xctrace help recordexcrun xctrace help exportmostram as flags corretas.
Scripts incluídos
scripts/record_time_profiler.sh: gravar via anexar ou iniciar.scripts/extract_time_samples.py: exportar XML de time-sample a partir de um trace.scripts/top_hotspots.py: simbolizar e ranquear os principais frames do app.
Armadilhas
- ASLR significa que você deve usar o endereço de carga
__TEXTem tempo de execução obtido dovmmap. - Se usar uma nova build, atualize o caminho
--binary; os símbolos devem coincidir com o trace. - Fluxo apenas CLI: não há necessidade de abrir o Instruments se as pilhas forem simbolizadas via
atos.