Perfilamiento con Instruments (macOS/iOS)
Usa este skill cuando el usuario necesite perfilamiento de rendimiento o análisis de pilas para aplicaciones nativas.
Enfoque: Time Profiler, xctrace CLI y seleccionar la instancia correcta de binario/aplicación.
Inicio Rápido (CLI)
- Listar plantillas:
xcrun xctrace list templates - Grabar Time Profiler (lanzamiento):
xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --launch -- /ruta/App.app
- Grabar Time Profiler (adjuntar):
- Lanza la aplicación tú mismo, obtén el PID, luego:
xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --attach <pid>
- Abrir traza en Instruments:
open -a Instruments /tmp/App.trace
Nota: xcrun xctrace --help no es un subcomando válido. Usa xcrun xctrace help record.
Seleccionar el Binario Correcto (Crítico)
Problema común: Instruments puede perfilar la aplicación equivocada (por ejemplo, una en /Applications) si LaunchServices resuelve un paquete diferente.
Usa estas reglas:
- Prefiere la ruta directa al binario para un lanzamiento determinista:
xcrun xctrace record ... --launch -- /ruta/App.app/Contents/MacOS/App
- Si lanzas
.app, asegúrate de que sea el paquete correcto:open -n /ruta/App.app- Verifica con
ps -p <pid> -o comm= -o command=
- Si existen tanto
/Applications/App.appcomo una compilación local, apunta explícitamente a la ruta de compilación local. - Después del lanzamiento, confirma la ruta del proceso antes de confiar en la traza.
Argumentos de Comando (xctrace)
--template 'Time Profiler': nombre de la plantilla tomado dexctrace list templates.--launch -- <comando>: todo después de--es el comando objetivo (binario o paquete de app).--attach <pid|nombre>: adjuntarse a un proceso en ejecución.--output <ruta>: salida.trace. Si se omite, el archivo se guarda en el directorio de trabajo actual.--time-limit 60s|5m: establecer duración de captura.--device <nombre|UDID>: requerido para ejecuciones en dispositivos iOS.--target-stdout -: transmite la salida estándar del proceso lanzado al terminal (útil para herramientas CLI).
Exportación de Pilas (CLI)
- Inspeccionar tablas de la traza:
xcrun xctrace export --input /tmp/App.trace --toc
- Exportar muestras sin procesar de 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
- Postprocesar en un script (Python/Rust) para agregar pilas.
Flujo de Trabajo en la Interfaz de Instruments
- Plantilla: Time Profiler
- Usa “Record” y captura la ruta lenta (inicio vs estado estable)
- Consejos de Call Tree:
- Ocultar Bibliotecas del Sistema
- Invertir Call Tree
- Separar por Hilo
- Enfocarse en marcos calientes y recuentos de llamadas
Problemas Comunes y Soluciones
- Aplicación equivocada perfilada: LaunchServices resuelve la aplicación instalada en lugar de la compilación local.
- Solución: usa la ruta directa al binario o
--attachcon un PID conocido.
- Solución: usa la ruta directa al binario o
- Sin muestras / traza vacía: La aplicación sale rápidamente o nunca ejecuta la carga de trabajo.
- Solución: captura más larga, dispara la carga de trabajo durante la grabación.
- Solicitudes de privacidad:
xctracepuede necesitar permiso de Herramientas de Desarrollo.- Solución: Configuración del Sistema → Privacidad y Seguridad → Herramientas de Desarrollo → permitir Terminal/Xcode.
- Exportaciones XML grandes: las exportaciones de
time-profileson enormes.- Solución: filtrar con XPath y agregar sin conexión; no imprimir en el terminal.
Notas Específicas de iOS
- Dispositivo: usa
xcrun xctrace list devicesy--device <UDID>. - Lanza mediante Xcode si es necesario; adjunta con
xctrace --attach. - Asegura símbolos de depuración para pilas significativas.
Lista de Verificación
- Confirmar que la ruta del proceso en la traza coincida con la compilación objetivo.
- Confirmar que las pilas muestren los marcos de aplicación esperados.
- La captura cubre la operación lenta (inicio/actualización).
- Exportar pilas para diferenciación automatizada si se está optimizando.