Rendimiento de Apps Nativas (solo CLI)
Objetivo: grabar el Time Profiler mediante xctrace, extraer muestras, simbolizar y proponer puntos calientes sin abrir Instruments.
Inicio rápido (CLI)
- Grabar Time Profiler (adjuntar):
# Inicia la app tú mismo, luego adjunta
xcrun xctrace record --template 'Time Profiler' --time-limit 90s --output /tmp/App.trace --attach <pid>
- Grabar Time Profiler (lanzar):
xcrun xctrace record --template 'Time Profiler' --time-limit 90s --output /tmp/App.trace --launch -- /path/App.app/Contents/MacOS/App
- Extraer muestras de tiempo:
scripts/extract_time_samples.py --trace /tmp/App.trace --output /tmp/time-sample.xml
- Obtener la dirección de carga para simbolizar:
# Mientras la app está en ejecución
vmmap <pid> | rg -m1 "__TEXT" -n
- Simbolizar + clasificar puntos calientes:
scripts/top_hotspots.py --samples /tmp/time-sample.xml \
--binary /path/App.app/Contents/MacOS/App \
--load-address 0x100000000 --top 30
Notas de flujo de trabajo
- Siempre confirma que estás perfilando el binario correcto (compilación local vs /Applications). Prefiere la ruta directa del binario para
--launch. - Asegúrate de activar la ruta lenta durante la captura (abrir/cerrar menú, refrescar, etc.).
- Si las pilas están vacías, captura por más tiempo o evita secciones inactivas.
xcrun xctrace help recordyxcrun xctrace help exportmuestran las banderas correctas.
Scripts incluidos
scripts/record_time_profiler.sh: grabar mediante adjuntar o lanzar.scripts/extract_time_samples.py: exportar XML de muestras de tiempo desde una traza.scripts/top_hotspots.py: simbolizar y clasificar los frames principales de la app.
Problemas comunes
- ASLR significa que debes usar la dirección de carga
__TEXTen tiempo de ejecución devmmap. - Si usas una nueva compilación, actualiza la ruta
--binary; los símbolos deben coincidir con la traza. - Flujo solo CLI: no es necesario abrir Instruments si las pilas se simbolizan mediante
atos.