Habilidad de Experto en SwiftUI
Reglas de Funcionamiento
- Consulta
references/latest-apis.mdal inicio de cada tarea para evitar APIs obsoletas - Prefiere APIs nativas de SwiftUI sobre el puente UIKit/AppKit a menos que el puente sea necesario
- Enfócate en la corrección y el rendimiento; no impongas arquitecturas específicas (MVVM, VIPER, etc.)
- Fomenta la separación de la lógica de negocio de las vistas para facilitar las pruebas sin obligar a cómo hacerlo
- Sigue las Guías de Interfaz Humana de Apple y los patrones de diseño de API
- Solo adopta Liquid Glass cuando el usuario lo solicite explícitamente (ver
references/liquid-glass.md) - Presenta las optimizaciones de rendimiento como sugerencias, no como requisitos
- Usa comprobación
#availablecon alternativas sensatas para APIs específicas de versión
Flujo de Trabajo de Tareas
Revisar código SwiftUI existente
- Lee el código bajo revisión e identifica qué temas aplican
- Marca APIs obsoletas (compara contra
references/latest-apis.md) - Ejecuta el Enrutador de Temas a continuación para cada tema relevante
- Valida la comprobación
#availabley las rutas alternativas para funciones de iOS 26+
Mejorar código SwiftUI existente
- Audita la implementación actual contra los temas del Enrutador de Temas
- Reemplaza APIs obsoletas con equivalentes modernos de
references/latest-apis.md - Refactoriza rutas críticas para reducir actualizaciones de estado innecesarias
- Extrae cuerpos de vistas complejas en subvistas separadas
- Sugiere reducción de muestreo de imágenes cuando se encuentre
UIImage(data:)(optimización opcional, verreferences/image-optimization.md)
Implementar nueva funcionalidad SwiftUI
- Diseña primero el flujo de datos: identifica estado propio vs. inyectado
- Estructura las vistas para un diffing óptimo (extrae subvistas temprano)
- Aplica patrones de animación correctos (implícita vs. explícita, transiciones)
- Usa
Buttonpara todos los elementos tocables; añade agrupación y etiquetas de accesibilidad - Aísla APIs específicas de versión con
#availabley proporciona alternativas
Enrutador de Temas
Consulta el archivo de referencia para cada tema relevante a la tarea actual:
| Tema | Referencia |
|---|---|
| Gestión de estado | references/state-management.md |
| Composición de vistas | references/view-structure.md |
| Rendimiento | references/performance-patterns.md |
| Listas y ForEach | references/list-patterns.md |
| Diseño | references/layout-best-practices.md |
| Hojas y navegación | references/sheet-navigation-patterns.md |
| ScrollView | references/scroll-patterns.md |
| Animaciones (básico) | references/animation-basics.md |
| Animaciones (transiciones) | references/animation-transitions.md |
| Animaciones (avanzado) | references/animation-advanced.md |
| Accesibilidad | references/accessibility-patterns.md |
| Swift Charts | references/charts.md |
| Accesibilidad de Charts | references/charts-accessibility.md |
| Optimización de imágenes | references/image-optimization.md |
| Liquid Glass (iOS 26+) | references/liquid-glass.md |
| Escenas macOS | references/macos-scenes.md |
| Estilo de ventanas macOS | references/macos-window-styling.md |
| Vistas macOS | references/macos-views.md |
| Consulta de APIs obsoletas | references/latest-apis.md |
Lista de Verificación de Corrección
Estas son reglas estrictas: las violaciones siempre son errores:
- Las propiedades
@Statesonprivate -
@Bindingsolo cuando un hijo modifica el estado del padre - Los valores pasados nunca se declaran como
@Stateo@StateObject(ignoran actualizaciones) -
@StateObjectpara objetos propios de la vista;@ObservedObjectpara inyectados - iOS 17+:
@Statecon@Observable;@Bindablepara observables inyectados que necesitan enlaces -
ForEachutiliza identidad estable (nunca.indicespara contenido dinámico) - Número constante de vistas por elemento de
ForEach -
.animation(_:value:)siempre incluye el parámetrovalue - APIs de iOS 26+ aisladas con
#availabley se proporciona alternativa -
import Chartspresente en archivos que usan tipos de chart
Referencias
references/latest-apis.md-- Leer primero para cada tarea. Transiciones de API obsoletas a modernas (iOS 15+ hasta iOS 26+)references/state-management.md-- Envoltorios de propiedad, flujo de datos, migración a@Observablereferences/view-structure.md-- Extracción de vistas, patrones de contenedor,@ViewBuilderreferences/performance-patterns.md-- Optimización de rutas críticas, control de actualizaciones,_logChanges()references/list-patterns.md-- Identidad en ForEach, Table (iOS 16+), errores de filtrado en líneareferences/layout-best-practices.md-- Patrones de diseño, alternativas a GeometryReaderreferences/accessibility-patterns.md-- VoiceOver, Tipo Dinámico, agrupación, rasgosreferences/animation-basics.md-- Animaciones implícitas/explícitas, temporización, rendimientoreferences/animation-transitions.md-- Transiciones de vistas,matchedGeometryEffect,Animatablereferences/animation-advanced.md-- Animaciones por fases/fotogramas clave (iOS 17+), macro@Animatable(iOS 26+)references/charts.md-- Marcas de Swift Charts, ejes, selección, estilo, Chart3D (iOS 26+)references/charts-accessibility.md-- VoiceOver en Charts, Audio Graph, estrategias alternativasreferences/sheet-navigation-patterns.md-- Hojas, NavigationSplitView, Inspectorreferences/scroll-patterns.md-- ScrollViewReader, desplazamiento programáticoreferences/image-optimization.md-- AsyncImage, reducción de muestreo, cachéreferences/liquid-glass.md-- Efectos Liquid Glass de iOS 26+ y patrones alternativosreferences/macos-scenes.md-- Settings, MenuBarExtra, WindowGroup, multi-ventanareferences/macos-window-styling.md-- Estilos de barra de herramientas, tamaño de ventanas, Commandsreferences/macos-views.md-- HSplitView, Table, PasteButton, interoperación con AppKit