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.appet 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 dexctrace 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
--attachavec un PID connu.
- Correctif : utiliser le chemin direct du binaire ou
- 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é :
xctracepeut 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-profilesont é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 deviceset--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.