Native App Performance (nur CLI)
Ziel: Time Profiler mittels xctrace aufzeichnen, Samples extrahieren, symbolisieren und Hotspots vorschlagen, ohne Instruments zu öffnen.
Schnellstart (CLI)
- Time Profiler aufzeichnen (Anhängen):
# App selbst starten, dann anhängen
xcrun xctrace record --template 'Time Profiler' --time-limit 90s --output /tmp/App.trace --attach <pid>
- Time Profiler aufzeichnen (Starten):
xcrun xctrace record --template 'Time Profiler' --time-limit 90s --output /tmp/App.trace --launch -- /pfad/App.app/Contents/MacOS/App
- Zeit-Samples extrahieren:
scripts/extract_time_samples.py --trace /tmp/App.trace --output /tmp/time-sample.xml
- Ladeadresse für Symbolisierung ermitteln:
# Während die App läuft
vmmap <pid> | rg -m1 "__TEXT" -n
- Symbolisieren + Hotspots sortieren:
scripts/top_hotspots.py --samples /tmp/time-sample.xml \
--binary /pfad/App.app/Contents/MacOS/App \
--load-address 0x100000000 --top 30
Workflow-Hinweise
- Stets bestätigen, dass das richtige Binary profiliert wird (lokaler Build vs. /Applications). Für
--launchden direkten Binary-Pfad bevorzugen. - Während der Aufzeichnung den langsamen Pfad auslösen (Menü öffnen/schließen, Refresh usw.).
- Wenn die Stapel leer sind, länger aufzeichnen oder Leerlaufabschnitte vermeiden.
xcrun xctrace help recordundxcrun xctrace help exportzeigen die korrekten Flags.
Enthaltene Skripte
scripts/record_time_profiler.sh: Aufzeichnung per Anhängen oder Starten.scripts/extract_time_samples.py: Exportiert time-sample-XML aus einem Trace.scripts/top_hotspots.py: Symbolisiert und sortiert die wichtigsten App-Frames.
Fallstricke
- ASLR bedeutet, dass die Laufzeit-
__TEXT-Ladeadresse ausvmmapverwendet werden muss. - Bei Verwendung eines neuen Builds muss der
--binary-Pfad aktualisiert werden; die Symbole müssen zum Trace passen. - Nur-CLI-Ablauf: Kein Öffnen von Instruments erforderlich, wenn die Stapel über
atossymbolisiert werden.