用途:ActivityKit 负责锁屏与灵动岛上的实时、可一瞥式实时活动(Live Activity)。普通时间线小组件归 widgetkit,通用 APNs 配置归 push-notifications,而实时活动生命周期、令牌处理与载荷契约留在本技能内。
主要能力:涵盖 ActivityAttributes 与 ContentState 设计、本地请求/更新/结束、推送更新(push-to-update)、推送启动(push-to-start)、渠道载荷、APNs 头、 dismissal 策略、终止清理、锁屏布局与灵动岛各区域、多活动、授权、令牌轮换、后台行为、模拟器/设备验证、预览与 Info.plist 键。
使用方式:为新实时活动启用宿主 App 能力并设置 NSSupportsLiveActivities = YES;将不可变 ActivityAttributes 与小型 Codable、Hashable 的 ContentState 分离,集成 APNs 前先编码代表性服务器 fixture;先构建锁屏 ActivityConfiguration,再构建 compact、minimal、expanded 灵动岛展示;检查 ActivityAuthorizationInfo.areActivitiesEnabled,用 ActivityContent 请求,并演练本地更新与每条终止结束路径;远程投递时观察每个发出的令牌,并按同一 Codable 契约校验 update、end 与 push-to-start 载荷。
限制与版本:现代 ActivityContent 生命周期 API 需 iOS 16.2+(除非另有说明);push-to-start 需 iOS 17.2+,style 请求参数需 iOS 18+(.standard 用于持续工作,.transient 仅用于短时展开展示),渠道/广播更新需 iOS 18+(仅更新/结束,不能启动),补充活动族需 iOS 18+,定时启动需 iOS 26+,配对的 Mac 与 CarPlay 展示需 iOS 26+。实时活动推送要求 apns-push-type: liveactivity,设备令牌推送 topic 为 <bundle-id>.push-type.liveactivity;仅 aps.alert 请求可见提醒行为。不建议在小组件扩展视图中进行网络或定位取数;锁屏内容视为公开,切勿放入机密或敏感细节。