swiftui-core
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseSwiftUI Core
SwiftUI 核心
SwiftUI fundamentals shared across all Apple platforms.
适用于所有Apple平台的SwiftUI基础知识。
Agent Workflow (MANDATORY)
Agent 工作流（强制要求）
Before ANY implementation, use to spawn 3 agents:
TeamCreate- fuse-ai-pilot:explore-codebase - Analyze existing SwiftUI patterns
- fuse-ai-pilot:research-expert - Verify latest SwiftUI docs via Context7/Exa
- mcp__apple-docs__search_apple_docs - Check SwiftUI view patterns
After implementation, run fuse-ai-pilot:sniper for validation.
在进行任何实现之前，使用生成3个Agent：
TeamCreate- fuse-ai-pilot:explore-codebase - 分析现有SwiftUI模式
- fuse-ai-pilot:research-expert - 通过Context7/Exa验证最新的SwiftUI文档
- mcp__apple-docs__search_apple_docs - 检查SwiftUI视图模式
实现完成后，运行fuse-ai-pilot:sniper进行验证。
Overview
概述
When to Use
使用场景
- Building SwiftUI views and components
- Implementing navigation (NavigationStack, SplitView)
- Data persistence with SwiftData
- State management (@State, @Observable)
- Custom view modifiers and layouts
- 构建SwiftUI视图与组件
- 实现导航（NavigationStack、SplitView）
- 使用SwiftData实现数据持久化
- 状态管理（@State、@Observable）
- 自定义视图修饰符与布局
Why SwiftUI Core
为何选择SwiftUI核心
| Feature | Benefit |
|---|---|
| Declarative UI | Less code, automatic updates |
| Cross-platform | Same code for iOS/macOS/watchOS/visionOS |
| @Observable | Simple reactive state |
| SwiftData | Modern persistence with minimal code |
| Feature | Benefit |
|---|---|
| 声明式UI | 代码量更少，自动更新 |
| 跨平台 | 同一代码适配iOS/macOS/watchOS/visionOS |
| @Observable | 简洁的响应式状态 |
| SwiftData | 代码量极少的现代持久化方案 |
Key Concepts
核心概念
Views & Modifiers
视图与修饰符
Composable UI building blocks. Extract subviews at 30+ lines.
可组合的UI构建块。当代码超过30行时提取子视图。
Navigation
导航
NavigationStack for stack-based, NavigationSplitView for multi-column.
NavigationStack用于基于栈的导航，NavigationSplitView用于多列导航。
SwiftData
SwiftData
Modern persistence with @Model. Replaces Core Data for most use cases.
基于@Model的现代持久化方案，在大多数场景下可替代Core Data。
State Management
状态管理
@State for local, @Observable for shared, @Environment for injection.
@State用于本地状态，@Observable用于共享状态，@Environment用于依赖注入。
Reference Guide
参考指南
| Need | Reference |
|---|---|
| Views, modifiers, layouts | views-modifiers.md |
| NavigationStack, deep linking | navigation.md |
| SwiftData, @Query, CloudKit | data-swiftdata.md |
| @State, @Observable, Environment | state-management.md |
| Liquid Glass all platforms | liquid-glass.md |
| 需求 | 参考文档 |
|---|---|
| 视图、修饰符、布局 | views-modifiers.md |
| NavigationStack、深度链接 | navigation.md |
| SwiftData、@Query、CloudKit | data-swiftdata.md |
| @State、@Observable、Environment | state-management.md |
| 全平台Liquid Glass | liquid-glass.md |
Best Practices
最佳实践
- Small views - Extract at 30+ lines
- Composition - Use ViewBuilder and modifiers
- Preview-driven - Always include #Preview
- Semantic colors - Use .primary, .secondary
- Accessibility - Add labels to icons
- Platform adaptation - Check sizeClass for responsive layouts
- 小型视图 - 代码超过30行时提取子视图
- 组合式开发 - 使用ViewBuilder与修饰符
- 预览驱动开发 - 始终包含#Preview
- 语义化颜色 - 使用.primary、.secondary
- 无障碍适配 - 为图标添加标签
- 平台适配 - 通过sizeClass实现响应式布局