Communitygithub.com

ComeOnOliver/skillshub

Úsalo cuando la UI sea lenta, el desplazamiento se retrase, las animaciones se entrecorten, o cuando preguntes 'por qué mi vista SwiftUI es lenta', 'cómo optimizar el rendimiento de List', 'mi app pierde fotogramas', 'el body de la vista se llama demasiado', 'List va con retraso' - optimización de rendimiento SwiftUI con Instruments 26 y patrones de la WWDC 2025.

¿Qué es skillshub?

Este skill está diseñado para ayudar a desarrolladores a diagnosticar y solucionar problemas de rendimiento en aplicaciones SwiftUI. Proporciona un enfoque estructurado para identificar cuellos de botella comunes, como actualizaciones largas del body de las vistas o actualizaciones innecesarias. El skill se basa en las nuevas herramientas de profiling de Xcode 26, incluyendo el instrumento SwiftUI mejorado que ofrece un timeline visual con códigos de color (rojo/naranja) para priorizar problemas, y el gráfico de Causa y Efecto que rastrea el flujo de datos en la aplicación. Cubre patrones clave de optimización presentados en la WWDC 2025, como mejoras automáticas en el rendimiento de Listas (6x más rápidas en carga, 16x en actualizaciones), reducción de fotogramas perdidos durante el desplazamiento y optimización de ScrollViews anidados con stacks perezosos. Además, incluye ejemplos prácticos de código para identificar y resolver operaciones costosas como la creación de formateadores en el body de las vistas, y proporciona un árbol de decisión para priorizar optimizaciones. Está dirigido a desarrolladores que buscan comprender la causa raíz de los problemas de rendimiento en SwiftUI y aplicar las mejores prácticas de la WWDC 2025.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/CharlesWiltgen/Axiom/axiom-swiftui-performance

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Optimización de Rendimiento SwiftUI

Cuándo Usar Este Skill

Úsalo cuando:

  • La app se sienta menos receptiva (tirones, bloqueos, desplazamiento retrasado)
  • Las animaciones se pausen o salten durante la ejecución
  • El rendimiento del desplazamiento sea pobre
  • El perfilado revele que SwiftUI es el cuello de botella
  • Los bodies de las vistas estén tardando demasiado en ejecutarse
  • Las vistas se estén actualizando con más frecuencia de la necesaria
  • Necesites entender la causa y el efecto de las actualizaciones de SwiftUI

Ejemplos de Prompts

Estas son preguntas reales que los desarrolladores hacen y que este skill está diseñado para responder:

1. "Mi app tiene un desplazamiento entrecortado y las animaciones se traban. ¿Cómo averiguo si SwiftUI es la causa?"

→ El skill muestra cómo usar el nuevo instrumento SwiftUI en Instruments 26 para identificar si SwiftUI es el cuello de botella frente a otras capas.

2. "Estoy usando el nuevo instrumento SwiftUI y veo barras naranjas/rojas que muestran actualizaciones largas. ¿Cómo sé qué las está causando?"

→ El skill cubre los patrones del Gráfico de Causa y Efecto que muestran el flujo de datos a través de tu app y qué cambios de estado desencadenan actualizaciones costosas.

3. "Algunas vistas se están actualizando con demasiada frecuencia aunque sus datos no han cambiado. ¿Cómo encuentro qué vistas son el problema?"

→ El skill demuestra la detección de actualizaciones innecesarias y la resolución de problemas de Identidad con el timeline visual.

4. "Tengo estructuras de datos grandes y jerarquías de vistas complejas. ¿Cómo las optimizo para el rendimiento de SwiftUI?"

→ El skill cubre patrones de rendimiento: desglose de jerarquías de vistas, minimización de la complejidad del body y uso de la lista de verificación de optimización @Sendable.

5. "Tenemos una fecha límite de rendimiento y necesito entender qué es lento en SwiftUI. ¿Cuáles son las métricas críticas?"

