CommunityRecherche & Datenanalysegithub.com

steipete/swiftui-performance-audit

SwiftUI-Leistung überprüfen: Rendering, Scrollen, CPU/Speicher, Updates, Layout, Instruments.

Was ist swiftui-performance-audit?

Dieses Skill führt eine End-to-End-Überprüfung der SwiftUI-View-Performance durch – von der Instrumentierung und Basisermittlung bis zur Ursachenanalyse und konkreten Korrekturmaßnahmen. Es ist nützlich für Entwickler, die SwiftUI-Apps optimieren wollen, sei es durch Code-Reviews oder detaillierte Profiling-Sitzungen mit Instruments. Das Skill unterstützt Plattformen wie Claude Code, Cursor, Codex und andere KI-Assistenten, die Anleitungen zur Fehlerbehebung und Optimierung von SwiftUI-Code geben. Es bietet einen Entscheidungsbaum, der den Benutzer durch verschiedene Phasen führt: Code-First-Review, Profiling-Anleitung, Analyse und Diagnose, Behebung sowie Verifikation. Typische Probleme umfassen View-Invalidierungsstürme durch breite Zustandsänderungen, instabile Identitäten in Listen, schwere Arbeit im `body`-Eigenschaftsblock, Layout-Thrash, große Bilder ohne Downsampling sowie überanimierte Hierarchien. Das Skill enthält außerdem eine Liste häufiger Code-Smells mit konkreten Swift-Beispielen und Korrekturen, etwa teure Formatierer im `body`, Sortier-/Filteroperationen in `ForEach` und Bilddecodierung auf dem Hauptthread. Die Ausgabe umfasst eine Metrik-Tabelle (vorher/nachher), priorisierte Probleme und geschätzte Korrekturaufwände.

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

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

SwiftUI Performance Audit

Quelle: kopiert von @Dimillians Dimillian/Skills (31.12.2025).

Überblick

Überprüfung der SwiftUI-View-Performance von Anfang bis Ende – von Instrumentierung und Basisermittlung bis hin zur Ursachenanalyse und konkreten Korrekturmaßnahmen.

Entscheidungsbaum für den Arbeitsablauf

  • Falls der Benutzer Code bereitstellt, beginnen Sie mit „Code-First-Review“.
  • Falls der Benutzer nur Symptome beschreibt, fragen Sie nach minimalem Code/Kontext und führen Sie dann das „Code-First-Review“ durch.
  • Falls das Code-Review nicht eindeutig ist, gehen Sie zu „Benutzer zum Profiling anleiten“ und bitten Sie um einen Trace oder Screenshots.

1. Code-First-Review

Sammeln:

  • Code der Zielansicht/des Zielfeatures.
  • Datenfluss: Zustand, Umgebung, beobachtbare Modelle.
  • Symptome und Reproduktionsschritte.

Konzentrieren auf:

  • View-Invalidierungsstürme durch breite Zustandsänderungen.
  • Instabile Identität in Listen (id-Wechsel, UUID() pro Renderdurchlauf).
  • Schwere Arbeit in body (Formatierung, Sortierung, Bilddecodierung).
  • Layout-Thrash (tiefe Stapel, GeometryReader, Präferenzketten).
  • Große Bilder ohne Downsampling oder Größenänderung.
  • Überanimierte Hierarchien (implizite Animationen auf großen Bäumen).

Bereitstellen:

  • Wahrscheinliche Ursachen mit Codeverweisen.
  • Vorgeschlagene Korrekturen und Refactorings.
  • Bei Bedarf eine minimale Reproduktion oder Instrumentierungsvorschlag.

2. Benutzer zum Profiling anleiten

Erklären, wie Daten mit Instruments gesammelt werden:

  • Verwenden Sie die SwiftUI-Vorlage in Instruments (Release-Build).
  • Reproduzieren Sie die genaue Interaktion (Scrollen, Navigation, Animation).
  • Erfassen Sie die SwiftUI-Zeitleiste und den Time Profiler.
  • Exportieren Sie die relevanten Spuren und den Aufrufbaum oder erstellen Sie Screenshots davon.

