Instruments-Profiling (macOS/iOS)
Verwenden Sie dieses Skill, wenn der Nutzer Performance-Profiling oder Stack-Analyse für native Apps wünscht.
Fokus: Time Profiler, xctrace CLI, und die Auswahl der richtigen Binär-/App-Instanz.
Schnellstart (CLI)
- Vorlagen auflisten:
xcrun xctrace list templates - Time Profiler aufzeichnen (starten):
xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --launch -- /path/To/App.app
- Time Profiler aufzeichnen (anhängen):
- App selbst starten, PID ermitteln, dann:
xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --attach <pid>
- Trace in Instruments öffnen:
open -a Instruments /tmp/App.trace
Hinweis: xcrun xctrace --help ist kein gültiger Unterbefehl. Verwenden Sie xcrun xctrace help record.
Die richtige Binärdatei auswählen (entscheidend)
Achtung: Instruments profiliert möglicherweise die falsche App (z. B. eine in /Applications), wenn LaunchServices ein anderes Bundle auflöst.
Beachten Sie diese Regeln:
- Bevorzugen Sie den direkten Binärpfad für deterministisches Starten:
xcrun xctrace record ... --launch -- /path/App.app/Contents/MacOS/App
- Wenn Sie
.appstarten, stellen Sie sicher, dass es das gewünschte Bundle ist:open -n /path/App.app- Überprüfen mit
ps -p <pid> -o comm= -o command=
- Wenn sowohl
/Applications/App.appals auch ein lokaler Build existieren, zielen Sie explizit auf den lokalen Build-Pfad. - Bestätigen Sie nach dem Start den Prozesspfad, bevor Sie dem Trace vertrauen.
Befehlsargumente (xctrace)
--template 'Time Profiler': Vorlagenname ausxctrace list templates.--launch -- <cmd>: Alles nach--ist der Zielbefehl (Binärdatei oder App-Bundle).--attach <pid|name>: An einen laufenden Prozess anhängen.--output <path>:.trace-Ausgabe. Wenn nicht angegeben, wird die Datei im aktuellen Arbeitsverzeichnis gespeichert.--time-limit 60s|5m: Aufzeichnungsdauer festlegen.--device <name|UDID>: Erforderlich für iOS-Geräteausführungen.--target-stdout -: Standardausgabe des gestarteten Prozesses an das Terminal streamen (nützlich für CLI-Tools).
Stacks exportieren (CLI)
- Trace-Tabellen inspizieren:
xcrun xctrace export --input /tmp/App.trace --toc
- Rohdaten des Time-Profils exportieren:
xcrun xctrace export --input /tmp/App.trace --xpath '/trace-toc/run[@number="1"]/data/table[@schema="time-profile"]' --output /tmp/time-profile.xml
- Nachbearbeitung in einem Skript (Python/Rust), um Stacks zu aggregieren.
Instruments-Benutzeroberfläche (Workflow)
- Vorlage: Time Profiler
- „Aufzeichnen“ verwenden und den langsamen Pfad erfassen (Start vs. stationärer Zustand)
- Call-Tree-Tipps:
- Systembibliotheken ausblenden
- Call-Tree invertieren
- Nach Thread trennen
- Fokus auf heiße Frames und Aufrufzahlen
Fallstricke und Lösungen
- Falsche App profiliert: LaunchServices löst die installierte App anstelle des lokalen Builds auf.
- Lösung: den direkten Binärpfad verwenden oder mit
--attachund bekannter PID anhängen.
- Lösung: den direkten Binärpfad verwenden oder mit
- Keine Samples/leerer Trace: App beendet sich schnell oder erreicht nie die Arbeitslast.
- Lösung: längere Aufzeichnung, Arbeitslast während der Aufzeichnung auslösen.
- Datenschutzaufforderungen:
xctracebenötigt möglicherweise die Berechtigung für Entwicklerwerkzeuge.- Lösung: Systemeinstellungen → Datenschutz & Sicherheit → Entwicklerwerkzeuge → Terminal/Xcode erlauben.
- Große XML-Exporte:
time-profile-Exporte sind sehr groß.- Lösung: mit XPath filtern und offline aggregieren; nicht im Terminal ausgeben.
iOS-spezifische Hinweise
- Gerät:
xcrun xctrace list devicesund--device <UDID>verwenden. - Bei Bedarf über Xcode starten; mit
xctrace --attachanhängen. - Debugsymbole für aussagekräftige Stacks sicherstellen.
Verifikations-Checkliste
- Den Trace-Prozesspfad mit dem Ziel-Build abgleichen.
- Sicherstellen, dass die Stacks die erwarteten App-Frames zeigen.
- Die Aufzeichnung sollte die langsame Operation (Start/Aktualisierung) abdecken.
- Stacks für automatisierte Differenzprüfung exportieren, wenn optimiert wird.