用途:ActivityKit 负责锁屏与灵动岛上的实时、可一瞥查看的 Live Activity,管理其生命周期与载荷契约。普通时间线小组件属于 widgetkit,通用 APNs 配置属于 push-notifications。
主要能力:定义 ActivityAttributes 的静态数据与动态 ContentState;通过 Activity.request 创建活动,用 ActivityContent 更新与结束;支持 staleDate 过期标记、relevanceScore、AlertConfiguration 提醒;锁屏与灵动岛(compactLeading、compactTrailing、minimal、expanded 区域)布局;push-to-update 与 push-to-start 远程更新;iOS 18+ 频道推送、ActivityStyle;iOS 26+ 定时活动与 Mac/CarPlay 展示。
使用方式:宿主 App 需在 Info.plist 设置 NSSupportsLiveActivities = YES;用 .token 作为 pushType 并监听 activity.pushTokenUpdates 上报服务器;push-to-start 令牌来自 Activity<Attributes>.pushToStartTokenUpdates;频繁推送需 NSSupportsLiveActivitiesFrequentUpdates = YES。
限制:ActivityContent 生命周期示例需 iOS 16.2+,push-to-start 需 iOS 17.2+,定时活动与 Mac/CarPlay 需 iOS 26+。活动活跃期最长 8 小时,系统结束后的锁屏停留最多 4 小时(共 12 小时),.default 结束停留最多 4 小时。灵动岛仅部分设备具备,锁屏应作为主展示面。不要在 ActivityAttributes 中存放敏感信息,不要在视图中直接请求网络或定位,需在所有终止路径结束活动。具体代码模式见 references/activitykit-patterns.md。