→ El skill proporciona el árbol de decisión para priorizar optimizaciones y comprender escenarios de presión con orientación profesional para compensaciones.


Resumen

Principio fundamental: Asegúrate de que los bodies de tus vistas se actualicen rápidamente y solo cuando sea necesario para lograr un gran rendimiento en SwiftUI.

NUEVO en la WWDC 2025: El instrumento SwiftUI de nueva generación en Instruments 26 proporciona un análisis de rendimiento completo con:

  • Timeline visual de actualizaciones largas (codificado por colores naranja/rojo según la gravedad)
  • Gráfico de Causa y Efecto que muestra el flujo de datos a través de tu app
  • Integración con el Time Profiler para análisis de CPU
  • Seguimiento de Bloqueos y Tirones (Hangs and Hitches)

Problemas de Rendimiento Clave:

  1. Actualizaciones Largas del Body de la Vista — Los bodies de las vistas tardan demasiado en ejecutarse.
  2. Actualizaciones de Vista Innecesarias — Las vistas se actualizan cuando los datos no han cambiado realmente.

Mejoras de Rendimiento del Framework iOS 26

"Las mejoras de rendimiento en el framework benefician a las aplicaciones en todas las plataformas de Apple, desde nuestra app hasta la tuya." — WWDC 2025-256

SwiftUI en iOS 26 incluye importantes mejoras de rendimiento que benefician a todas las aplicaciones automáticamente. Estas mejoras funcionan junto con las nuevas herramientas de perfilado para hacer que SwiftUI sea más rápido desde el primer momento.

Rendimiento de List (Enfoque macOS)

Grandes ganancias para listas grandes

  • Carga 6 veces más rápida para listas de 100,000+ elementos en macOS
  • Actualizaciones 16 veces más rápidas para listas grandes
  • Ganancias aún mayores para listas más grandes
  • Las mejoras benefician a todas las plataformas (iOS, iPadOS, watchOS, no solo macOS)
List(trips) { trip in // 100k+ elementos
    TripRow(trip: trip)
}
// iOS 26: Carga 6 veces más rápida, actualizaciones 16 veces más rápidas en macOS
// Todas las plataformas se benefician de las mejoras de rendimiento

Impacto en tu app

  • Los conjuntos de datos grandes (10k+ elementos) ven mejoras notables
  • Las operaciones de filtrado y ordenación se completan más rápido
  • Las actualizaciones en tiempo real de las listas son más receptivas
  • Beneficia a aplicaciones como navegadores de archivos, listas de contactos, tablas de datos

Rendimiento de Desplazamiento

Reducción de fotogramas perdidos durante el desplazamiento a alta velocidad

SwiftUI ha mejorado la planificación de las actualizaciones de la interfaz de usuario en iOS y macOS. Esto mejora la capacidad de respuesta y permite que SwiftUI haga aún más trabajo para preparar los fotogramas futuros. En resumen, reduce la probabilidad de que tu app pierda un fotograma mientras se desplaza rápidamente a altas frecuencias de actualización.

Mejoras clave

  1. Mejor planificación de fotogramas — SwiftUI obtiene más tiempo para preparar los fotogramas futuros.
  2. Capacidad de respuesta mejorada — Las actualizaciones de la UI se planifican de manera más eficiente.
  3. Menos fotogramas perdidos — Especialmente durante el desplazamiento rápido a 120 Hz (ProMotion).

Cuándo lo notarás

  • Desplazamiento a través de contenido con muchas imágenes
  • Dispositivos con alta frecuencia de actualización (iPhone Pro, iPad Pro con ProMotion)
  • Filas de listas complejas con múltiples vistas

ScrollViews Anidados con Stacks Perezosos

Los carruseles de fotos y el desplazamiento multieje ahora se optimizan correctamente

