用途:构建或审查基于 WidgetKit 的组件,覆盖主屏幕小组件、锁屏 complication、控制中心 ControlWidget,以及 StandBy 与 CarPlay 小组件,目标为 Swift 6.3 / iOS 26+。
主要能力:
- 扩展架构:Widget 运行在独立 widget extension 进程中,主应用与 widget 通过 App Groups 共享数据,使用 UserDefaults(suiteName: "group.com.example.app") 或共享容器目录;所有 widget、Live Activity 与控件可归入单个 @main WidgetBundle。
- 表面与家族:主屏幕支持 .systemSmall 至 .systemExtraLarge,用 AppIntentConfiguration 配置,容器背景用 containerBackground(for:);锁屏支持 .accessoryCircular、.accessoryRectangular、.accessoryInline,静态配置,单色或强调色样式;StandBy 支持 systemSmall/Medium,需适配夜间红色调;控制中心使用 ControlWidget(按钮与开关),静态配置,含 ControlWidgetButton、ControlWidgetToggle。
- 时间线管理:通过 TimelineProvider 提供未来条目,重载策略包括 .atEnd(最后条目过期后请求)、.after(Date)(指定时间重载)、.never(不自动重载)。系统有每日重载预算,通常约 40–70 次,禁止用 .after 安排亚分钟级刷新;实时状态应改用推送通知或 ActivityKit Live Activities。
- 交互控件:支持 Button(intent:) 与 Toggle(isOn:intent:),需符合 AppIntent;复杂意图建模参考 app-intents,Dynamic Island 与锁屏实时进度参考 activitykit。
使用方式与限制:在 TimelineProvider 内做网络请求与昂贵计算,而非在 SwiftUI 视图内;所有内容视图须应用 .containerBackground(for: .widget),否则会破坏 iOS 17+ 的 StandBy 与锁屏渲染;读取主应用数据需在两端配置 App Group 权限;widget 视图不支持视频、Web View 或复杂连续动画。其他细分主题(时间线提供器配置、深链 widgetURL、性能与内存预算、相关性条目等)资料仅给出路由指引,未展开具体步骤。