swiftui-core

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

SwiftUI Core

SwiftUI 核心

SwiftUI fundamentals shared across all Apple platforms.

适用于所有Apple平台的SwiftUI基础知识。

Agent Workflow (MANDATORY)

Agent 工作流（强制要求）

Before ANY implementation, use

TeamCreate

to spawn 3 agents:

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.

在进行任何实现之前，使用

TeamCreate

生成3个Agent：

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

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实现响应式布局

swiftui-core

Original

Translation

SwiftUI Core

SwiftUI 核心

Agent Workflow (MANDATORY)

Agent 工作流（强制要求）

Overview

概述

When to Use

使用场景

Why SwiftUI Core

为何选择SwiftUI核心

Key Concepts

核心概念

Views & Modifiers

视图与修饰符

Navigation

导航

SwiftData

SwiftData

State Management

状态管理

Reference Guide

参考指南

Best Practices

最佳实践