ScrollView(.horizontal) {
    LazyHStack {
        ForEach(photoSets) { photoSet in
            ScrollView(.vertical) {
                LazyVStack {
                    ForEach(photoSet.photos) { photo in
                        PhotoView(photo: photo)
                    }
                }
            }
        }
    }
}
// iOS 26: Los scrollviews anidados ahora retrasan correctamente la carga con stacks perezosos
// Ideal para carruseles de fotos, diseños estilo Netflix, contenido multieje

Antes de iOS 26 Los ScrollViews anidados no retrasaban correctamente la carga del contenido de los stacks perezosos, lo que provocaba que todo el contenido anidado se cargara inmediatamente.

Después de iOS 26 Los stacks perezosos dentro de ScrollViews anidados ahora retrasan la carga hasta que el contenido está a punto de aparecer, coincidiendo con el comportamiento de los ScrollViews de un solo nivel.

Casos de uso

  • Galerías de fotos con desplazamiento horizontal/vertical
  • Filas de categorías estilo Netflix
  • Navegadores de datos multidimensionales
  • Carruseles de imágenes con desplazamiento vertical de detalles

Mejoras en el Instrumento de Rendimiento SwiftUI

Nuevos carriles en Instruments 26

El instrumento SwiftUI ahora incluye carriles dedicados para:

  1. Actualizaciones Largas del Body de la Vista — Identifica cómputos costosos del body.
  2. Actualizaciones de Vistas de Plataforma — Rastrea el rendimiento del puente UIKit/AppKit (Actualizaciones Representables Largas).
  3. Otras Actualizaciones Largas — Todos los demás tipos de trabajo largo de SwiftUI.

Estos carriles se cubren en detalle en la siguiente sección.

Resumen de Mejoras de Rendimiento

Victorias automáticas (solo recompilar)

  • ✅ Carga de listas 6 veces más rápida (100k+ elementos, macOS)
  • ✅ Actualizaciones de listas 16 veces más rápidas (macOS)
  • ✅ Reducción de fotogramas perdidos durante el desplazamiento
  • ✅ Mejora en la planificación de fotogramas en iOS/macOS
  • ✅ Optimización de carga perezosa en ScrollViews anidados

No se requieren cambios de código — recompila con el SDK de iOS 26 para obtener estas mejoras.

Referencia cruzada Características de SwiftUI 26 (skill swiftui-26-ref) — Guía completa de todos los cambios de SwiftUI en iOS 26.


El Instrumento SwiftUI (Instruments 26)

Primeros Pasos

Requisitos:

  • Instalar Xcode 26
  • Actualizar los dispositivos a las últimas versiones del sistema operativo (soporte para grabación de trazas SwiftUI)
  • Compilar la app en modo Release para un perfilado preciso

Inicio:

  1. Abre el proyecto en Xcode
  2. Presiona Comando-I para perfilar
  3. Elige la plantilla SwiftUI del selector de plantillas
  4. Haz clic en el botón Grabar

Contenido de la Plantilla

La plantilla SwiftUI incluye tres instrumentos:

  1. Instrumento SwiftUI (NUEVO) — Identifica problemas de rendimiento en el código SwiftUI.
  2. Time Profiler — Muestra muestras de trabajo de la CPU a lo largo del tiempo.
  3. Bloqueos y Tirones — Rastrea la capacidad de respuesta de la app.

Carriles del Instrumento SwiftUI

Carril 1: Grupos de Actualización

  • Muestra cuándo SwiftUI está trabajando activamente.
  • ¿Vacío durante picos de CPU? → Es probable que el problema esté fuera de SwiftUI.

Carril 2: Actualizaciones Largas del Body de la Vista

  • Destaca cuando la propiedad body tarda demasiado.
  • El problema de rendimiento más común — empieza aquí.

Carril 3: Actualizaciones Representables Largas

  • Identifica actualizaciones lentas de UIViewRepresentable/NSViewRepresentable.
  • Rendimiento de la integración UIKit/AppKit.

Carril 4: Otras Actualizaciones Largas

  • Todos los demás tipos de trabajo largo de SwiftUI.

Sistema de Codificación por Colores

