steipete/instruments-profiling

Profilage avec Instruments/xctrace : traces macOS/iOS, binaires, arguments, exports.

Qu'est-ce que instruments-profiling ?

Cette compétence est conçue pour les développeurs qui ont besoin de profilage de performance ou d'analyse de pile d'appels pour des applications natives sur macOS et iOS. Elle se concentre sur l'outil Time Profiler, l'interface en ligne de commande `xctrace`, et le choix correct du binaire ou de l'instance d'application. Le résumé explique comment lancer et attacher le profileur, utiliser les arguments clés de `xctrace`, exporter les échantillons de pile pour un post-traitement, et éviter les pièges courants comme le profilage d'une mauvaise application ou l'obtention de traces vides. La compétence supporte à la fois le workflow via Instruments (UI) et via la ligne de commande, et inclut des notes spécifiques pour les appareils iOS. Elle est utile pour toute optimisation de code natif sur les plateformes Apple.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/instruments-profiling

Installed? Explore more Recherche et analyse de données skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Profilage avec Instruments (macOS/iOS)

Utilisez cette compétence lorsque l'utilisateur souhaite un profilage de performance ou une analyse de pile pour des applications natives. Focus : Time Profiler, CLI xctrace, et choix correct du binaire/instance d'application.

Démarrage rapide (CLI)

  • Lister les modèles : xcrun xctrace list templates
  • Enregistrer Time Profiler (lancement) :
    • xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --launch -- /chemin/vers/App.app
  • Enregistrer Time Profiler (attachement) :
    • Lancez l'application vous-même, récupérez le PID, puis :
    • xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --attach <pid>
  • Ouvrir la trace dans Instruments :
    • open -a Instruments /tmp/App.trace

Remarque : xcrun xctrace --help n'est pas une sous-commande valide. Utilisez xcrun xctrace help record.

Choisir le bon binaire (Critique)

Piège : Instruments peut profiler la mauvaise application (par exemple, une dans /Applications) si LaunchServices résout un bundle différent. Utilisez ces règles :

  • Préférez le chemin direct du binaire pour un lancement déterministe :
    • xcrun xctrace record ... --launch -- /chemin/App.app/Contents/MacOS/App
  • Si vous lancez un .app, assurez-vous qu'il s'agit du bundle voulu :
    • open -n /chemin/App.app
    • Vérifiez avec ps -p <pid> -o comm= -o command=
  • Si /Applications/App.app et une version locale existent tous les deux, ciblez explicitement le chemin de la version locale.
  • Après le lancement, confirmez le chemin du processus avant de faire confiance à la trace.

Arguments de la commande (xctrace)

  • --template 'Time Profiler' : nom du modèle provenant de xctrace list templates.
  • --launch -- <cmd> : tout ce qui suit -- est la commande cible (binaire ou bundle d'application).
  • --attach <pid|name> : s'attacher à un processus en cours d'exécution.
  • --output <path> : sortie .trace. Si omis, le fichier est enregistré dans le répertoire de travail courant.
  • --time-limit 60s|5m : définir la durée de capture.
  • --device <name|UDID> : requis pour les exécutions sur appareil iOS.
  • --target-stdout - : diffuser la sortie standard du processus lancé vers le terminal (utile pour les outils CLI).

Exportation des piles (CLI)

  • Inspecter les tables de trace :
    • xcrun xctrace export --input /tmp/App.trace --toc
  • Exporter les échantillons bruts du Time Profiler :
    • xcrun xctrace export --input /tmp/App.trace --xpath '/trace-toc/run[@number="1"]/data/table[@schema="time-profile"]' --output /tmp/time-profile.xml
  • Post-traiter dans un script (Python/Rust) pour agréger les piles.

Workflow de l'interface Utilisateur d'Instruments

  • Modèle : Time Profiler
  • Utilisez « Enregistrer » et capturez le chemin lent (démarrage vs état stable)
  • Astuces de l'arborescence d'appels :
    • Masquer les bibliothèques système
    • Inverser l'arborescence d'appels
    • Séparer par thread
    • Se concentrer sur les images chaudes et les compteurs d'appels

Pièges et Correctifs

  • Mauvaise application profilée : LaunchServices résout l'application installée au lieu de la version locale.
    • Correctif : utiliser le chemin direct du binaire ou --attach avec un PID connu.
  • Aucun échantillon / trace vide : L'application se ferme rapidement ou n'atteint jamais la charge de travail.
    • Correctif : capture plus longue, déclencher la charge de travail pendant l'enregistrement.
  • Invites de confidentialité : xctrace peut nécessiter une autorisation Outils de développement.
    • Correctif : Réglages système → Confidentialité et sécurité → Outils de développement → autoriser Terminal/Xcode.
  • Exportations XML volumineuses : les exports time-profile sont énormes.
    • Correctif : filtrer avec XPath et agréger hors ligne ; ne pas imprimer dans le terminal.

Notes Spécifiques iOS

  • Appareil : utiliser xcrun xctrace list devices et --device <UDID>.
  • Lancez via Xcode si nécessaire ; attachez avec xctrace --attach.
  • Assurez-vous d'avoir les symboles de débogage pour des piles significatives.

Liste de Vérification

  • Confirmer que le chemin du processus de trace correspond à la version cible.
  • Confirmer que les piles montrent les images attendues de l'application.
  • La capture couvre l'opération lente (démarrage/rafraîchissement).
  • Exporter les piles pour une comparaison automatisée lors de l'optimisation.

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/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.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

Skills associés