Auditoría de Rendimiento en SwiftUI
Atribución: copiado de la skill Dimillian/Skills de @Dimillian (2025-12-31).
Resumen
Auditar el rendimiento de vistas SwiftUI de extremo a extremo, desde la instrumentación y línea base hasta el análisis de causas raíz y pasos concretos de remediación.
Árbol de Decisión del Flujo de Trabajo
- Si el usuario proporciona código, empezar con "Revisión de Código Primero".
- Si el usuario solo describe síntomas, pedir código mínimo/contexto, luego hacer "Revisión de Código Primero".
- Si la revisión de código no es concluyente, ir a "Guiar al Usuario para Perfilar" y pedir una traza o capturas de pantalla.
1. Revisión de Código Primero
Recopilar:
- Código de la vista/característica objetivo.
- Flujo de datos: estado, entorno, modelos observables.
- Síntomas y pasos de reproducción.
Enfocarse en:
- Tormentas de invalidación de vistas por cambios de estado amplios.
- Identidad inestable en listas (cambio constante de
id,UUID()por cada renderizado). - Trabajo pesado en
body(formateo, ordenamiento, decodificación de imágenes). - Sobrecarga de layout (pilas profundas,
GeometryReader, cadenas de preferencias). - Imágenes grandes sin downsampling o redimensionamiento.
- Jerarquías sobre-animadas (animaciones implícitas en árboles grandes).
Proporcionar:
- Causas raíz probables con referencias de código.
- Soluciones y refactorizaciones sugeridas.
- Si es necesario, una reproducción mínima o sugerencia de instrumentación.
2. Guiar al Usuario para Perfilar
Explicar cómo recopilar datos con Instruments:
- Usar la plantilla SwiftUI en Instruments (compilación Release).
- Reproducir la interacción exacta (scroll, navegación, animación).
- Capturar la línea de tiempo de SwiftUI y el Perfilador de Tiempo (Time Profiler).
- Exportar o capturar en pantalla las pistas relevantes y el árbol de llamadas.
Solicitar:
- Exportación de traza o capturas de pantalla de las pistas de SwiftUI + el árbol de llamadas del Perfilador de Tiempo.
- Configuración de dispositivo/SO/compilación.
3. Analizar y Diagnosticar
Priorizar culpables comunes de SwiftUI:
- Tormentas de invalidación de vistas por cambios de estado amplios.
- Identidad inestable en listas (cambio constante de
id,UUID()por cada renderizado). - Trabajo pesado en
body(formateo, ordenamiento, decodificación de imágenes). - Sobrecarga de layout (pilas profundas,
GeometryReader, cadenas de preferencias). - Imágenes grandes sin downsampling o redimensionamiento.
- Jerarquías sobre-animadas (animaciones implícitas en árboles grandes).
Resumir hallazgos con evidencia de trazas/registros.
4. Remediar
Aplicar correcciones específicas:
- Reducir el ámbito del estado (
@State/@Observablemás cerca de las vistas hoja). - Estabilizar identidades para
ForEachy listas. - Mover trabajo pesado fuera de
body(precalcular, cachear, usar@State). - Usar
equatable()o envoltorios de valor para subárboles costosos. - Redimensionar imágenes antes de renderizar.
- Reducir la complejidad del layout o usar tamaños fijos cuando sea posible.
Patrones de Código Sospechosos Comunes (y Correcciones)
Buscar estos patrones durante la revisión de código.
Formateadores costosos en body
var body: some View {
let number = NumberFormatter() // asignación lenta
let measure = MeasurementFormatter() // asignación lenta
Text(measure.string(from: .init(value: meters, unit: .meters)))
}
Prefiere formateadores cacheados en un modelo o en un helper dedicado:
final class DistanceFormatter {
static let shared = DistanceFormatter()
let number = NumberFormatter()
let measure = MeasurementFormatter()
}
Propiedades computadas que hacen trabajo pesado
var filtered: [Item] {
items.filter { $0.isEnabled } // se ejecuta en cada evaluación de body
}
Prefiere precalcular o cachear ante cambios:
@State private var filtered: [Item] = []
// actualizar filtered cuando las entradas cambien
Ordenamiento/filtrado en body o ForEach
List {
ForEach(items.sorted(by: sortRule)) { item in
Row(item)
}
}
Prefiere ordenar una vez antes de las actualizaciones de vista:
let sortedItems = items.sorted(by: sortRule)
Filtrado en línea en ForEach
ForEach(items.filter { $0.isEnabled }) { item in
Row(item)
}
Prefiere una colección pre-filtrada con identidad estable.
Identidad inestable
ForEach(items, id: \.self) { item in
Row(item)
}
Evita id: \.self para valores no estables; usa un ID estable.
Decodificación de imágenes en el hilo principal
Image(uiImage: UIImage(data: data)!)
Prefiere decodificar/redimensionar fuera del hilo principal y almacenar el resultado.
Dependencias amplias en modelos observables
@Observable class Model {
var items: [Item] = []
}
var body: some View {
Row(isFavorite: model.items.contains(item))
}
Prefiere modelos de vista granulares o estado por elemento para reducir la propagación de actualizaciones.
5. Verificar
Pedir al usuario que ejecute nuevamente la misma captura y compare con las métricas de línea base. Resumir el delta (CPU, caídas de fotogramas, pico de memoria) si se proporciona.
Salidas
Proporcionar:
- Una tabla breve de métricas (antes/después si está disponible).
- Problemas principales (ordenados por impacto).
- Correcciones propuestas con esfuerzo estimado.
Referencias
Agregar documentación de Apple y recursos de WWDC bajo references/ según los proporcione el usuario.
- Optimización del rendimiento de SwiftUI con Instruments:
references/optimizing-swiftui-performance-instruments.md - Comprensión y mejora del rendimiento de SwiftUI:
references/understanding-improving-swiftui-performance.md - Comprensión de los bloqueos en tu app:
references/understanding-hangs-in-your-app.md - Desmitificar el rendimiento de SwiftUI (WWDC23):
references/demystify-swiftui-performance-wwdc23.md