Las actualizaciones se muestran en naranja y rojo según la probabilidad de causar tirones:

  • Rojo — Muy probable que contribuya a un tirón/bloqueo (investigar primero).
  • Naranja — Moderadamente probable que cause problemas.
  • Gris — Actualizaciones normales, no preocupantes.

Nota: Si las actualizaciones resultan en tirones reales depende de las condiciones del dispositivo, pero las actualizaciones rojas son la máxima prioridad.


Entendiendo el Bucle de Renderizado

Renderizado Normal de Fotogramas

Fotograma 1:
├─ Manejar eventos (toques, pulsaciones de teclas)
├─ Actualizar UI (ejecutar bodies de vistas)
│  └─ Completar antes del plazo del fotograma ✅
├─ Entregar al sistema
└─ El sistema renderiza → Visible en pantalla

Fotograma 2:
├─ Manejar eventos
├─ Actualizar UI
│  └─ Completar antes del plazo del fotograma ✅
├─ Entregar al sistema
└─ El sistema renderiza → Visible en pantalla

Resultado: Animaciones suaves y fluidas.

Fotograma con Tirón (Body de Vista Largo)

Fotograma 1:
├─ Manejar eventos
├─ Actualizar UI
│  └─ UN BODY DE VISTA DEMASIADO LENTO
│  └─ Se pasa del plazo del fotograma ❌
├─ Plazo incumplido
└─ El fotograma anterior permanece visible (TIRÓN)

Fotograma 2: (Retrasado)
├─ Manejar eventos (retrasados 1 fotograma)
├─ Actualizar UI
├─ Entregar al sistema
└─ El sistema renderiza → Finalmente visible

Resultado: Fotograma anterior visible durante 2+ fotogramas = animación entrecortada

Fotograma con Tirón (Demasiadas Actualizaciones)

Fotograma 1:
├─ Manejar eventos
├─ Actualizar UI
│  ├─ Actualización 1 (rápida)
│  ├─ Actualización 2 (rápida)
│  ├─ Actualización 3 (rápida)
│  ├─ ... (100 actualizaciones rápidas más)
│  └─ Tiempo total excede el plazo ❌
├─ Plazo incumplido
└─ El fotograma anterior permanece visible (TIRÓN)

Resultado: Muchas actualizaciones pequeñas se acumulan y no cumplen con el plazo.

Insight Clave: El tiempo de ejecución del body de la vista importa porque no cumplir con los plazos de los fotogramas causa tirones, lo que hace que las animaciones sean menos fluidas.

Referencia:


Problema 1: Actualizaciones Largas del Body de la Vista

Identificando Actualizaciones Largas

  1. Graba una traza en Instruments con la plantilla SwiftUI.
  2. Mira el carril de Actualizaciones Largas del Body de la Vista — ¿Hay barras naranjas/rojas?
  3. Expande la pista SwiftUI para ver subpistas.
  4. Selecciona la subpista de Actualizaciones del Body de la Vista.
  5. Filtra a actualizaciones largas:
    • Panel de detalles → Desplegable → Elige "Resumen de actualizaciones largas del body de la vista".

Analizando con Time Profiler

Flujo de trabajo:

  1. Encuentra una actualización larga en el Resumen de actualizaciones largas del body de la vista.
  2. Pasa el cursor sobre el nombre de la vista → Haz clic en la flecha → "Mostrar actualizaciones".
  3. Haz clic derecho en la actualización larga → "Establecer rango de inspección y zoom".
  4. Cambia a la pista del instrumento Time Profiler.

Lo que ves:

  • Pilas de llamadas para las muestras grabadas durante la ejecución del body de la vista.
  • Tiempo empleado en cada fotograma (columna más a la izquierda).
  • Tu body de la vista anidado en una pila de llamadas SwiftUI profunda.

Encontrando el cuello de botella:

  1. Opción-clic para expandir la pila de llamadas del hilo principal.
  2. Comando-F para buscar el nombre de tu vista (por ejemplo, "LandmarkListItemView").
  3. Identifica operaciones costosas en la columna de tiempo.

