SuperAPI AI 工具集

axiom-extensions-widgets-ref

编程与开发

查看项目

更新于 10-15 20:11

技能介绍

用途:在实现小组件、实时活动、控制中心控件或应用扩展时,提供 Apple 生态的 API 参考。涵盖 iOS 14+ 标准小组件(主屏、锁屏、StandBy)、iOS 17+ 交互式小组件(配合 App Intents 的按钮与开关)、iOS 16.1+ Live Activities(锁屏与灵动岛实时更新)、iOS 18+ 控制中心控件、iOS 26+ Liquid Glass 渲染、visionOS 2+ 小组件挂载样式与纹理,以及应用扩展的数据共享、生命周期与权限。

主要能力:介绍 WidgetConfiguration(StaticConfiguration、AppIntentConfiguration、ActivityConfiguration)的选择;systemSmall/Medium/Large/ExtraLarge 与 accessoryCircular/Rectangular/Inline 等 family;TimelineProvider、TimelineEntry、刷新策略 .atEnd/.after/.never 及 WidgetCenter 手动刷新;ActivityAttributes、ContentState(需小于 4KB)、启动与更新活动、AlertConfiguration、结束与 dismissalPolicy;交互组件使用 Button/Toggle 配合 App Intent,invalidatableContent 与 contentTransition 等动画;配置类小组件中使用 WidgetConfigurationIntent、AppEntity 与 EntityQuery。

限制与注意事项:小组件是 SwiftUI 归档快照,由系统按时间线渲染;时间线每日刷新预算约 40–70 次,部分刷新不计入预算;内存约 30MB(Live Activities 约 50MB),超限会被终止;视图中不应发起网络请求,需在 getTimeline 中取数并控制在 5 秒内;AsyncImage 不可用;本技能不适用于纯 App Intents、SwiftUI 布局、性能优化与崩溃调试等主题。