Habilidade de Especialista em SwiftUI
Regras Operacionais
- Consulte
references/latest-apis.mdno início de cada tarefa para evitar APIs obsoletas - Prefira APIs nativas do SwiftUI em vez de bridge com UIKit/AppKit, a menos que seja necessário
- Foco em correção e desempenho; não imponha arquiteturas específicas (MVVM, VIPER, etc.)
- Incentive a separação da lógica de negócios das views para testabilidade, sem exigir como fazer
- Siga as Diretrizes de Interface Humana e os padrões de design de API da Apple
- Adote o Liquid Glass apenas quando solicitado explicitamente pelo usuário (veja
references/liquid-glass.md) - Apresente otimizações de desempenho como sugestões, não como requisitos
- Use proteção
#availablecom fallbacks sensatos para APIs específicas de versão
Fluxo de Tarefas
Revisar código SwiftUI existente
- Leia o código sob revisão e identifique quais tópicos se aplicam
- Sinalize APIs obsoletas (compare com
references/latest-apis.md) - Execute o Roteador de Tópicos abaixo para cada tópico relevante
- Valide a proteção
#availablee os caminhos de fallback para recursos do iOS 26+
Melhorar código SwiftUI existente
- Audite a implementação atual em relação aos tópicos do Roteador de Tópicos
- Substitua APIs obsoletas por equivalentes modernos de
references/latest-apis.md - Refatore caminhos críticos para reduzir atualizações de estado desnecessárias
- Extraia corpos de view complexos em subviews separadas
- Sugira downsampling de imagem quando
UIImage(data:)for encontrado (otimização opcional, vejareferences/image-optimization.md)
Implementar novo recurso SwiftUI
- Projete o fluxo de dados primeiro: identifique estado próprio vs. estado injetado
- Estruture views para diffing otimizado (extraia subviews cedo)
- Aplique padrões de animação corretos (implícita vs. explícita, transições)
- Use
Buttonpara todos os elementos tocáveis; adicione agrupamento e rótulos de acessibilidade - Proteja APIs específicas de versão com
#availablee forneça fallbacks
Roteador de Tópicos
Consulte o arquivo de referência para cada tópico relevante à tarefa atual:
| Tópico | Referência |
|---|---|
| Gerenciamento de estado | references/state-management.md |
| Composição de views | references/view-structure.md |
| Desempenho | references/performance-patterns.md |
| Listas e ForEach | references/list-patterns.md |
| Layout | references/layout-best-practices.md |
| Sheets e navegação | references/sheet-navigation-patterns.md |
| ScrollView | references/scroll-patterns.md |
| Animações (básico) | references/animation-basics.md |
| Animações (transições) | references/animation-transitions.md |
| Animações (avançado) | references/animation-advanced.md |
| Acessibilidade | references/accessibility-patterns.md |
| Swift Charts | references/charts.md |
| Acessibilidade de gráficos | references/charts-accessibility.md |
| Otimização de imagens | references/image-optimization.md |
| Liquid Glass (iOS 26+) | references/liquid-glass.md |
| Cenas macOS | references/macos-scenes.md |
| Estilização de janelas macOS | references/macos-window-styling.md |
| Views macOS | references/macos-views.md |
| Consulta de APIs obsoletas | references/latest-apis.md |
Checklist de Correção
Estas são regras rígidas — violações são sempre bugs:
- Propriedades
@Statesãoprivate -
@Bindingapenas onde um filho modifica o estado do pai - Valores passados nunca são declarados como
@Stateou@StateObject(eles ignoram atualizações) -
@StateObjectpara objetos próprios da view;@ObservedObjectpara objetos injetados - iOS 17+:
@Statecom@Observable;@Bindablepara observáveis injetados que precisam de bindings -
ForEachusa identidade estável (nunca.indicespara conteúdo dinâmico) - Número constante de views por elemento
ForEach -
.animation(_:value:)sempre inclui o parâmetrovalue - APIs do iOS 26+ protegidas com
#availablee fallback fornecido -
import Chartspresente em arquivos que usam tipos de gráfico
Referências
references/latest-apis.md— Leia primeiro para cada tarefa. Transições de API obsoleta para moderna (iOS 15+ a iOS 26+)references/state-management.md— Property wrappers, fluxo de dados, migração para@Observablereferences/view-structure.md— Extração de views, padrões de container,@ViewBuilderreferences/performance-patterns.md— Otimização de caminhos críticos, controle de atualizações,_logChanges()references/list-patterns.md— Identidade em ForEach, Table (iOS 16+), armadilhas de filtragem inlinereferences/layout-best-practices.md— Padrões de layout, alternativas ao GeometryReaderreferences/accessibility-patterns.md— VoiceOver, Dynamic Type, agrupamento, traitsreferences/animation-basics.md— Animações implícitas/explícitas, temporização, desempenhoreferences/animation-transitions.md— Transições de view,matchedGeometryEffect,Animatablereferences/animation-advanced.md— Animações de fase/keyframe (iOS 17+), macro@Animatable(iOS 26+)references/charts.md— Marcas Swift Charts, eixos, seleção, estilização, Chart3D (iOS 26+)references/charts-accessibility.md— VoiceOver em gráficos, Audio Graph, estratégias de fallbackreferences/sheet-navigation-patterns.md— Sheets, NavigationSplitView, Inspectorreferences/scroll-patterns.md— ScrollViewReader, rolagem programáticareferences/image-optimization.md— AsyncImage, downsampling, cachereferences/liquid-glass.md— Efeitos Liquid Glass do iOS 26+ e padrões de fallbackreferences/macos-scenes.md— Settings, MenuBarExtra, WindowGroup, múltiplas janelasreferences/macos-window-styling.md— Estilos de toolbar, redimensionamento de janelas, Commandsreferences/macos-views.md— HSplitView, Table, PasteButton, interoperabilidade com AppKit