CommunityRecherche & Datenanalysegithub.com

steipete/native-app-performance

Native App Performance: xctrace, Time Profiler, Traces, Hotspots.

Was ist native-app-performance?

Diese Fertigkeit ermöglicht es dir, die Leistung nativer macOS-Apps über die Kommandozeile zu analysieren, ohne die Instruments-GUI öffnen zu müssen. Sie nutzt `xctrace`, um Time-Profiler-Aufzeichnungen zu starten, extrahiert die Sample-Daten in XML und symbolisiert die Aufrufstapel, um die heißesten Code-Pfade zu identifizieren. Die Fertigkeit ist besonders nützlich für Entwickler, die schnell Leistungsengpässe in ihren Builds lokalisieren möchten. Sie stellt drei Skripte bereit: `record_time_profiler.sh` für die Aufzeichnung, `extract_time_samples.py` für den Export und `top_hotspots.py` für die Symbolisierung und Rangfolge der wichtigsten App-Frames. Wichtig ist die Verwendung der Laufzeit-`__TEXT`-Ladresse (`vmmap`) für die Symbolisierung sowie die Sicherstellung, dass die langsame Aktion während der Aufzeichnung ausgeführt wird.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/native-app-performance

Installed? Explore more Recherche & Datenanalyse skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Native App Performance (nur CLI)

Ziel: Time Profiler mittels xctrace aufzeichnen, Samples extrahieren, symbolisieren und Hotspots vorschlagen, ohne Instruments zu öffnen.

Schnellstart (CLI)

  1. 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>
  1. Time Profiler aufzeichnen (Starten):
xcrun xctrace record --template 'Time Profiler' --time-limit 90s --output /tmp/App.trace --launch -- /pfad/App.app/Contents/MacOS/App
  1. Zeit-Samples extrahieren:
scripts/extract_time_samples.py --trace /tmp/App.trace --output /tmp/time-sample.xml
  1. Ladeadresse für Symbolisierung ermitteln:
# Während die App läuft
vmmap <pid> | rg -m1 "__TEXT" -n
  1. 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 --launch den 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 record und xcrun xctrace help export zeigen 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 aus vmmap verwendet 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 atos symbolisiert werden.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Verwandte Skills