Bitten um:

  • Trace-Export oder Screenshots der SwiftUI-Spuren + Time Profiler-Aufrufbaum.
  • Geräte-/OS-/Build-Konfiguration.

3. Analysieren und Diagnostizieren

Priorisieren wahrscheinlicher SwiftUI-Übeltäter:

  • View-Invalidierungsstürme durch breite Zustandsänderungen.
  • Instabile Identität in Listen (id-Wechsel, UUID() pro Renderdurchlauf).
  • Schwere Arbeit in body (Formatierung, Sortierung, Bilddecodierung).
  • Layout-Thrash (tiefe Stapel, GeometryReader, Präferenzketten).
  • Große Bilder ohne Downsampling oder Größenänderung.
  • Überanimierte Hierarchien (implizite Animationen auf großen Bäumen).

Fassen Sie die Ergebnisse mit Belegen aus Traces/Logs zusammen.

4. Beheben

Gezielte Korrekturen anwenden:

  • Zustandsumfang eingrenzen (@State/@Observable näher an den Leaf-Views).
  • Identitäten für ForEach und Listen stabilisieren.
  • Schwere Arbeit aus body entfernen (vorberechnen, cachen, @State).
  • equatable() oder Wert-Wrapper für teure Teilbäume verwenden.
  • Bilder vor dem Rendern downsampeln.
  • Layout-Komplexität reduzieren oder feste Größen verwenden, wo möglich.

Häufige Code-Smells (und Korrekturen)

Achten Sie während des Code-Reviews auf diese Muster.

Teure Formatierer in body

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

Bevorzugen Sie gecachte Formatierer in einem Modell oder einem dedizierten Helfer:

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

Berechnete Eigenschaften, die schwere Arbeit verrichten

var filtered: [Item] {
    items.filter { $0.isEnabled } // läuft bei jeder body-Auswertung
}

Bevorzugen Sie Vorberechnung oder Caching bei Änderungen:

@State private var filtered: [Item] = []
// filtered aktualisieren, wenn sich Eingaben ändern

Sortieren/ Filtern in body oder ForEach

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

Bevorzugen Sie einmaliges Sortieren vor View-Updates:

let sortedItems = items.sorted(by: sortRule)

Inline-Filtern in ForEach

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

Bevorzugen Sie eine vorgefilterte Sammlung mit stabiler Identität.

Instabile Identität

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

Vermeiden Sie id: \.self bei nicht stabilen Werten; verwenden Sie eine stabile ID.

Bilddecodierung auf dem Hauptthread

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

Bevorzugen Sie Decodierung/Downsampling außerhalb des Hauptthreads und speichern Sie das Ergebnis.

Breite Abhängigkeiten in beobachtbaren Modellen

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

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

Bevorzugen Sie granulare View-Modelle oder zustandsbezogene Elemente, um die Update-Fächerung zu reduzieren.

5. Verifizieren

Bitten Sie den Benutzer, die gleiche Erfassung erneut durchzuführen und mit den Basismetriken zu vergleichen. Fassen Sie die Differenz (CPU, Frame-Drops, Speicherspitze) zusammen, falls vorhanden.

Ausgaben

Bereitstellen:

  • Eine kurze Metriktabelle (vorher/nachher, falls verfügbar).
  • Top-Probleme (geordnet nach Auswirkung).
  • Vorgeschlagene Korrekturen mit geschätztem Aufwand.

Referenzen

Fügen Sie Apple-Dokumentation und WWDC-Ressourcen unter references/ hinzu, sofern sie vom Benutzer bereitgestellt werden.

  • Optimierung der SwiftUI-Leistung mit Instruments: references/optimizing-swiftui-performance-instruments.md
  • Verstehen und Verbessern der SwiftUI-Leistung: references/understanding-improving-swiftui-performance.md
  • Hänger in Ihrer App verstehen: references/understanding-hangs-in-your-app.md
  • SwiftUI-Leistung entschlüsseln (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.

Verwandte Skills