axiom-watchos

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

watchOS Development

watchOS开发

You MUST use this skill for ANY watchOS-specific development including app structure, independent apps, Watch Connectivity, complications and Smart Stack widgets, controls, Live Activities on watch, background tasks, and ClockKit migration.

任何watchOS专属开发场景都必须使用该技能，包括应用架构、独立应用、Watch Connectivity、complications、Smart Stack小组件、控件、手表端Live Activities、后台任务以及ClockKit迁移。

Quick Reference

快速参考

Symptom / Task	Reference
App structure, independent apps, watchOS 26 submission requirements	See `skills/platform-basics.md`
watchOS HIG, glanceable UX, navigation model	See `skills/design-for-watchos.md`
Smart Stack widgets, complications, ClockKit→WidgetKit, RelevanceKit	See `skills/smart-stack-and-complications.md`
Controls on watch surfaces, Live Activities on watch	See `skills/controls-and-live-activities.md`
Watch Connectivity (WCSession), paired-device data transfer, Family Setup	See `skills/watch-connectivity.md`
Background tasks, freshness scheduling, TN3135 networking limits	See `skills/background-and-networking.md`
WatchKit→SwiftUI migration, ClockKit→WidgetKit migration	See `skills/modernization.md`

场景/任务	参考文档
应用架构、独立应用、watchOS 26提交要求	查看 `skills/platform-basics.md`
watchOS人机界面指南（HIG）、可快速浏览的用户体验、导航模型	查看 `skills/design-for-watchos.md`
Smart Stack小组件、complications、ClockKit→WidgetKit迁移、RelevanceKit	查看 `skills/smart-stack-and-complications.md`
手表界面控件、手表端Live Activities	查看 `skills/controls-and-live-activities.md`
Watch Connectivity（WCSession）、配对设备数据传输、Family Setup	查看 `skills/watch-connectivity.md`
后台任务、更新调度、TN3135网络限制	查看 `skills/background-and-networking.md`
WatchKit→SwiftUI迁移、ClockKit→WidgetKit迁移	查看 `skills/modernization.md`

Cross-Suite Routes

跨套件指引

These topics overlap with watchOS development but live in separate suites:

以下主题与watchOS开发相关，但属于其他独立套件：

SwiftUI (shared iOS/watchOS/macOS)

SwiftUI（iOS/watchOS/macOS共享）

View state, data flow, @Observable → See axiom-swiftui
Navigation basics (NavigationStack) → See axiom-swiftui
Layout, animations → See axiom-swiftui

视图状态、数据流、@Observable → 查看axiom-swiftui
基础导航（NavigationStack）→ 查看axiom-swiftui
布局、动画 → 查看axiom-swiftui

Design

设计

General HIG, Liquid Glass, SF Symbols, typography → See axiom-design

通用人机界面指南（HIG）、Liquid Glass、SF Symbols、排版 → 查看axiom-design

Accessibility

无障碍

General VoiceOver, Dynamic Type, WCAG → See axiom-accessibility
watchOS-specific (VoiceOver rotor on Digital Crown, AssistiveTouch, Double Tap) → See axiom-accessibility (
```
skills/watchos-a11y.md
```
)

通用VoiceOver、动态字体、WCAG → 查看axiom-accessibility
watchOS专属功能（数码表冠上的VoiceOver转子、AssistiveTouch、双击）→ 查看axiom-accessibility（
```
skills/watchos-a11y.md
```
）

Health and workouts

健康与运动

HealthKit,
```
HKWorkoutSession
```
,
```
HKLiveWorkoutBuilder
```
, WorkoutKit → See axiom-health
Workout recovery, multi-device coordination → See axiom-health (
```
skills/workouts.md
```
)

HealthKit、
```
HKWorkoutSession
```
、
```
HKLiveWorkoutBuilder
```
、WorkoutKit → 查看axiom-health
运动恢复、多设备协同 → 查看axiom-health（
```
skills/workouts.md
```
）

iOS-side widgets and App Intents

iOS端小组件与App Intents

iOS/iPadOS widgets, configuration intents, App Intents → See axiom-integration
Live Activities on iPhone (initiation + ActivityKit) → See axiom-integration

iOS/iPadOS小组件、配置意图、App Intents → 查看axiom-integration
iPhone端Live Activities（启动+ActivityKit）→ 查看axiom-integration

Concurrency

并发

Swift 6 concurrency, actors, Sendable → See axiom-concurrency

Swift 6并发、actors、Sendable → 查看axiom-concurrency

Conflict Resolution

冲突解决

axiom-watchos vs axiom-swiftui: When building a watchOS SwiftUI app:

Use axiom-watchos for watch-specific patterns: glanceable UI, constrained navigation, Digital Crown focus, Smart Stack placement
Use axiom-swiftui for cross-platform SwiftUI: state management, layout primitives, animations
Both may apply: A watchOS NavigationStack with complications needs axiom-watchos for complication surfaces and axiom-swiftui for NavigationStack basics

