steipete/swiftui-performance-audit

Audit des performances SwiftUI : rendu, défilement, CPU/mémoire, mises à jour, disposition, Instruments.

Qu'est-ce que swiftui-performance-audit ?

Ce skill permet d'auditer de bout en bout les performances des vues SwiftUI, depuis l'instrumentation et l'établissement de références jusqu'à l'analyse des causes racines et les correctifs concrets. Il est particulièrement utile pour les développeurs qui rencontrent des problèmes de performances dans leurs applications iOS et macOS, en les guidant à travers des workflows structurés : examen du code, profilage avec Instruments, diagnostic des goulots d'étranglement courants (tempêtes d'invalidation de vues, identité instable dans les listes, travail lourd dans `body`, décodage d'images sur le thread principal, etc.), et application de remédiations ciblées. Compatible avec tous les projets SwiftUI, il contient des listes de contrôle pour les odeurs de code fréquentes, avec des exemples de code avant/après, et des références aux sessions WWDC et à la documentation Apple.

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

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

Audit des Performances SwiftUI

Attribution : copié depuis Dimillian/Skills de @Dimillian (2025-12-31).

Aperçu

Auditer les performances des vues SwiftUI de bout en bout, de l'instrumentation et de l'établissement de références à l'analyse des causes racines et aux étapes de correction concrètes.

Arbre de Décision du Workflow

  • Si l'utilisateur fournit du code, commencez par « Examen centré sur le code. »
  • Si l'utilisateur décrit uniquement des symptômes, demandez du code minimal/du contexte, puis effectuez « Examen centré sur le code. »
  • Si l'examen du code n'est pas concluant, passez à « Guider l'utilisateur vers le profilage » et demandez une trace ou des captures d'écran.

1. Examen centré sur le code

Collectez :

  • Code de la vue/fonctionnalité cible.
  • Flux de données : état, environnement, modèles observables.
  • Symptômes et étapes de reproduction.

Concentrez-vous sur :

  • Tempêtes d'invalidation de vues dues à des changements d'état larges.
  • Identité instable dans les listes (changement d'id, UUID() par rendu).
  • Travail lourd dans body (formatage, tri, décodage d'images).
  • Brassage de disposition (piles profondes, GeometryReader, chaînes de préférences).
  • Grandes images sans sous-échantillonnage ni redimensionnement.
  • Hiérarchies trop animées (animations implicites sur de grands arbres).

Fournissez :

  • Causes racines probables avec références au code.
  • Correctifs et refactorisations suggérés.
  • Si nécessaire, une reproduction minimale ou une suggestion d'instrumentation.

2. Guider l'utilisateur vers le profilage

Expliquez comment collecter des données avec Instruments :

  • Utilisez le modèle SwiftUI dans Instruments (construction Release).
  • Reproduisez l'interaction exacte (défilement, navigation, animation).
  • Capturez la chronologie SwiftUI et le profileur temporel.
  • Exportez ou capturez les pistes pertinentes et l'arborescence d'appels.

Demandez :

  • Export de trace ou captures d'écran des pistes SwiftUI + arborescence d'appels du profileur temporel.
  • Configuration de l'appareil/OS/construction.

3. Analyser et Diagnostiquer

Hiérarchisez les coupables SwiftUI probables :

  • Tempêtes d'invalidation de vues dues à des changements d'état larges.
  • Identité instable dans les listes (changement d'id, UUID() par rendu).
  • Travail lourd dans body (formatage, tri, décodage d'images).
  • Brassage de disposition (piles profondes, GeometryReader, chaînes de préférences).
  • Grandes images sans sous-échantillonnage ni redimensionnement.
  • Hiérarchies trop animées (animations implicites sur de grands arbres).

Résumez les résultats avec des preuves issues des traces/logs.

4. Corriger

Appliquez des correctifs ciblés :

  • Réduisez la portée de l'état (@State/@Observable plus proche des vues feuilles).
  • Stabilisez les identités pour ForEach et les listes.
  • Déplacez le travail lourd hors de body (précalcul, cache, @State).
  • Utilisez equatable() ou des wrappers de valeur pour les sous-arbres coûteux.
  • Sous-échantillonnez les images avant le rendu.
  • Réduisez la complexité de la disposition ou utilisez un dimensionnement fixe lorsque c'est possible.

Odeurs de Code Courantes (et Correctifs)

Recherchez ces modèles lors de l'examen du code.

Formateurs coûteux dans body

var body: some View {
    let number = NumberFormatter() // allocation lente
    let measure = MeasurementFormatter() // allocation lente
    Text(measure.string(from: .init(value: meters, unit: .meters)))
}

Préférez des formateurs mis en cache dans un modèle ou un helper dédié :

final class DistanceFormatter {
    static let shared = DistanceFormatter()
    let number = NumberFormatter()
    let measure = MeasurementFormatter()
}

Propriétés calculées effectuant un travail lourd

var filtered: [Item] {
    items.filter { $0.isEnabled } // s'exécute à chaque évaluation de body
}

Préférez le précalcul ou le cache lors du changement :

@State private var filtered: [Item] = []
// mettre à jour filtered lorsque les entrées changent

Tri/filtrage dans body ou ForEach

List {
    ForEach(items.sorted(by: sortRule)) { item in
        Row(item)
    }
}

Préférez trier une fois avant les mises à jour de la vue :

let sortedItems = items.sorted(by: sortRule)

Filtrage en ligne dans ForEach

ForEach(items.filter { $0.isEnabled }) { item in
    Row(item)
}

Préférez une collection préfiltrée avec une identité stable.

Identité instable

ForEach(items, id: \.self) { item in
    Row(item)
}

Évitez id: \.self pour des valeurs non stables ; utilisez un ID stable.

Décodage d'image sur le thread principal

Image(uiImage: UIImage(data: data)!)

Préférez décoder/sous-échantillonner hors du thread principal et stocker le résultat.

Dépendances larges dans les modèles observables

@Observable class Model {
    var items: [Item] = []
}

var body: some View {
    Row(isFavorite: model.items.contains(item))
}

Préférez des modèles de vue granulaires ou un état par élément pour réduire la propagation des mises à jour.

5. Vérifier

Demandez à l'utilisateur de relancer la même capture et de comparer avec les métriques de base. Résumez le delta (CPU, chutes d'images, pic de mémoire) si fourni.

Résultats

Fournissez :

  • Un court tableau de métriques (avant/après si disponible).
  • Principaux problèmes (classés par impact).
  • Correctifs proposés avec estimation de l'effort.

Références

Ajoutez la documentation Apple et les ressources WWDC sous references/ lorsqu'elles sont fournies par l'utilisateur.

  • Optimisation des performances SwiftUI avec Instruments : references/optimizing-swiftui-performance-instruments.md
  • Comprendre et améliorer les performances SwiftUI : references/understanding-improving-swiftui-performance.md
  • Comprendre les blocages dans votre application : references/understanding-hangs-in-your-app.md
  • Démystifier les performances SwiftUI (WWDC23) : references/demystify-swiftui-performance-wwdc23.md

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.

Skills associés