Auditoria de Desempenho SwiftUI
Visão Geral
Audite o desempenho de visualizações SwiftUI de ponta a ponta, desde a instrumentação e definição de linha de base até a análise de causa raiz e etapas de correção concretas.
Árvore de Decisão do Fluxo de Trabalho
- Se o usuário fornecer código, comece com "Revisão Baseada em Código".
- Se o usuário apenas descrever sintomas, peça o código/contexto mínimo e, em seguida, faça a "Revisão Baseada em Código".
- Se a revisão de código não for conclusiva, vá para "Guiar o Usuário para Criar Perfil" e peça um rastreamento ou capturas de tela.
1. Revisão Baseada em Código
Colete:
- Código da visualização/recurso alvo.
- Fluxo de dados: estado, ambiente, modelos observáveis.
- Sintomas e etapas de reprodução.
Concentre-se em:
- Tempestades de invalidação de visualização devido a alterações amplas de estado.
- Identidade instável em listas (churn de
id,UUID()por renderização). - Trabalho pesado em
body(formatação, classificação, decodificação de imagem). - Thrash de layout (pilhas profundas,
GeometryReader, cadeias de preferência). - Imagens grandes sem redução de resolução ou redimensionamento.
- Hierarquias com excesso de animações (animações implícitas em árvores grandes).
Forneça:
- Causas raiz prováveis com referências de código.
- Correções e refatorações sugeridas.
- Se necessário, uma reprodução mínima ou sugestão de instrumentação.
2. Guiar o Usuário para Criar Perfil
Explique como coletar dados com Instruments:
- Use o template SwiftUI no Instruments (Build de Release).
- Reproduza a interação exata (rolagem, navegação, animação).
- Capture a linha do tempo do SwiftUI e o Criador de Perfil de Tempo.
- Exporte ou capture a tela das faixas relevantes e da árvore de chamadas.
Peça:
- Exportação de rastreamento ou capturas de tela das faixas do SwiftUI + árvore de chamadas do Criador de Perfil de Tempo.
- Configuração do dispositivo/SO/build.
3. Analisar e Diagnosticar
Priorize os culpados prováveis do SwiftUI:
- Tempestades de invalidação de visualização devido a alterações amplas de estado.
- Identidade instável em listas (churn de
id,UUID()por renderização). - Trabalho pesado em
body(formatação, classificação, decodificação de imagem). - Thrash de layout (pilhas profundas,
GeometryReader, cadeias de preferência). - Imagens grandes sem redução de resolução ou redimensionamento.
- Hierarquias com excesso de animações (animações implícitas em árvores grandes).
Resuma as descobertas com evidências de rastreamentos/logs.
4. Remediar
Aplique correções direcionadas:
- Estreite o escopo do estado (
@State/@Observablemais próximo das visualizações folha). - 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 resolução de imagens antes de renderizar.
- Reduza a complexidade do layout ou use dimensionamento fixo quando possível.
Cheiros de Código Comuns (e Correções)
Procure por esses 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 auxiliar dedicado:
final class DistanceFormatter {
static let shared = DistanceFormatter()
let number = NumberFormatter()
let measure = MeasurementFormatter()
}
Propriedades computadas que realizam trabalho pesado
var filtered: [Item] {
items.filter { $0.isEnabled } // executa em toda avaliação de body
}
Prefira pré-calcular ou armazenar em cache na alteração:
@State private var filtered: [Item] = []
// atualize filtered quando as entradas mudarem
Classificação/filtragem em body ou ForEach
List {
ForEach(items.sorted(by: sortRule)) { item in
Row(item)
}
}
Prefira classificar 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 resolução 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 de 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 fornecidos pelo usuário.
- Otimizando desempenho do SwiftUI com Instruments:
references/optimizing-swiftui-performance-instruments.md - Entendendo e melhorando o desempenho do SwiftUI:
references/understanding-improving-swiftui-performance.md - Entendendo travamentos no seu aplicativo:
references/understanding-hangs-in-your-app.md - Desmistificando o desempenho do SwiftUI (WWDC23):
references/demystify-swiftui-performance-wwdc23.md