axiom-watchos vs axiom-integration: For widgets and Live Activities:

Use axiom-watchos for watch complications, Smart Stack placement, watch-side Live Activity presentation, RelevanceKit
Use axiom-integration for iOS/iPadOS widgets, core ActivityKit API, App Intents

axiom-watchos vs axiom-health: For workouts on Apple Watch:

Use axiom-watchos for watch-specific presentation: Always On display, Smart Stack placement, background mode coordination
Use axiom-health for
```
HKWorkoutSession
```
lifecycle,
```
HKLiveWorkoutBuilder
```
, recovery, multi-device mirroring

axiom-watchos vs axiom-swiftui：开发watchOS SwiftUI应用时：

使用axiom-watchos处理手表专属模式：可快速浏览的UI、受限导航、数码表冠焦点、Smart Stack布局
使用axiom-swiftui处理跨平台SwiftUI内容：状态管理、布局基础组件、动画
两者均适用：带有complications的watchOS NavigationStack需要axiom-watchos处理complications界面，同时需要axiom-swiftui处理NavigationStack基础功能

axiom-watchos vs axiom-integration：针对小组件和Live Activities：

使用axiom-watchos处理手表complications、Smart Stack布局、手表端Live Activity展示、RelevanceKit
使用axiom-integration处理iOS/iPadOS小组件、核心ActivityKit API、App Intents

axiom-watchos vs axiom-health：针对Apple Watch上的运动功能：

使用axiom-watchos处理手表专属展示：常亮显示、Smart Stack布局、后台模式协同
使用axiom-health处理
```
HKWorkoutSession
```
生命周期、
```
HKLiveWorkoutBuilder
```
、恢复、多设备镜像

Decision Tree

决策树

dot

digraph watchos {
    start [label="watchOS development task" shape=ellipse];
    what [label="What area?" shape=diamond];

    start -> what;
    what -> "skills/platform-basics.md" [label="app structure, independent apps, submission"];
    what -> "skills/design-for-watchos.md" [label="watch HIG, glanceable UX"];
    what -> "skills/smart-stack-and-complications.md" [label="complications, Smart Stack, RelevanceKit"];
    what -> "skills/controls-and-live-activities.md" [label="controls, watch Live Activities"];
    what -> "skills/watch-connectivity.md" [label="WCSession, paired-device transfer"];
    what -> "skills/background-and-networking.md" [label="background tasks, networking limits"];
    what -> "skills/modernization.md" [label="WatchKit/ClockKit migration"];
    what -> "axiom-health" [label="workouts, HealthKit, WorkoutKit"];
    what -> "axiom-swiftui" [label="general SwiftUI patterns"];
    what -> "axiom-accessibility" [label="VoiceOver rotor, AssistiveTouch"];
    what -> "axiom-integration" [label="iOS-side widgets, App Intents"];
}

dot

digraph watchos {
    start [label="watchOS development task" shape=ellipse];
    what [label="What area?" shape=diamond];

    start -> what;
    what -> "skills/platform-basics.md" [label="app structure, independent apps, submission"];
    what -> "skills/design-for-watchos.md" [label="watch HIG, glanceable UX"];
    what -> "skills/smart-stack-and-complications.md" [label="complications, Smart Stack, RelevanceKit"];
    what -> "skills/controls-and-live-activities.md" [label="controls, watch Live Activities"];
    what -> "skills/watch-connectivity.md" [label="WCSession, paired-device transfer"];
    what -> "skills/background-and-networking.md" [label="background tasks, networking limits"];
    what -> "skills/modernization.md" [label="WatchKit/ClockKit migration"];
    what -> "axiom-health" [label="workouts, HealthKit, WorkoutKit"];
    what -> "axiom-swiftui" [label="general SwiftUI patterns"];
    what -> "axiom-accessibility" [label="VoiceOver rotor, AssistiveTouch"];
    what -> "axiom-integration" [label="iOS-side widgets, App Intents"];
}

Resources

资源

WWDC: 2021-10003, 2022-10133, 2023-10138, 2023-10029, 2023-10309, 2024-10098, 2024-10157, 2024-10205, 2025-334

Docs: /watchos-apps/building-a-watchos-app, /watchos-apps/creating-independent-watchos-apps, /watchconnectivity, /widgetkit/creating-accessory-widgets-and-watch-complications, /widgetkit/converting-a-clockkit-app, /relevancekit, /technotes/tn3135-low-level-networking-on-watchos, /technotes/tn3157-updating-your-watchos-project-for-swiftui-and-widgetkit

Skills: axiom-swiftui, axiom-design, axiom-accessibility, axiom-health, axiom-integration, axiom-concurrency

WWDC: 2021-10003, 2022-10133, 2023-10138, 2023-10029, 2023-10309, 2024-10098, 2024-10157, 2024-10205, 2025-334

Skills: axiom-swiftui, axiom-design, axiom-accessibility, axiom-health, axiom-integration, axiom-concurrency