Operaciones Costosas Comunes

Creación de Formateadores (Muy Costoso)

❌ INCORRECTO - Crear formateadores en el body de la vista:

struct LandmarkListItemView: View {
    let landmark: Landmark
    @State private var userLocation: CLLocation

    var distance: String {
        // ❌ Crear formateadores cada vez que se ejecuta el body
        let numberFormatter = NumberFormatter()
        numberFormatter.maximumFractionDigits = 1

        let measurementFormatter = MeasurementFormatter()
        measurementFormatter.numberFormatter = numberFormatter

        let meters = userLocation.distance(from: landmark.location)
        let measurement = Measurement(value: meters, unit: UnitLength.meters)
        return measurementFormatter.string(from: measurement)
    }

    var body: some View {
        HStack {
            Text(landmark.name)
            Text(distance) // Llama a la costosa propiedad distance
        }
    }
}

Por qué es lento:

  • Los formateadores son costosos de crear (milisegundos cada uno).
  • Se crean cada vez que se ejecuta el body de la vista.
  • Se ejecuta en el hilo principal → la app espera antes de continuar con las actualizaciones de la UI.
  • Múltiples vistas → el tiempo se acumula rápidamente.

✅ CORRECTO - Almacenar en caché los formateadores de forma centralizada:

@Observable
class LocationFinder {
    private let formatter: MeasurementFormatter
    private let landmarks: [Landmark]
    private var distanceCache: [Landmark.ID: String] = [:]

    init(landmarks: [Landmark]) {
        self.landmarks = landmarks

        // Crear formateadores UNA VEZ durante la inicialización
        let numberFormatter = NumberFormatter()
        numberFormatter.maximumFractionDigits = 1

        self.formatter = MeasurementFormatter()
        self.formatter.numberFormatter = numberFormatter

        updateDistances()
    }

    func didUpdateLocations(_ locations: [CLLocation]) {
        guard let location = locations.last else { return }
        updateDistances(from: location)
    }

    private func updateDistances(from location: CLLocation? = nil) {
        guard let location else { return }

        for landmark in landmarks {
            let meters = location.distance(from: landmark.location)
            let measurement = Measurement(value: meters, unit: UnitLength.meters)
            distanceCache[landmark.id] = formatter.string(from: measurement)
        }
    }

    func distanceString(for landmarkID: Landmark.ID) -> String {
        distanceCache[landmarkID] ?? "Desconocida"
    }
}

struct LandmarkListItemView: View {
    let landmark: Landmark
    @Environment(LocationFinder.self) private var locationFinder

    var body: some View {
        HStack {
            Text(landmark.name)
            Text(locationFinder.distanceString(for: landmark.id)) // ✅ Búsqueda rápida
        }
    }
}

Beneficios:

  • Formateadores creados una vez, reutilizados para todos los puntos de referencia.
  • Cadenas precalculadas cuando cambia la ubicación.
  • El body de la vista solo lee el valor en caché (instantáneo).
  • Se eliminan las actualizaciones largas del body de la vista.

Otras Operaciones Costosas

Cálculos Complejos:

// ❌ No calcular en el body de la vista
var body: some View {
    let result = expensiveAlgorithm(data) // Matemáticas complejas, ordenación, etc.
    Text("\(result)")
}

// ✅ Calcular en el modelo, almacenar en caché el resultado
@Observable
class ViewModel {
    private(set) var result: Int = 0

    func updateData(_ data: [Int]) {
        result = expensiveAlgorithm(data) // Calcular una vez
    }
}

E/S de Red/Archivos:

// ❌ NUNCA hacer E/S en el body de la vista
var body: some View {
    let data = try? Data(contentsOf: fileURL) // ❌ E/S síncrona
    // ...
}

// ✅ Cargar de forma asíncrona

…

[truncado para traducción]

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills relacionados