SuperAPI AI 工具集

axiom-extensions-widgets

数据与分析

查看项目

更新于 10-15 20:11

技能介绍

用途:在实现 iOS 小组件(主屏、锁屏、StandBy、控制中心)、Live Activity 或控件时,作为一套强制规范,帮助避免扩展沙箱、时间线与数据共享方面的常见错误。

主要能力与覆盖问题:提供时间线策略、刷新预算、手动刷新与 App Groups 配置;应用与小组件之间的数据共享(App Groups 权限、共享 UserDefaults、容器 URL);小组件显示陈旧数据、不出现在图库、交互按钮无响应、Live Activity 启动失败、控制中心控件无响应等问题的排查方向。

关键要点:小组件是时间线上的存档快照,不是持续运行的小应用;扩展内存约 30MB,视图中不应做网络请求(可在 TimelineProvider 中请求,但有 30 秒超时等限制),应优先在主应用预取并写入共享存储;主应用与扩展需在双端启用同一 App Groups 并使用 UserDefaults(suiteName:),可用 containerURL(forSecurityApplicationGroupIdentifier:) 验证。刷新预算约每天 40-70 次,建议条目间隔 15-60 分钟(时效性数据 5-15 分钟),用 .atEnd 策略并由系统决定;控件应使用异步 ValueProvider 并提供即时 previewValue;Live Activity 结束需显式调用 end 并设置 dismissalPolicy(.immediate、.default、.after(date));ActivityAttributes 与 ContentState 合计硬上限 4096 字节,建议控制在 2KB 以内,图片用资源目录而非内嵌 Data。

限制:不适用于纯 App Intents、SwiftUI 布局、性能分析与通用调试(应使用对应技能)。

资料未提供具体安装命令、版本要求、收费方式与官方支持平台信息。