SuperAPI AI 工具集

axiom-extensions-widgets-ref

编程与开发

查看项目

更新于 10-16 00:22

技能介绍

用途:为 Apple 小组件与扩展生态提供 API 参考,适用于实现主屏幕、锁屏、StandBy 小组件、实时活动、控制中心控件以及 App 扩展的数据共享、生命周期与权限。

主要能力:覆盖标准小组件(iOS 14+)、交互式小组件(iOS 17+,Button/Toggle 配合 App Intents)、Live Activities(iOS 16.1+,锁屏与灵动岛)、控制中心控件(iOS 18+)以及 App Extensions。介绍 Timeline、TimelineProvider、TimelineEntry、刷新预算(约每日 40-70 次)、Widget Family、App Groups 共享容器、ActivityAttributes 与 ContentState 等核心概念。

必要用法:静态小组件用 StaticConfiguration;需要配置时用 AppIntentConfiguration(简单选项或配合 EntityQuery 动态数据);实时活动用 ActivityConfiguration。时间线在 getTimeline 中生成并由系统按时间渲染,可调用 WidgetCenter.shared.reloadAllTimelines() 或 reloadTimelines(ofKind:) 手动刷新。交互式小组件用 Button(intent:) 与 Toggle 调用 App Intent,并可用 .invalidatableContent() 提供执行反馈。实时活动通过 Activity.request 启动,用 activity.update 更新、activity.end 结束,支持 pushType: .token 推送更新。

适用场景:实现任意类型小组件、创建实时活动、构建控制中心控件、应用与扩展间共享数据、理解时间线与刷新策略、将小组件接入 App Intents、支持 watchOS 或 visionOS 小组件。

限制:不适用于纯 App Intents 问题、SwiftUI 布局问题、性能优化或崩溃调试,这些应参考对应技能。小组件内存上限约 30MB、实时活动约 50MB;ActivityAttributes 总数据须小于 4KB;getTimeline 应在 5 秒内完成;小组件视图中不应发起网络请求,AsyncImage 不可用;刷新预算约每日 40-70 次,超出受限。安装方式与收费信息暂未提供。