SuperAPI AI 工具集

push-notifications

通用与其它

查看项目

更新于 10-16 05:52

技能介绍

用途:实现、审查和调试基于 UserNotifications 与 APNs 的本地及远程通知。内容强调按目标项目的部署版本范围处理,示例假定现代 Swift 并发,并在使用较新 API 时标注可用性。

边界划分:Live Activity 的 content-state 推送归 activitykit;PushKit/VoIP 通话归 callkit;App Clip 临时设置归 app-clips;长时或定时后台任务归 background-processing。

主要能力与按任务查阅:通知授权、APNs 注册、令牌生命周期、provider headers、可见/后台 payload 及投递诊断,查阅 APNs 生命周期与远程投递;设备端时间、日历或位置提醒,查阅本地通知;应用委托接线、前台/点击处理、深链路由与类别,查阅通知运行时与路由;.apns、simctl、APNs Sandbox Simulator、provider/设备矩阵与投递诊断,查阅投递测试;服务扩展改写与恰好一次完成,查阅服务扩展;自定义展开 UI 查阅内容扩展,Messages 风格展示查阅通信通知。窄任务不应通读全部参考。

核心流程:先分类通知为本地、可见远程、后台远程、Live Activity、VoIP 或被扩展改写;再检查 entitlements、capabilities、bundle/topic、delegate 安装、categories、provider 归属与目标平台;区分可见授权与 APNs 注册、服务器令牌绑定;定义 payload 键、APNs headers、过期/折叠行为与敏感数据策略;实现前台展示、响应/操作路由与有界后台或扩展工作;最后分别验证调度/provider 接受、设备接收、扩展执行、展示与响应路由。

关键规则:通知授权控制可见提醒、声音与角标,应在上下文中请求并检查 notificationSettings()。APNs 注册是独立路径,需要设备令牌时应调用 registerForRemoteNotifications(),不要以 .authorized 作为门槛;令牌通过应用委托回调获取,视为不透明数据,每次成功回调都上传,不要假定固定长度或把本地缓存令牌当作 provider 事实。

限制:后台推送只是获取当前状态的提示,不是定时器,优先级低、会被节流、合并且不保证送达;服务扩展需 alert 内容加 mutable-content: 1,纯静默、纯声音或纯角标推送不会启动它;不要用 silent push 触发服务扩展;扩展密钥应使用 Keychain Sharing,附件需先下载到磁盘再构造 UNNotificationAttachment;扩展必须在成功、失败和 serviceExtensionTimeWillExpire() 中恰好调用一次内容处理回调。模拟器限制与真机验证需区分。 测试真机仍受官方文档约束;其余收费标准、价格等信息暂未提供。