Auditoria de Desempenho SwiftUI
Atribuição: copiado de Dimillian/Skills de @Dimillian (2025-12-31).
Visão Geral
Audite o desempenho de visualizações SwiftUI de ponta a ponta, desde instrumentação e criação de linha de base até análise de causa raiz e etapas concretas de remediação.
Árvore de Decisão do Fluxo de Trabalho
- Se o usuário fornecer código, comece com "Revisão Centrada no Código."
- Se o usuário apenas descrever sintomas, peça o código mínimo/contexto e então faça a "Revisão Centrada no Código."
- Se a revisão de código for inconclusiva, vá para "Guiar o Usuário para Perfilar" e peça um trace ou capturas de tela.
1. Revisão Centrada no Código
Colete:
- Código da visualização/recurso alvo.
- Fluxo de dados: estado, environment, modelos observáveis.
- Sintomas e etapas de reprodução.
Concentre-se em:
- Tempestades de invalidação de visualização causadas por alterações amplas de estado.
- Identidade instável em listas (rotatividade de
id,UUID()por renderização). - Trabalho pesado em
body(formatação, ordenação, decodificação de imagens). - Instabilidade de layout (pilhas profundas,
GeometryReader, cadeias de preferências). - Imagens grandes sem redução de amostragem ou redimensionamento.
- Hierarquias super animadas (animações implícitas em árvores grandes).
Forneça:
- Causas raiz prováveis com referências de código.
- Correções sugestões e refatorações.
- Se necessário, uma reprodução mínima ou sugestão de instrumentação.
2. Guiar o Usuário para Perfilar
Explique como coletar dados com Instruments:
- Use o template SwiftUI no Instruments (build Release).
- Reproduza a interação exata (scroll, navegação, animação).
- Capture a linha do tempo do SwiftUI e o Time Profiler.
- Exporte ou tire uma captura de tela das faixas relevantes e da árvore de chamadas.
Peça:
- Exportação do trace ou capturas de tela das faixas do SwiftUI + árvore de chamadas do Time Profiler.
- Configuração do dispositivo/SO/build.
3. Analisar e Diagnosticar
Priorize os culpados prováveis do SwiftUI:
- Tempestades de invalidação de visualização causadas por alterações amplas de estado.
- Identidade instável em listas (rotatividade de
id,UUID()por renderização). - Trabalho pesado em
body(formatação, ordenação, decodificação de imagens). - Instabilidade de layout (pilhas profundas,
GeometryReader, cadeias de preferências). - Imagens grandes sem redução de amostragem ou redimensionamento.
- Hierarquias super animadas (animações implícitas em árvores grandes).
Resuma as descobertas com evidências de traces/logs.
4. Remediar
Aplique correções direcionadas:
- Escopo estreito de estado (
@State/@Observablemais próximo das visualizações folhas). - Estabilize identidades para
ForEache listas. - Mova trabalho pesado para fora de
body(pré-calcular, cache,@State). - Use
equatable()ou wrappers de valor para subárvores caras. - Reduza a amostragem de imagens antes da renderização.
- Reduza a complexidade do layout ou use dimensionamento fixo quando possível.
Mau Cheiros Comuns (e Correções)
Procure por estes padrões durante a revisão de código.
Formatadores caros em body
var body: some View {
let number = NumberFormatter() // alocação lenta
let measure = MeasurementFormatter() // alocação lenta
Text(measure.string(from: .init(value: meters, unit: .meters)))
}
Prefira formatadores em cache em um modelo ou um helper dedicado:
final class DistanceFormatter {
static let shared = DistanceFormatter()
let number = NumberFormatter()
let measure = MeasurementFormatter()
}
Propriedades computadas que fazem trabalho pesado
var filtered: [Item] {
items.filter { $0.isEnabled } // executa em toda avaliação de body
}
Prefira pré-calcular ou cache na mudança:
@State private var filtered: [Item] = []
// atualize filtered quando as entradas mudarem
Ordenação/filtragem em body ou ForEach
List {
ForEach(items.sorted(by: sortRule)) { item in
Row(item)
}
}
Prefira ordenar uma vez antes das atualizações de visualização:
let sortedItems = items.sorted(by: sortRule)
Filtragem inline em ForEach
ForEach(items.filter { $0.isEnabled }) { item in
Row(item)
}
Prefira uma coleção pré-filtrada com identidade estável.
Identidade instável
ForEach(items, id: \.self) { item in
Row(item)
}
Evite id: \.self para valores não estáveis; use um ID estável.
Decodificação de imagem na thread principal
Image(uiImage: UIImage(data: data)!)
Prefira decodificar/reduzir amostragem fora da thread principal e armazenar o resultado.
Dependências amplas em modelos observáveis
@Observable class Model {
var items: [Item] = []
}
var body: some View {
Row(isFavorite: model.items.contains(item))
}
Prefira modelos de visualização granulares ou estado por item para reduzir a propagação de atualizações.
5. Verificar
Peça ao usuário para executar novamente a mesma captura e comparar com as métricas da linha de base. Resuma o delta (CPU, quedas de quadro, pico de memória) se fornecido.
Saídas
Forneça:
- Uma tabela curta de métricas (antes/depois se disponível).
- Principais problemas (ordenados por impacto).
- Correções propostas com esforço estimado.
Referências
Adicione documentação da Apple e recursos da WWDC em references/ conforme forem fornecidos pelo usuário.
- Otimizando desempenho SwiftUI com Instruments:
references/optimizing-swiftui-performance-instruments.md - Entendendo e melhorando desempenho SwiftUI:
references/understanding-improving-swiftui-performance.md - Entendendo travamentos no seu aplicativo:
references/understanding-hangs-in-your-app.md - Desmistificando desempenho SwiftUI (WWDC23):
references/demystify-swiftui-performance-wwdc23.md